ADFA-4128 (10/11): gradle-plugin — generating the proxy app

[fryanpan]

Part 10/11 of the stacked split of #1669 (requested by Akash). Base: feature/ADFA-4128-qb-09-daemon. Stack overview + review mechanics: PR 1 (#1713). Terms are defined in quickbuild/README.md (lands in PR 1).

Produces the stand-in app that Quick Build reloads into, so it behaves like the user's real app. Ordinary Gradle builds are untouched by it.

flowchart TB
    init["CoGo's init script applies<br/>AndroidIDEGradlePlugin (existing path)"] --> gate
    subgraph gp["<b>This PR: inside :gradle-plugin</b>"]
        gate{"quick-build Gradle property<br/>(GradlePluginConfig) == true?<br/><i>AndroidIDEGradlePlugin.kt</i>"}
        gate -- "yes: QB provisioning only" --> qbp["QuickBuildPlugin<br/><i>QuickBuildPlugin.kt</i>"]
        qbp --> px["ProxySourceGenerator<br/>Proxy&lt;N&gt;&lt;Type&gt; subclasses;<br/>proxiability decisions with named rejections<br/><i>ProxySourceGenerator.kt</i>"]
        qbp --> mf["manifest rewrite + activity-alias synthesis<br/>explicit-class navigation keeps resolving<br/><i>QuickBuildManifestTransformer.kt</i>"]
        qbp --> js["quickbuild.json —<br/>the contract the device side reads back<br/><i>QuickBuildJson.kt</i>"]
    end
    gate -- "no: every ordinary build" --> off["QuickBuildPlugin never applied —<br/>this PR's code does not run"]
    js --> core["consumed by :quickbuild:core / :app (PRs 7, 11)"]
    classDef thisPrBox fill:#dbeafe,stroke:#93c5fd,color:#1e3a5f
    classDef inPr fill:#ffffff,stroke:#64748b,color:#000
    class gp thisPrBox
    class gate,qbp,px,mf,js inPr

Loading

What to review

• AndroidIDEGradlePlugin.kt — the property gate; review first, it contains everything else.
• ProxySourceGenerator.kt — which components can be proxied, and each rejection's reason. Line-by-line.
• QuickBuildManifestTransformer.kt — activity-alias synthesis keeps explicit-class navigation resolving.
• QuickBuildJson.kt — SCHEMA_VERSION must move in step with the reader's COMPONENT_SCHEMA_VERSION.
• No :quickbuild:* dependency; this PR's stack position is reading order only.
• QuickBuildPlugin.kt — applied only during provisioning; a revert changes nothing otherwise.

How this PR Was Tested

• 13 test files (12 suites), including functional Gradle builds asserting real build output.
• TestKit covers AGP 8.11.0 on Gradle 8.14.3; real Gradle 9 remains unproven.
• [verified 2026-08-21] At this cut: :gradle-plugin:test green with PRs 1–10 applied — 13 test files (12 suites; utils.kt is a helper), 136 tests, 0 failures, 0 errors. The 6 skips are all pre-existing @disabled logsender / init-script cases on an AGP 7.3.0 fixture; no Quick Build test skipped, and both the functional QuickBuildProxyAppBuildTest and the Gradle-version-parameterized init-script test ran in full. Coverage reads 43.1% line / 48.9% branch, but that number is a measurement artifact: the functional tests run the plugin in a separate Gradle process via TestKit, which the JaCoCo agent cannot instrument, so the most-exercised classes read 0%.
• End-to-end evidence: PR 11.

Coverage (JaCoCo at the stack tip, single run):

Package	Line	Branch	Note
com.itsaky.androidide.gradle	2.7%	6.4%	plugin entry points; run inside a real Gradle build
com.itsaky.androidide.gradle.quickbuild	59.6%	61.1%	task classes, same
NON-UI TOTAL	43.1%	48.9%	1,012 lines, 423 branches

Both rows are depressed by the TestKit artifact, not by absent tests: this code executes inside a separate real Gradle process that the JaCoCo agent cannot instrument, so the most-exercised classes read 0%. It is covered by the plugin's own functional tests and the device passes rather than by JVM-unit measurement here. The four classes carrying the artifact are QuickBuildTasks (0% over 290 lines), QuickBuildPlugin (0% over 186), COTGSettingsPlugin, and AndroidIDEGradlePlugin. Excluding those four, the remaining nine files read 100% line, with branch coverage from 70.0% to 100.0%.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Kj9YeCDHGp9DU8LPtfWJ7W

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review for a one-time review, or @claude review always to subscribe this PR to a review on every future push.

_{Tip: disable this comment in your organization's Code Review settings.}