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
S
Description
No description provided
24 MiB
Languages
Swift 94.5%
Objective-C++ 2.9%
JavaScript 1.8%
C 0.6%
Objective-C 0.2%