112 lines
4.4 KiB
Markdown
112 lines
4.4 KiB
Markdown
# WeChat Native UI Phase 2 Design
|
||
|
||
**日期：** 2026-03-27
|
||
**范围：** 原生 Android 微信式回退后的第二批细化
|
||
**前提：** 延续 `2026-03-27-wechat-native-ui-rollback-design.md` 已批准方向，不改一级导航、不改原生路线、不把控制台式信息重新放回主 UI
|
||
|
||
---
|
||
|
||
## 1. 目标
|
||
|
||
这一批只做三个方向的补齐：
|
||
|
||
1. 聊天页手感更接近常用 IM，而不是“能发消息但交互生硬”
|
||
2. OTA 下载与安装链路给出更明确的原生反馈，而不是只靠系统通知
|
||
3. 根页导航和返回逻辑再收一轮，减少“像功能页、不像 APP”的割裂感
|
||
|
||
这批不新增新的一级功能，也不改 Boss 的后端技术路线。
|
||
|
||
## 2. 保持不变的约束
|
||
|
||
- 一级导航仍然固定为 `会话 / 设备 / 我的`
|
||
- 会话首页仍是微信式简单聊天列表
|
||
- 项目聊天页仍然只保留 `项目目标 / 版本记录` 两个轻入口
|
||
- `运维 / 审计 / 修复 / 线程详情 / 转发` 仍保留深层入口，但不回到主聊天页和一级 `我的`
|
||
- 原生 Android 仍使用 `BossApiClient + Activity + XML`
|
||
- 登录恢复、OTA API、Boss Web 部署链路都保持现有实现
|
||
|
||
## 3. 设计一：聊天页体验细化
|
||
|
||
### 3.1 现状问题
|
||
|
||
- 点击发送后只有整体刷新，用户会感觉“发出去了，但界面没跟手”
|
||
- 发送中没有明确状态，输入框和发送按钮的反馈太弱
|
||
- 每次刷新后直接滚到底，用户如果在看旧消息，会被强制拉走
|
||
|
||
### 3.2 目标效果
|
||
|
||
- 发送后立即出现一条本地“发送中”气泡，先给到即时反馈
|
||
- 服务端成功后，再用真实消息列表替换掉临时气泡
|
||
- 如果用户本来就在底部，刷新后继续滚到底
|
||
- 如果用户已经往上翻历史，自动刷新不能把用户强行拉回底部
|
||
- 发送按钮在空输入、发送中这两种状态下要有明确禁用表现
|
||
|
||
### 3.3 设计取舍
|
||
|
||
- 不做真正的本地离线消息队列
|
||
- 不做复杂的消息已读/送达双勾状态
|
||
- 只做“发送中 -> 成功刷新”这一层最小原生体验闭环
|
||
|
||
## 4. 设计二：OTA 原生反馈细化
|
||
|
||
### 4.1 现状问题
|
||
|
||
- 现在已经能下载并拉起安装，但主页面上看不到清晰下载进度
|
||
- 下载失败或权限阻塞时，提示不够聚焦
|
||
- 用户回到关于页时，不容易知道“刚才那个下载现在走到哪一步了”
|
||
|
||
### 4.2 目标效果
|
||
|
||
- 关于页能显示当前 OTA 下载状态：未开始、下载中、已完成、失败、等待安装授权
|
||
- 下载中能看到百分比或至少看到“已下载 / 总大小”的进度文案
|
||
- 下载失败时可直接重试，不需要用户自己猜该做什么
|
||
- 如果安装未知来源权限没开，界面要明确告诉用户下一步去哪开
|
||
|
||
### 4.3 设计取舍
|
||
|
||
- 继续使用系统 `DownloadManager`
|
||
- 不实现后台自定义下载器
|
||
- 不实现增量更新，只优化整包 APK 下载体验
|
||
|
||
## 5. 设计三：导航细节细化
|
||
|
||
### 5.1 现状问题
|
||
|
||
- 根页 tab 虽然已经变成微信式，但重新进 APP 时对用户上次停留页的记忆还不稳定
|
||
- 根页返回虽然不会直接乱跳，但体验还可以更像成熟 APP
|
||
|
||
### 5.2 目标效果
|
||
|
||
- 记住用户上次停留的根 tab，下次进 APP 优先回到该 tab
|
||
- 如果外部显式指定入口 tab，仍然以显式入口优先
|
||
- 在根页按返回时，不再像“页面崩掉式退出”；给出更柔和的退后台反馈
|
||
|
||
### 5.3 设计取舍
|
||
|
||
- 不做复杂导航栈框架迁移
|
||
- 继续基于现有 `MainActivity` 自己维护 root tab 状态
|
||
|
||
## 6. 代码边界
|
||
|
||
这批预计新增少量纯 Java helper，目的是让关键交互可以用单元测试覆盖，而不是把逻辑都埋进 Activity：
|
||
|
||
- `ProjectChatUiState.java`
|
||
- 负责“是否自动滚到底”“发送按钮是否可用”“临时发送中消息”的最小映射
|
||
- `OtaDownloadStateMapper.java`
|
||
- 负责把 `DownloadManager` 查询结果映射成页面文案和状态
|
||
|
||
活动页主要做接线，不堆业务判断：
|
||
|
||
- `ProjectDetailActivity.java`
|
||
- `AboutActivity.java`
|
||
- `MainActivity.java`
|
||
|
||
## 7. 验收标准
|
||
|
||
1. 聊天页发送消息后，立刻能看到发送中反馈
|
||
2. 聊天页刷新不会在用户查看历史消息时强制跳到底
|
||
3. 关于页能看到 OTA 下载状态和失败重试入口
|
||
4. 未知来源安装权限未开时，页面能给出明确引导
|
||
5. APP 再次打开时，根 tab 能恢复到上次停留位置
|
||
6. 微信式一级 UI 不被破坏，主聊天页仍然只保留 `项目目标 / 版本记录`
|