AI 插件升级提示框项目风格适配变更记录

变更日期

2026-07-21

变更目标

将“AI 插件需要升级”的业务阻断提示从系统 AlertDialog 改为项目现有提示弹框风格，保持原有升级、返回主页和状态复查逻辑不变。

实现内容

• AiReadinessGuard 在状态为 UPGRADE_REQUIRED 时复用项目已有的 NewSingleTipPop。
• 弹框继续使用项目现有的 single_tip_pop_layout，继承统一宽度、白色圆角卡片、标题分隔线、取消按钮和蓝色确认按钮样式。
• 按钮文案保持为“返回主页”和“立即升级”。
• 点击“立即升级”后打开统一插件下载弹框，同时保留业务阻断提示；若用户取消系统安装，仍可继续处理升级。
• 点击“返回主页”或按系统返回键，均按原规则返回主页。
• 插件安装成功后仍由统一门禁关闭阻断提示并重新检查插件版本、SDK 初始化和设备激活状态。

共享弹框兼容调整

NewSingleTipPop 新增可选的按钮文案、确认后是否自动关闭以及返回键监听能力。所有能力均保持原默认值，现有调用方行为不变。

验证

• Debug Java 编译通过。
• 13 个 Debug 单元测试全部通过，0 失败。
• Debug APK 构建通过。
• git diff --check 纳入最终检查。
• 未向目标设备安装 APK，弹框视觉效果和触控交互仍需设备侧确认。

版本控制说明

本次未执行暂存、提交、推送或分支切换，用户原有无关修改保持不变。