[Templates] Add comments to help developers publish MacCatalyst apps on App Store

[dustin-wojciechowski]

I wanted to make a first pass at this and make sure if I'm going in the right direction or not, and whether comments are formatted correctly. I was also unsure how to exactly test this.

I based some of these modifications based on comments from the community on how they were able to publish Maui MacCatalyst apps on the App Store.

1. The product archive package's signature is invalid. Ensure that it is signed with your "3rd Party Mac Developer Installer" certificate. Solved this by modifying csproj file to add <PackageSigningKey> and some other properties based on this guide. I wasn't sure if all the fields are necessary though.
2. The product archive is invalid. The Info.plist must contain a LSApplicationCategoryType key, whose value is the UTI for a valid category. For more details, see "Submitting your Mac apps to the App Store". I chose a default of public.app-category.productivity and added it to info.plist.
3. Invalid bundle. The bundle supports arm64 but not Intel-based Mac computers. Your build must include the x86_64 architecture to support Intel-based Mac computers. I set the default to both in the csproj, and added a comment clarifying.
4. Invalid Bundle. The key UIDeviceFamily in the app's Info.plist file contains one or more unsupported values '1'. There was already a PR that removed the 1 value here apparently. How would we add validation to ensure that the correct value is used?
5. App sandbox not enabled. The following executables must include the "com.apple.security.app-sandbox" entitlement with a Boolean value of true in the entitlements property list [...] I've added two suggested entries to the Entitlements.plist, but commented them out.
6. ITSAppUsesNonExemptEncryption - added this field to info.plist and set it to false.

Fixes #17591

[tj-devel709]

This is awesome and looks really helpful :)

[vs-mobiletools-engineering-service2]

💻 [CI Build] Windows Integration Tests passed 💻

✅ All Windows Integration Tests passed.

Pipeline on Agent
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]

[vs-mobiletools-engineering-service2]

💻 [PR Build] Tests on macOS M1 - Mac Big Sur (11.5) passed 💻

✅ All tests on macOS M1 - Mac Big Sur (11.5) passed.

Pipeline on Agent
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]

[vs-mobiletools-engineering-service2]

📚 [PR Build] Artifacts 📚

Packages generated

View packages

• Microsoft.iOS.Bundle.16.2.7338-ci.pr.gh17830.pkg
• Microsoft.iOS.Ref.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Runtime.ios-arm.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Runtime.ios-arm64.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Runtime.iossimulator-arm64.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Runtime.iossimulator-x64.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Runtime.iossimulator-x86.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Sdk.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Templates.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.iOS.Windows.Sdk.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.MacCatalyst.Bundle.16.2.7338-ci.pr.gh17830.pkg
• Microsoft.MacCatalyst.Ref.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.MacCatalyst.Runtime.maccatalyst-arm64.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.MacCatalyst.Runtime.maccatalyst-x64.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.MacCatalyst.Sdk.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.MacCatalyst.Templates.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.macOS.Bundle.13.1.7338-ci.pr.gh17830.pkg
• Microsoft.macOS.Ref.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.macOS.Runtime.osx-arm64.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.macOS.Runtime.osx-x64.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.macOS.Sdk.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.macOS.Templates.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.NET.Sdk.iOS.Manifest-7.0.100.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.NET.Sdk.MacCatalyst.Manifest-7.0.100.16.2.7338-ci.pr.gh17830.nupkg
• Microsoft.NET.Sdk.macOS.Manifest-7.0.100.13.1.7338-ci.pr.gh17830.nupkg
• Microsoft.NET.Sdk.tvOS.Manifest-7.0.100.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.NET.Workload.iOS.16.2.7338-ci.pr.gh17830.msi
• Microsoft.tvOS.Bundle.16.1.8126-ci.pr.gh17830.pkg
• Microsoft.tvOS.Ref.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.tvOS.Runtime.tvos-arm64.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.tvOS.Runtime.tvossimulator-arm64.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.tvOS.Runtime.tvossimulator-x64.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.tvOS.Sdk.16.1.8126-ci.pr.gh17830.nupkg
• Microsoft.tvOS.Templates.16.1.8126-ci.pr.gh17830.nupkg
• xamarin.ios-16.2.1.338.pkg
• xamarin.mac-9.1.1.338.pkg

Pipeline on Agent XAMBOT-1188.Ventura
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]

[vs-mobiletools-engineering-service2]

✅ API diff for current PR / commit

Legacy Xamarin (No breaking changes)

• iOS (no change detected)
• tvOS (no change detected)
• watchOS (no change detected)
• macOS (no change detected)

NET (empty diffs)

• iOS: (empty diff detected)
• tvOS: (empty diff detected)
• MacCatalyst: (empty diff detected)
• macOS: (empty diff detected)

✅ API diff vs stable

Legacy Xamarin (No breaking changes)

• iOS: vsdrops gist (No breaking changes)
• tvOS: vsdrops gist (No breaking changes)
• watchOS: vsdrops gist (No breaking changes)
• macOS: vsdrops gist (No breaking changes)

.NET (No breaking changes)

• iOS: vsdrops gist (No breaking changes)
• tvOS: vsdrops gist (No breaking changes)
• MacCatalyst: vsdrops gist (No breaking changes)
• macOS: vsdrops gist (No breaking changes)
• Microsoft.iOS vs Microsoft.MacCatalyst: vsdrops gist

Legacy Xamarin (stable) vs .NET

• iOS: vsdrops gist
• tvOS: vsdrops gist
• macOS: vsdrops gist

✅ Generator diff

Generator diff is empty

Pipeline on Agent
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]

[vs-mobiletools-engineering-service2]

💻 [PR Build] Tests on macOS M1 - Mac Ventura (13.0) passed 💻

✅ All tests on macOS M1 - Mac Ventura (13.0) passed.

Pipeline on Agent
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]

[vs-mobiletools-engineering-service2]

🚀 [CI Build] Test results 🚀

Test results

✅ All tests passed on VSTS: simulator tests.

🎉 All 225 tests passed 🎉

Tests counts

✅ bcl: All 69 tests passed. Html Report (VSDrops) Download
✅ cecil: All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests: All 1 tests passed. Html Report (VSDrops) Download
✅ fsharp: All 7 tests passed. Html Report (VSDrops) Download
✅ framework: All 8 tests passed. Html Report (VSDrops) Download
✅ generator: All 2 tests passed. Html Report (VSDrops) Download
✅ interdependent_binding_projects: All 7 tests passed. Html Report (VSDrops) Download
✅ install_source: All 1 tests passed. Html Report (VSDrops) Download
✅ introspection: All 8 tests passed. Html Report (VSDrops) Download
✅ linker: All 65 tests passed. Html Report (VSDrops) Download
✅ mac_binding_project: All 1 tests passed. Html Report (VSDrops) Download
✅ mmp: All 2 tests passed. Html Report (VSDrops) Download
✅ mononative: All 12 tests passed. Html Report (VSDrops) Download
✅ monotouch: All 25 tests passed. Html Report (VSDrops) Download
✅ msbuild: All 2 tests passed. Html Report (VSDrops) Download
✅ mtouch: All 1 tests passed. Html Report (VSDrops) Download
✅ xammac: All 3 tests passed. Html Report (VSDrops) Download
✅ xcframework: All 8 tests passed. Html Report (VSDrops) Download
✅ xtro: All 2 tests passed. Html Report (VSDrops) Download

Pipeline on Agent
Hash: 8480c95baac5b45b6169b070d14524e40dd88664 [PR build]