「抓不到」不是一个结论:一次 iOS App 抓包排障复盘
一次移动端抓包复盘。真正卡住过程的从来不是加密,而是采集通道的边界、损坏的自采数据,以及把局部观察当成全集的习惯。
一次移动端抓包复盘。真正卡住过程的从来不是加密,而是采集通道的边界、损坏的自采数据,以及把局部观察当成全集的习惯。
这个 job 解决什么问题 analyze_app_size_mr 是合并前的包体积预检:复用 build_app 已构建的 App,回答「当前包有多大、代码与资源各占多少、哪些模块或资源最重、这笔 MR 相比目标分支是否增长」。分析结果自动出现在 MR 评论里,并附完整 HTML / JSON 报告,方便评审时定位增长来源。 几个关键约定: 不重新编译 App:依赖 build_app 的 Beta、iphoneos、无签名产物,分析阶段只做扫描、汇总和报告; APPAnalyze 看最终 .app,二进制、资源和静态扫描问题;Link Map 补足主程序内部静态库的来源归因; 分支 push 的 analyze_app_size 负责写入基线;MR 的 analyze_app_size_mr 只读取目标分支基线; allow_failure: true:分析失败允许流水线继续;扫描提示用于评审参考,当前没有按体积阈值阻止合并。 MR 的真实运行结果(以 !271 为例) MR !271 已合入;最终 Pipeline #7020 成功,源码 SHA 为 e55c648b。build_app #17094 成功(约 451.6 秒);analyze_app_size_mr #17108 成功(约 80.6 秒)。这是单次耗时证据,不能代表所有项目或冷缓存场景。 package_size.json:.app 总计 357,058,497 B(357.1 MB),二进制 210,367,928 B(210.4 MB),资源 146,690,569 B(146.7 MB)。报告展示使用十进制 MB。 ...
背景与目标 2026-10-29 至 11-02,我接手了 UgreenHome 主工程里一套陈旧的 RN(React Native)依赖栈,把目标定为三件事: 清理重复的实现入口与本地临时代码,统一走内网 Specs / GitLab / Nexus; 把可复用逻辑按单一职责拆成独立组件; 恢复原生符号调试与 Metro JS 调试,同时不破坏默认的离线与发布链路。 明确的不变量:不再为内部库新增「Debug/Release × 静态/动态」四套制品;不覆盖已发布 tag;所有产品变更走 MR;主工程保留业务组合,不追求机械地搬空目录。 本文是阶段收口记录。这里先说明一个原则:已发布、已合入、测试通过、真实设备运行通过,这四件事要分别记录,不能互相替代。下面凡是说到「已合入」「已发布」,都不代表所有真机业务场景已逐项通过。 推进路线 先清理、再合入:移除重复的 Runtime/Kit 接线与过时实验内容,清理无用分支、worktree、临时文件与部分缓存,保留未提交的业务改动。 建立远端组件边界:从 LocalPods / 主工程抽取可复用逻辑与资源,迁到 home/rn;测试随实现进入 test_spec,宿主只保留跨组件与设备集成测试。 治理依赖图:从显式 binary 选择推导传递 redirect,处理 Lottie、MMKVCore、ZIPFoundation 等同模块双实现问题,再扩展为调试源码闭包。 恢复 RN_DEBUG:统一安装入口、源码/Debug 变体选择、Metro 编译隔离与调试工具组件化。 继续下沉:通用 Debug 编辑器已发布,宿主 MR !262 已合入;UGreenRNComponents 0.1.0 已发布,WebView / Lottie 两个 subspec 已由宿主 MR !273 消费,原实现已从主工程删除。 阶段成果与真实边界 依赖单一真源:移除 LocalPods/UGreenRNRuntime 等重复清单,以 Podfile 的 rn_dependencies 统一维护版本与来源。 组件化切片:Platform、Transport、DeviceSettings、E-Ink、Debug 等职责已有独立组件。Transport 先下沉 HTTP callback gate / 取消策略,DeviceSettings 先下沉启动校验 / 手势 / codec,E-Ink 先下沉图片身份 / 重试 / 调度——不宣称整套 HTTP / MQTT / 业务桥已搬完。 ...
概述 10 月 26 日,UHPlayerSDK 打 1.1.0.rc1 tag 时,动态库真机 archive 在 PrecompileModule 阶段失败,xcodebuild 退出码 65,甚至还没编到 SDK 源码。 根因是 CI 的每日缓存清理脚本按文件年龄逐个删除 Xcode 编译缓存,把仍被后续构建引用的系统 module 对象拆掉了。这破坏了按内容寻址(CAS)缓存的正确性——不是简单的缓存未命中。 本文记录现象、排查过程、根因,以及清理规则、发版 pin、launchd 路径三类修复。 现象 1.1.0.rc1 的 release-ug-component 流水线失败。同一流水线里: job 14862:git fetch 连接被重置(exit 128),属于网络抖动; 重试后的 job 14863:才是真正的构建失败。 失败点是动态库、真机 archive,xcodebuild 退出码 65,报错停在预处理系统 module: error: There was an error precompiling module .../ExplicitPrecompiledModules/_AvailabilityInternal-....scan _AvailabilityInternal 是 Xcode SDK 里的系统 clang module。构建脚本把 xcodebuild 输出交给 xcpretty 美化,底层 clang 的详细诊断被滤掉了,所以第一眼看不到根因。 排查过程 先排除了几类常见怀疑: 源码没问题:tag 指向的 44b366aa 与 10 月 23 日 MR !12 成功 archive 的是同一棵树; 依赖和工具链没变:仍是 RTCXSDK 1.7.0.7、libopus 1.1,Xcode 仍是 26.5(17F42); 发版改写不是原因:podspec 仍是 1.0.5,发版脚本会改写成 tag 版本,1.1.0 当时也是这么改写后 archive 成功的; 磁盘/进程问题无关:10 月 24 日磁盘写满(No space left on device)和随后的 maxUserProcs 耗尽是另一件事,UHPlayerSDK 当时并未写这份缓存。 真正定位靠一句话:整份删掉 compilation_cache/464 再编就通过了。说明问题在缓存本身,而不是源码或依赖。 ...
背景 某 iOS 工程把约 132 个 vendored gem(iot/vendor/cache/*.gem)通过 git-filter-repo 迁到了 Git LFS 并 force-push。此前这些 gem 是普通 git blob,checkout 不触发 git-lfs。迁移后,Jenkins 的 iOS agent(由 launchd 拉起、无 GUI 会话)第一次 checkout 到含 LFS 内容的版本,问题才暴露。 为什么会「以前没事、今天突然挂」:① 仓库是最近才引入 LFS 的,以前 checkout 根本不触发 git-lfs;② launchd agent 从一开始就没有 GUI 会话 / 完整 PATH,只是以前没被需要。 名词解释 Git LFS:Git 大文件存储,把大文件(此处是 gem 包)存到独立对象存储,工作区 checkout 时通过 smudge 过滤器按需下载。 smudge / clean / filter-process:LFS 的过滤器钩子;checkout 时的 smudge 负责把指针换成真实文件。 osxkeychain:macOS 系统级 Git 凭据助手,从登录钥匙串读凭据;无登录会话的后台进程读不到。 credential.helper:Git 的凭据获取机制;空值会清空下层继承的 helper。 现象(错误随修复逐层演进) 轮次 报错 所属层面 1 git-lfs: command not found agent PATH 不含 Homebrew 2(手动配 filter 配坏) filter-process: command not found filter.lfs.process 配成裸 filter-process 3(改绝对路径后) failed to get: -60008 osxkeychain 在 launchd 下读不了登录钥匙串 4(禁用 osxkeychain 后) batch response: too many authentication attempts git-lfs 拿不到 LFS 接口凭据 三层报错各不相同,是典型的「修好一层、暴露下一层」。 ...
背景与现象 主工程使用内部 CocoaPods Specs 仓库。某些源码 pod 的 source.git 指向内部 GitLab 镜像;另一些第三方依赖由 *-bin spec 提供预编译 XCFramework。FCUUID-bin 的 spec 声明了对源码 pod UICKeyChainStore (~> 2.1.0) 的依赖,而主工程此前没有直接声明 UICKeyChainStore。 删除 iot/Podfile.lock 后运行 make -C iot pods,CocoaPods 重新解析传递依赖,选中了 Specs 中的 UICKeyChainStore 2.1.3。该 spec 指向镜像中不存在的 v2.1.1 tag,安装失败,典型报错是 fatal: Remote branch v2.1.1 not found in upstream origin。这发生在依赖解析、源码获取阶段,尚未进入 App 链接。 主工程 Podfile → FCUUID-bin 1.3.3.1 → UICKeyChainStore (~> 2.1.0) [传递源码依赖] → 无 lock 时选到 2.1.3 → source.tag = v2.1.1 [镜像不存在] → make pods 失败。 ...
适用范围 应用:home/ios/ugreenhome 发布脚本:home/cicd/ci 组件:home/ios/components/* 时间跨度:从开启 BUILD_LIBRARY_FOR_DISTRIBUTION(BLFD)开始,到 18 个 *-bin 组件重发、真机验证、cicd 收口 MR 为止。 0. 什么是 BLFD,为什么要开 BLFD = BUILD_LIBRARY_FOR_DISTRIBUTION = YES,是 Swift 的 Library Evolution / Module Stability 开关。开启后,编译器在生成二进制的同时输出一份 .swiftinterface 文件,完整描述模块对外暴露的 API。Importer 编译时优先读取 .swiftinterface,从而让一个预编译的 Swift 二进制框架可以被不同 Swift / Xcode 版本的 consumer 导入,避免小版本差异导致 ABI 破坏。 UG 的 *-bin 组件是通过 CocoaPods 分发的预编译二进制 framework,开发机、Runner CI、本地环境用的 Xcode / Swift 版本不可能完全一致。不开 BLFD 时,Swift 编译器小版本差异就可能让 consumer 在链接 / 运行时出现 Symbol not found 或 dyld: cannot load。开启后,一次发布即可跨多个 Xcode 版本使用,不用为每个 Xcode / Swift 版本各打一份二进制。 ...
最终结果 Runtime 最终发布版本:0.1.9.17 Lottie 内网修订版本:4.6.0.1 Runtime 发布流水线:Pipeline 3740 真机产物验证 Job:9486 成功 Runtime MR !22 已合并并完成发布 ugreenhome MR !8 已合并,Runtime 与 Lottie 依赖已同步升级 下面按「问题 → 根因 → 处理」的方式复盘,避免把教训写成流水账。 1. 依赖地址与 Lottie Podspec 依赖地址必须统一使用内网 GitLab 新域名,不能把 Runner 内部 IP(形如 192.168.x.x)写进 Podspec。这会造成环境耦合、证书 / SNI 问题,也让开发机与 CI 行为不一致。 Lottie 原始 4.6.0 已经发布,不能移动或覆盖旧 Tag。保留源码不变,仅修复 Podspec URL 时,应发布新的修订版本 4.6.0.1。 Specs 仓库中的版本、s.version、Git Tag 与 Runtime 依赖版本必须完全一致——这是后面一系列问题的总根。 2. 版本号与 Tag 任何会影响发布产物或 Podspec 的修复都要递增版本号,不能复用已经发布的 Tag; Tag 应从已经合并且验证通过的 main 创建,不要从未合并提交直接打发布 Tag; 发布前确认「Tag 规则、流水线 rules、版本文件」三者一致。「打了 Tag」不等于「publish-runtime 一定会触发」。 3. publish-runtime 未随 Tag 触发 首先检查 .gitlab-ci.yml 中 job 的 rules/only 是否匹配当前 Tag; 检查 Tag 是否属于 Protected Tag,以及触发者是否有对应权限; 发布 job 与普通构建 job 是两条独立链路:普通 CI 绿色不能证明发布 job 已创建或已执行; 修复后必须用新的版本和新 Tag 验证,不能移动旧 Tag 来「补跑」。 4. Specs Token 鉴权 SPECS_GIT_PASSWORD 必须是对 Specs 仓库具备写权限的有效 Token,并正确配置到 Runtime 项目的 CI/CD Variables。变量还要检查 Protected / Masked / Environment scope——受保护 Tag 上运行时,未受保护变量可能不可见。 ...
背景 把 Kotlin Multiplatform 共享库以 XCFramework 形式发给 iOS 侧使用时,发布链路并不只是「编出来传上去」。它涉及 XCFramework 构建、二进制归档、私有 CocoaPods Specs 仓库、GitLab 包 registry,以及一连串的权限与凭据隔离问题。这里把一次完整发布踩过的坑整理成可复用的清单。 推荐发布链路 flowchart LR A[构建 XCFramework] --> B[打包 ZIP + SHA256] B --> C[生成二进制 Podspec] C --> D[上传 GitLab Generic Package] D --> E[匿名下载并校验 ZIP/SHA] E --> F[pod spec lint] F --> G[push Podspec 到私有 Specs Git] G --> H[重新 clone / readback] H --> I[干净 Podfile 执行 pod install] 名词解释 XCFramework:Apple 的跨平台 / 多架构二进制分发格式,可同时携带真机与模拟器 slice。 Podspec:CocoaPods 的依赖描述文件,声明版本、源码 / 二进制地址与校验和。 Specs 仓库:存放 Podspec 的私有 Git 仓库,相当于私有 CocoaPods 源。 Generic Package Registry:GitLab 提供的通用二进制包仓库,用来托管 ZIP 等任意产物。 Project Access Token:GitLab 的项目级访问令牌,区别于个人令牌,可限定角色与权限范围。 1. 版本必须全链路一致 以下字段必须保持一致:Git tag、VERSION_NAME、Podspec 的 version、Package Registry 路径、ZIP 文件名、checksum sidecar 文件名,以及 Specs 路径(如 UgreenHomeShared/1.7.0.4/UgreenHomeShared.podspec)。 ...
现状:崩溃根本送不到后台 P0 — 崩溃根本送不到 SDK 1. UHAvoidCrash 把 NSException 吞了(最严重) AppDelegate.swift:48 无条件调用 AvoidCrash.makeAllEffective()。它 swizzle 了 NSArray / NSDictionary / NSObject 系列方法并包在 @try/@catch 里,异常被捕获后只发一个 AvoidCrashNotification,永远不会走到任何 uncaught exception handler。数组越界、插 nil 这类 iOS 最高频的崩溃,Bugly 和 Crashlytics 都收不到。AppDelegate.swift:182 的弹窗还是 #if UGDEBUG 门控的,线上连痕迹都没有。 2. UGLog 装了不链式的 uncaught handler UGLog.swift:212 的 NSSetUncaughtExceptionHandler 在 AppDelegate:61 安装,捕获后只写日志、不转发给前一个 handler。它是三者中最早装的,所以实际会被 Crashlytics / Bugly 覆盖;但 Bugly 在 AppDelegate:274 最后启动,它是否把 handler 链回 Crashlytics,源码里看不出来。这意味着 Crashlytics 可能整条链路被 Bugly 顶掉。这个必须实测:Release 包强制崩一次,同时看两个后台。 P1 — Bugly 数据基本不可用 3. Bugly 没有 dSYM 上传:全仓库只有 ${PODS_ROOT}/FirebaseCrashlytics/run(project.pbxproj:692),没有任何 buglySymbol / 上传脚本。Bugly 上的堆栈会是纯地址。 ...