android-viewsystem-foundations

Android ViewSystem 基础

适用场景

• 在请求涉及以下内容时使用此技能：XML 布局 Android 问题、Android Fragment 生命周期、ConstraintLayout 清理。
• 主要目标：处理 XML 布局、ConstraintLayout、Fragment、ViewBinding、DataBinding 和经典 Android UI 生命周期模式。
• 当主要工作涉及 XML、Fragment、RecyclerView 或绑定生命周期，而非优先采用 Compose 的 UI 时，使用此技能。
• 如果范围扩大，可交接给以下技能：
• android-compose-xml-interoperability
• android-testing-ui

工作流

1. 判断目标界面属于 Fragment、Activity、自定义视图、RecyclerView，还是 Compose/View 混合互操作界面。
2. 正确划分所有权：将视图绑定关联到视图生命周期，将适配器关联到明确的条目模型，并在叶子视图之外处理导航和事务。
3. 首先使用经典 View 工具修复布局和渲染问题：ConstraintLayout、RecyclerView 差异计算、窗口 Insets，以及安全的绑定更新。
4. 在认为改动完成之前，测试 Fragment 重建、长文本、字体缩放、RTL 和进程生命周期边界情况。
5. 只有在 View 系统的所有权模型稳定后，才交接 Compose 互操作或深入 UI 测试的工作。

防护措施

• 在添加动画或抽象之前，优先确保状态稳定、渲染可预测。
• 默认遵循无障碍语义、对比度、焦点顺序和触控目标方面的指导。
• 除非明确划定互操作边界，否则不要混合 Compose 和 View 系统的所有权。
• 优先开展有测量依据的性能优化，避免过早进行微优化。
• Fragment 的视图销毁时清除 ViewBinding 引用；不要让视图引用的生命周期超过视图生命周期。

反模式

• 在叶子 UI 组件中直接嵌入导航或业务逻辑。
• 使用会因本地化或动态文本而出现问题的固定尺寸。
• 忽略语义，只播报视觉变化。
• 不调整思维模型，直接将 XML 模式移植到 Compose。
• 在视图重建期间，通过过期的绑定、视图引用或适配器持有 Fragment 的视图状态。

示例

正常流程

• 场景：使用 ViewBinding 和明确的 Fragment 安全模式，优化 XML OrbitTasks 界面。
• 命令：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest

边界情况

• 场景：在经典布局中处理配置更改、视图生命周期和长内容。
• 命令：cd examples/orbittasks-xml && ./gradlew :app:connectedDebugAndroidTest

故障恢复

• 场景：避免将 XML 或 Fragment 请求路由到优先采用 Compose 的技能。
• 命令：python3 scripts/eval_triggers.py --skill android-viewsystem-foundations

完成检查清单

• 实现路径明确、精简，并与正确的 Android 界面类型相对应。
• 已运行或更新相关示例命令和基准测试提示词。
• 请求涉及相邻技能时，已记录相应的交接。
• 官方参考资料涵盖所选模式以及主要的迁移或故障排查路径。

官方参考资料

• https://developer.android.com/guide/fragments
• https://developer.android.com/topic/libraries/view-binding
• https://developer.android.com/training/constraint-layout
• https://developer.android.com/topic/libraries/data-binding