joywayerandClaude Opus 4.7
4ca4459ad5
启动期错误态精确分类：NWPath 区分真断网/权限拒，按钮语义动态切换
用户反馈：之前的文案统一映射 NSURLError code，没区分"真没网"和"权限
被拒"——两类 iOS 14+ 上都报 -1009，但 NWPath.unsatisfiedReason 里有
wifiDenied / cellularDenied 标记可精确区分。点击重试时也没有针对权限
被拒场景做特殊处理（重发请求被同样的权限决定拒绝，原地循环）。
改动：
1. **NWPath snapshot 精确分类**
- 新增 BootErrorKind: noNetworkAccess / wifiDenied / cellularDenied /
networkTimeout / networkCannotReach / localResourceMissing / unknown
- 新增 currentPathSnapshot() async：临时 NWPathMonitor 等首次 update
拿当前 path
- classifyBootError 接 path 参数：先看 NWPath.unsatisfiedReason
（iOS 14.2+）区分权限拒/真断网；fallback 才按 NSURLError code
- runBootPipeline 的 catch 内 await snapshot，传入精确 kind
2. **按钮语义按 kind 切换**（同一个按钮承担双语义，UX 一致）
- 权限拒（wifiDenied / cellularDenied）→ 按钮显示"前往设置"，
点击跳 UIApplication.openSettingsURLString
- 其他（noNetworkAccess / timeout / unreachable / localResource）→
按钮显示"重试"，点击重跑 runBootPipeline
- SplashOverlay.showError 加 actionTitle 参数，通过 UIButton.Configuration
动态改 title
3. **didBecomeActive 自动重试**（行业最佳做法）
- 权限拒分支跳设置时挂 UIApplication.didBecomeActiveNotification 监听
- 用户在设置改完权限切回 app → 自动 runBootPipeline → 进入大厅
无需用户再点任何按钮
- 一次性 observer：触发后自动取消，避免重复
- runBootPipeline 入口同时 stop NWPathMonitor + stop settingsReturnObserver
保证多次重试干净
文案精确化：
- noNetworkAccess："当前未联网 / 请检查 Wi-Fi 或蜂窝数据后重试"
- wifiDenied："未授权使用无线局域网 / 请前往 iOS 设置 → 本应用 → 打开
「无线数据」，授权后将自动重试"
- cellularDenied："未授权使用蜂窝数据 / 请前往 iOS 设置 → 本应用 → 打开
「无线数据」，或连接 Wi-Fi 后重试"
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-23 07:19:50 +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 07:19:50 +08:00