Fix Bind=false binding dependencies

[jonathanpeppers]

Summary

• preserve Bind and Pack metadata while categorizing binding dependencies
• package Bind=false JAR dependencies in binding NuGet/generated AAR outputs
• expose Bind=false JAR and AAR types as reference-only generator inputs without generating bindings for them
• process bound and reference inputs through single ClassParse and ExtractJarsFromAar task invocations
• add focused packaging, generator-resolution, task argument, and stale-output regression coverage

Fixes #10481
Fixes #10668

Validation

• Xamarin.Android.Build.Tests.csproj build
• generator-Tests: 489 passed
• BindFalseAndroidLibraryResolvesGeneratorTypes: 4 passed
• AndroidLibraryPackMetadataIsPreservedInNuGet: 2 passed
• BuildAarBindingLibraryStandalone: 2 passed
• focused ClassParse and ExtractJarsFromAar task tests: 5 passed

[Copilot]

Pull request overview

This PR fixes binding-library dependency handling when Bind=false is used, ensuring those JAR/AAR dependencies are packaged appropriately while still participating in generator type resolution (without generating bindings for the dependency types themselves). The changes span MSBuild target plumbing, build tasks, the class-parse tool, and the Java.Interop generator pipeline, with added regression-focused test coverage.

Changes:

• Add “reference-only” Java API flow: class-parse emits a reference API XML, and generator consumes it (--java-reference) to keep dependency types resolvable without binding them.
• Extend AAR extraction to handle both bound and reference library categories (and clean stale reference outputs).
• Add tests covering reference argument wiring, packaging behavior, generator type resolution, and stale-output cleanup.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/Xamarin.Android.Build.Tasks/Tests/Xamarin.Android.Build.Tests/Tasks/ExtractJarsFromAarTests.cs	Adds a task test ensuring bound + reference AAR extraction and stale reference cleanup.
src/Xamarin.Android.Build.Tasks/Tests/Xamarin.Android.Build.Tests/Tasks/AndroidDotnetToolTests.cs	Adds a test validating ClassParse writes --reference* arguments to the response file.
src/Xamarin.Android.Build.Tasks/Tests/Xamarin.Android.Build.Tests/BindingBuildTest.cs	Adds/updates integration tests for NuGet packaging and generator resolution with Bind=false inputs.
src/Xamarin.Android.Build.Tasks/Tasks/Generator.cs	Plumbs JavaReferenceApiXml into generator invocation via --java-reference.
src/Xamarin.Android.Build.Tasks/Tasks/ExtractJarsFromAar.cs	Adds reference extraction output dirs + reference library handling and cleanup.
src/Xamarin.Android.Build.Tasks/Tasks/ClassParse.cs	Adds response-file arguments for reference jars + reference API output.
src/Xamarin.Android.Build.Tasks/MSBuild/Xamarin/Android/Xamarin.Android.Bindings.Core.targets	Adds reference-jar item ingestion from extracted reference libs and cleans new intermediates.
src/Xamarin.Android.Build.Tasks/MSBuild/Xamarin/Android/Xamarin.Android.Bindings.ClassParse.targets	Wires reference jars/output into ClassParse and passes reference API into BindingsGenerator.
src/Xamarin.Android.Build.Tasks/MSBuild/Xamarin/Android/Xamarin.Android.AvailableItems.targets	Introduces ReferenceJar and _AndroidReferenceLibraryProjectZip categorization from @(AndroidLibrary).
src/Xamarin.Android.Build.Tasks/Microsoft.Android.Sdk/targets/Microsoft.Android.Sdk.AndroidLibraries.targets	Updates _ExtractAar to extract both bound and reference categories with correct dependencies/inputs.
external/Java.Interop/tools/generator/Java.Interop.Tools.Generator.Transformation/JavaTypeResolutionFixups.cs	Allows fixup to consider reference-only Java API XML types during resolution.
external/Java.Interop/tools/generator/CodeGeneratorOptions.cs	Adds --java-reference option plumbing into generator options.
external/Java.Interop/tools/generator/CodeGenerator.cs	Loads reference-only Java API XML and adds reference types into the generator’s type table.
external/Java.Interop/tools/class-parse/Program.cs	Adds --reference + --reference-output support and deletes stale reference output when no refs are provided.

[jonathanpeppers]

/review

[github-actions]

✅ Android PR Reviewer completed successfully!

Generated by Android PR Reviewer for #12381

[github-actions]

⚠️ Needs Changes

Found 2 errors:

• The reference API item is lost when _ExportJarToXml is incrementally skipped, so a later generator-only rebuild can regress the behavior this PR adds.
• The new task failure uses an uncoded, non-localized diagnostic.

The overall separation of bound and reference-only inputs is well structured, and the focused JAR/AAR, CoreCLR/NativeAOT, packaging, stale-output, and task coverage is strong. CI is green across all 44 checks.

Generated by Android PR Reviewer for #12381 · gpt56 · 149 AIC · ⌖ 8.93 AIC · ⊞ 28.2K
_{Comment /review to run again}