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: