Skip to content

Document Android package output items#122

Draft
Redth wants to merge 10 commits into
dotnet:mainfrom
Redth:redth/android-package-output-docs
Draft

Document Android package output items#122
Redth wants to merge 10 commits into
dotnet:mainfrom
Redth:redth/android-package-output-docs

Conversation

@Redth

@Redth Redth commented Jun 16, 2026

Copy link
Copy Markdown
Member

Adds conceptual documentation for the new .NET 11 @(ApplicationArtifact) item surface introduced by dotnet/android#11674, so custom MSBuild targets and CI workflows can discover final APK/AAB paths and metadata without recalculating package names.

Changes

  • Adds a Discover Android package outputs article with examples for package signing, publish, GitHub Actions outputs, metadata enrichment, and command-line dotnet build -getTargetResult queries.
  • Documents @(ApplicationArtifact), the callable GetApplicationArtifacts target, the Publish target return contract, and $(GetApplicationArtifactsDependsOn).
  • Clarifies that GetApplicationArtifacts always depends on the required Build target before extension targets run, so overriding $(GetApplicationArtifactsDependsOn) cannot skip platform artifact population.
  • Clarifies that targets listed in $(GetApplicationArtifactsDependsOn) update existing items with additional metadata such as $(ApplicationVersion) before GetApplicationArtifacts or Publish returns them.
  • Links the new guidance from the Android build process, build item, build target, and TOC pages.

Notes

docfx was not installed locally; validated the markdown diff whitespace with git diff --check.


Internal previews

📄 File 🔗 Preview link
docs/android/building-apps/build-items.md docs/android/building-apps/build-items
docs/android/building-apps/build-process.md docs/android/building-apps/build-process
docs/android/building-apps/build-targets.md docs/android/building-apps/build-targets
docs/android/building-apps/package-outputs.md docs/android/building-apps/package-outputs

Redth and others added 10 commits June 16, 2026 16:26
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Clarify that GetApplicationArtifactsDependsOn enrichment applies before both GetApplicationArtifacts and Publish return ApplicationArtifact items.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add command-line target-result examples for GetApplicationArtifacts and Publish so callers can discover returned ApplicationArtifact items from the documented target surface.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
State that GetApplicationArtifactsDependsOn extension targets run after platform ApplicationArtifact items are populated so later imports can update existing items with additional metadata.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Clarify that GetApplicationArtifacts always runs Build before GetApplicationArtifactsDependsOn extension targets, so overriding the extension property cannot skip platform artifact population.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Prefer dotnet build for ApplicationArtifact target-result examples instead of dotnet msbuild.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Document that GetApplicationArtifacts runs the required build and artifact-production steps before extension targets can enrich the returned items.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Describe GetApplicationArtifacts as depending directly on Build before extension targets enrich ApplicationArtifact items.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

1 participant