Preview Gradle Plugin 模块
viewcompose-preview-gradle-plugin 把可调试 Android Gradle Plugin Variant 接到 Static Preview
Protocol。Plugin ID 为 com.viewcompose.preview；0.1.0-alpha03 面向 AGP 8.9 与用于渲染的
JDK 17 及以上版本。
fun applyPreviewPluginSample(project: Project) {
project.pluginManager.apply("com.viewcompose.preview")
project.tasks.named("viewComposePreviewDescriptors")
}
Variant、发现与任务契约
插件可在 Android Application/Library Plugin 前后应用，并只配置项目一次。可调试 Variant 获得 Discovery、Render 与 Refresh Task；不可调试 Variant 只执行 Bytecode Instrumentation，移除根 Preview Annotation 与组合 Annotation，同时保留无关 Annotation 与 Stack Frame。
Discovery 扫描已编译 Project Directory/JAR，不把 Application Class 加载进 Gradle Daemon。它把 Source Location 与 Runtime/Boot Classpath、Manifest、Resource、Asset、Resource Package 和 Project Bytecode 规范化。完整 Fingerprint 使 Render Output 失效；较窄的 Layoutlib Compatibility Fingerprint 排除可重载 Project Code，使 Warm Worker 可保留 Platform State，而每次渲染仍使用全新 Application ClassLoader。
viewComposePreviewDescriptors 聚合 Descriptor Export。Variant Task 包括
discoverDebugViewComposePreviews、renderDebugViewComposePreview 与
refreshDebugViewComposePreview。Single Render 选择一个 Preview/Variant；Gallery 使用 Target
File。两种模式互斥，Batch 受协议限制，Response Path 彼此隔离。--rerender=true 只绕过
Response Cache。
Fast Refresh 在仅源码变化时复用最后一个完整 Discovery/Resource Baseline。Signature、Resource、 Manifest 或 Dependency 变化需要 Full Discovery；缺失或不兼容 Baseline 会明确请求完整路径。 Content-addressed Layoutlib 与 Resource-symbol Input 不进入 Application Classpath；可选 Worker Reuse 验证会比较 Warm/Cold Pixel 与 Structure。
IDE 与运维边界
Gradle 插件不会安装 Android Studio UI。Gutter、Gallery、源码导航、刷新与诊断需要单独从
Marketplace 安装 ViewCompose Preview。IDE 与 Gradle 插件独立版本化。
- Preview Artifact 只放入 Debug/Tooling Configuration，并持续执行 Release Build 验证剥离。
- Task Input Annotation 与 Fingerprint 属于 Incremental Correctness 契约。
- Fast Refresh 只用于已知 Descriptor 的纯源码变化。
- Discovery、Classpath 或 Layoutlib Compatibility Input 变化时运行 Plugin Unit/Functional Test 与 Worker Reuse 验证。