DataBinding/ViewBinding

Jugg 支持 DataBinding / ViewBinding 相关 layout 修改的增量处理。它会把 layout 修改转成资源产物和生成源码，再继续进入资源编译与源码编译。本页只说明支持范围和使用边界，两阶段交接机制见 DataBinding / ViewBinding 增量编译原理。

已支持能力

修改类型	当前支持情况	用户可见结果
ViewBinding layout 修改	支持	binding 相关源码会被更新并继续编译
DataBinding layout 修改	支持	mapper、BR 等相关源码会被更新并继续编译
DataBinding layout 使用直接工程依赖中的 BindingAdapter	支持复用依赖模块 setter store	mapper 能解析自定义属性并生成 BindingImpl
<include> 影响	支持基于 layout info 补齐	被 include 关系影响的 layout 会一起进入生成源码更新
Gradle layout info 维护	支持	后续 Gradle 构建仍能拿到必要 layout 基线

TIP

如果是首次启用 DataBinding/ViewBinding、升级 AGP，或修改相关 Gradle 配置，先执行 Gradle 构建或 Sync，让中间产物路径和 layout info 成为新基线。

触发与结果

DataBinding / ViewBinding layout 变化
  -> 更新资源侧产物
  -> 更新绑定相关生成源码
  -> 继续资源编译和源码编译
  -> 部署阶段应用结果

用户需要关注的是：layout 修改不只生成资源 overlay；本轮涉及 R、binding class 或 mapper 变化时，还会追加 Java/Kotlin 编译。日志中看到多阶段编译是正常现象。

关键边界

• 普通 layout 不会因为开启 ViewBinding 就一定进入 DataBinding mapper。
• DataBinding mapper 依赖上次 Gradle 产出的 layout info 和 BR 基线；缺失时需要 Gradle 重建。
• 直接工程依赖中的 BindingAdapter 需要依赖模块已生成 setter store；首次加入该依赖或基线缺失时，需要先执行 Gradle 构建或 Sync。
• stripped XML 既是资源产物，也是源码阶段判断 mapper 的输入之一，不能只看 Java 输出判断是否成功。

相关页面

• 资源编译
• 注解器
• 源码编译
• DataBinding / ViewBinding 增量编译原理