joywayerandClaude Opus 4.7
74f6925be3
启动期错误处理 UX 改造：优雅降级 + 友好文案，不暴露技术细节
修复用户反馈的体验问题：网络权限未同意 / 长期不响应权限弹窗时，
启动会弹出"启动失败" + 原始 NSError（"Error Domain=NSURLErrorDomain
Code=-1009 ...大量技术细节..."），用户被吓懵。
按行业主流做法（参考微信/支付宝/网易云音乐启动期错误处理）改两件事：
1. **优雅降级：远端 config 失败 ≠ 启动失败**
runBootPipelineSteps 把"拉远端 config + 升级判定"整段包 do/catch：
- 业务流程信号（operationalMessage / ipaUpgradeRequired）正常抛出弹窗
- 网络 / 解析 / H5 zip 下载任何失败 → 用 LocalVersionReader 构造
fallback ResolvedVersion，跳过升级判定，直接加载本地 H5 大厅
- splash 文案区分在线 "加载大厅..." / 离线 "离线加载..."
- raw error 仍 print 到 Xcode console 便于排查
理论依据：ResourceUnzipper.ensureReady 之后本地 H5 zip 已就绪，
远端 config 仅用于升级判定，失败时本地大厅完全可用。
2. **友好文案 + 多按钮 alert（showRetryableAlert）**
- 新增 BootErrorKind 分类：剥洋葱看 NSURLError code 映射到
networkOffline (-1009) / networkTimeout (-1001) / networkCannotReach
(-1003/-1004/-1005/-1009/-1018/-1019/-1020) / localResourceMissing /
unknown
- 每类配友好标题 + 正文（"网络未连接"/"网络较慢"/"暂时无法连接服务器"
而非 raw "Error Domain=..."）
- 按钮组合按类别：网络类含"去设置"（跳 UIApplication.openSettingsURLString）
+ 重试 + 稍后再说；本地资源类只重试 + 稍后再说
- "重试" 不强制（"稍后再说" 让用户自由退出，避免单按钮卡死）
结果：用户在断网 / 未授权 Wi-Fi / 测试域名不可达等场景下，splash 多停
约 7s（3 次重试 + 退避）后自动降级进入大厅，**不弹任何 alert**。仅当
本地资源也失效（极罕见）时才弹友好提示，永不暴露原始 NSError。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-23 03:12:33 +08:00
..
2026-06-22 18:28:08 +08:00
2026-06-23 02:04:46 +08:00
2026-06-22 21:30:03 +08:00
2026-06-23 02:01:29 +08:00
2026-06-23 03:12:33 +08:00