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
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%