From c9b78be210c9695c736f8e17962a322a6846a916 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 17 Mar 2026 21:57:35 +0000 Subject: [PATCH 1/2] Initial plan From 7cb3ab5757d416214249ea74db87240e36ed177e Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 17 Mar 2026 21:59:12 +0000 Subject: [PATCH 2/2] Update documentation to reflect .aab fast deployment support 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> --- docs/android/building-apps/build-process.md | 6 +++++- docs/android/building-apps/build-properties.md | 9 +++++---- docs/android/messages/xa0119.md | 2 -- 3 files changed, 10 insertions(+), 7 deletions(-) diff --git a/docs/android/building-apps/build-process.md b/docs/android/building-apps/build-process.md index ef8afb5..ee9fc49 100644 --- a/docs/android/building-apps/build-process.md +++ b/docs/android/building-apps/build-process.md @@ -50,8 +50,12 @@ Only the updated assemblies are resynchronized to the target device. > [!WARNING] > Fast deployment is known to fail on devices which block `run-as`, which often includes devices older than Android 5.0. -Fast deployment is enabled by default, and may be disabled in Debug builds +Fast deployment is supported for both `.apk` and `.aab` package formats. +It is enabled by default, and may be disabled in Debug builds by setting the `$(EmbedAssembliesIntoApk)` property to `True`. +Note that using `.aab` with fast deployment will be slower than `.apk` +because the `.aab` file must be processed through `bundletool` for +packaging and installation. The [Enhanced Fast Deployment](build-properties.md#androidfastdeploymenttype) mode can be used in conjunction with this feature to speed up deployments even further. diff --git a/docs/android/building-apps/build-properties.md b/docs/android/building-apps/build-properties.md index bbe51e6..0868be3 100644 --- a/docs/android/building-apps/build-properties.md +++ b/docs/android/building-apps/build-properties.md @@ -553,9 +553,9 @@ of values to control what types can be deployed to the on the target device when the [`$(EmbedAssembliesIntoApk)`](#embedassembliesintoapk) MSBuild property is `False`. If a resource is fast deployed, it is *not* -embedded into the generated `.apk`, which can speed up deployment +embedded into the generated `.apk` or `.aab`, which can speed up deployment times. (The more that is fast deployed, then the less frequently -the `.apk` needs to be rebuilt, and the install process can be +the package needs to be rebuilt, and the install process can be faster.) Valid values include: - `Assemblies`: Deploy application assemblies. @@ -1043,7 +1043,8 @@ being generated. Setting `AndroidPackageFormats` to either `aab` or `apk` will generate only one file. The default value is `aab;apk` for `Release` builds only. -It is recommended that you continue to use just `apk` for debugging. +Using `apk` for debugging is faster, but `aab` is also supported +with fast deployment if needed (for example, when testing asset packs). ## AndroidPackageNamingPolicy @@ -1645,7 +1646,7 @@ Deployment doesn't support the target device. When this property is `False`, then the [`$(AndroidFastDeploymentType)`](#androidfastdeploymenttype) MSBuild property also controls what -will be embedded into the `.apk`, which can impact deployment and +will be embedded into the `.apk` or `.aab`, which can impact deployment and rebuild times. ## EnableDiagnostics diff --git a/docs/android/messages/xa0119.md b/docs/android/messages/xa0119.md index 66260cf..ad186cd 100644 --- a/docs/android/messages/xa0119.md +++ b/docs/android/messages/xa0119.md @@ -27,8 +27,6 @@ Remove the following options from `Debug` configurations: * `True` * `proguard` * `r8` -* App Bundles - * `aab` Remove the following from `Release` configurations: