Skip to content

Update docs to reflect .aab fast deployment support#103

Open
Copilot wants to merge 2 commits intomainfrom
copilot/update-outdated-docs
Open

Update docs to reflect .aab fast deployment support#103
Copilot wants to merge 2 commits intomainfrom
copilot/update-outdated-docs

Conversation

Copy link

Copilot AI commented Mar 17, 2026

Mirrors dotnet/android#10963. Fast deployment now supports .aab (Android App Bundles) in addition to .apk, but the docs here still say otherwise.

  • build-process.md: State that fast deployment works with both .apk and .aab, note .aab is slower due to bundletool overhead
  • build-properties.md: Update AndroidFastDeploymentType, AndroidPackageFormats, and EmbedAssembliesIntoApk descriptions to reflect .aab support; soften the blanket recommendation against aab for debugging
  • xa0119.md: Remove <AndroidPackageFormat>aab</AndroidPackageFormat> from the "non-ideal Debug config" warning list — using .aab in Debug is now a valid scenario (e.g. testing asset packs)

AndroidAssetPacks.md from the upstream PR has no equivalent in this repo.


Internal previews

📄 File 🔗 Preview link
docs/android/building-apps/build-process.md docs/android/building-apps/build-process
docs/android/building-apps/build-properties.md docs/android/building-apps/build-properties
docs/android/messages/xa0119.md docs/android/messages/xa0119

Copilot AI and others added 2 commits March 17, 2026 21:57
Mirrors dotnet/android#10963. Fast deployment now works with .aab files
(Android App Bundles), so documentation is updated accordingly.

Co-authored-by: jonathanpeppers <840039+jonathanpeppers@users.noreply.github.com>
@jonathanpeppers jonathanpeppers marked this pull request as ready for review March 17, 2026 22:07
Copilot AI review requested due to automatic review settings March 17, 2026 22:07
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates .NET for Android documentation to reflect that Fast Deployment supports Android App Bundles (.aab) in addition to APKs (.apk), aligning the guidance across build process docs and MSBuild property reference material.

Changes:

  • Document Fast Deployment support for .aab and note the extra bundletool overhead compared to .apk.
  • Update MSBuild property reference text (AndroidFastDeploymentType, AndroidPackageFormats, EmbedAssembliesIntoApk) to reflect .aab support and adjust debugging guidance.
  • Remove .aab from XA0119 “non-ideal Debug config” warnings now that Debug .aab can be valid (e.g., asset pack scenarios).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/android/messages/xa0119.md Removes .aab from the list of Debug configuration options considered non-ideal.
docs/android/building-apps/build-properties.md Updates property descriptions to include .aab fast deployment support and refines debugging guidance for AndroidPackageFormats.
docs/android/building-apps/build-process.md States Fast Deployment works with .apk and .aab, and documents performance implications for .aab due to bundletool.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants