移动/游戏
需要排查 TestFlight 崩溃、Beta…
当用户询问 TestFlight 崩溃报告、Beta 测试者反馈、App 卡顿/磁盘写入/启动诊断,或需要某个构建/App 的崩溃汇总时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要排查 TestFlight 崩溃、B特定
解决思路
- 解决 App ID(若未提供):用 `asc apps list` 获取。
- 用对应的命令抓取数据,解析 JSON 输出,并以人类可读的摘要形式呈现。
- 列出最近的崩溃(最新在前):`asc testflight crashes list --app "APP_ID" --sort -createdDate --limit 10`。
- 按构建过滤崩溃:`asc testflight crashes list --app "APP_ID" --build-id "BUILD_ID" --sort -createdDate --limit 10`。
- 按设备/系统过滤崩溃:`asc testflight crashes list --app "APP_ID" --device-model "iPhone16,2" --os-version "18.0"`。
- 获取全部崩溃:`asc testflight crashes list --app "APP_ID" --paginate`。
- 以表格查看崩溃:`asc testflight crashes list --app "APP_ID" --sort -createdDate --limit 10 --output table`。
- 列出最近的 Beta 反馈(最新在前):`asc testflight feedback list --app "APP_ID" --sort -createdDate --limit 10`。
- 带截图列出反馈:`asc testflight feedback list --app "APP_ID" --sort -createdDate --limit 10 --include-screenshots`。
- 按构建过滤反馈:`asc testflight feedback list --app "APP_ID" --build-id "BUILD_ID" --sort -createdDate`。
- 获取全部反馈:`asc testflight feedback list --app "APP_ID" --paginate`。
- 性能诊断(卡顿、磁盘写入、启动)需要 build ID,可用 `asc builds info --app "APP_ID" --latest --platform IOS` 或 `asc builds list --app "APP_ID" --sort -uploadedDate --limit 5` 解析得到。
- 列出诊断签名:`asc performance diagnostics list --build-id "BUILD_ID"`。
- 按类型过滤诊断:`asc performance diagnostics list --build-id "BUILD_ID" --diagnostic-type "HANGS"`;类型有 `HANGS`、`DISK_WRITES`、`LAUNCHES`。
- 查看某个签名的日志:`asc performance diagnostics view --id "SIGNATURE_ID"`。
- 下载全部指标:`asc performance download --build-id "BUILD_ID" --output ./metrics.json`。
- 从名称解析 App ID:`asc apps list --name "AppName"`,或用 `asc apps list --bundle-id "com.example.app"`。
- 获取最新 build ID:`asc builds info --app "APP_ID" --latest --platform IOS`。
- 获取近期构建:`asc builds list --app "APP_ID" --sort -uploadedDate --limit 5`。
- 设置默认 App ID:`export ASC_APP_ID="APP_ID"`。
- 呈现结果时按严重程度和出现频率组织:1)总数——结果集中有多少崩溃/反馈;2)Top 崩溃签名——按异常类型或崩溃原因分组,按数量排序;3)受影响的构建——哪些构建版本受影响;4)设备与系统分布——受影响最多的设备型号和 OS 版本;5)时间线——崩溃何时开始或出现尖峰。
- 对性能诊断,优先高亮权重最高的签名。
- 默认输出是 JSON;快速人工查看时用 `--output table` 或 `--output markdown`。
- 做完整分析时用 `--paginate` 抓取所有分页。
- 调试命令输出时,JSON 搭配 `--pretty` 使用。
- 注意 App Store Connect 的崩溃数据可能有 24-48 小时延迟。
适用边界 · 注意事项
- 没有配置 asc CLI 或没有 App Store Connect / Apple Developer 账号权限时无法使用。
- 只需要本地崩溃日志或非 TestFlight 渠道(如第三方崩溃平台)数据时不适用。