From f433833815322d05c2b86ce41a6faa58c53879aa Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Wed, 1 Apr 2026 10:35:48 -0700 Subject: [PATCH 1/2] Replace depricated ms.topic: conceptual value with concept-article (#105) ms.topic values of `conceptual` or `article` are depricated and are to be changed to `concept-article`. There was a global setting in the docfx.json in this repo so I changed that from conceptual to concept-article There were no articles with ms.topic: conceptual or ms.toic: article in this repo. I am making this fix across several dotnet docs realted repos for the Learn org. --- docs/docfx.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docfx.json b/docs/docfx.json index daafcbd..cb6b17b 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -54,7 +54,7 @@ "feedback_help_link_url": "https://learn.microsoft.com/en-us/answers/tags/97/dotnet", "feedback_help_link_type": "get-help-at-qna", "ms.author": "dotnetcontent", - "ms.topic": "conceptual", + "ms.topic": "concept-article", "ms.service": "dotnet-mobile", "uhfHeaderId": "MSDocsHeader-DotNet" }, From 676c7a929547c79662626ab3422cbaa1a53c0554 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Wed, 1 Apr 2026 13:42:30 -0400 Subject: [PATCH 2/2] Update docs to reflect .aab fast deployment support (#103) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mirrors [dotnet/android#10963](https://github.com/dotnet/android/pull/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 `aab` 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. Co-authored-by: Jonathan Peppers --- 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: