SuperAPI AI 工具集

apple-debugging

编程与开发

查看项目

更新于 11-09 18:51

技能介绍

该技能用于驱动 LLDB 与 Xcode 快速定位 Apple 平台应用缺陷。核心理念是优先在运行中的进程里做实验,而不是反复重新编译:在正确位置停下、查看真实状态、运行时修改状态、证明修复有效,最后才改源码并在干净运行中验证。

调试循环为:运行、断点、检查、修改、重复。技能通过一组参考文件支撑各步骤:

  • 附着与运行:通过 Xcode 运行、无需构建运行、按名称或 PID 附着、或在终端批量使用 lldb 接入进程。
  • LLDB 基础:命令语法、打印命令、语言上下文与 $ 变量。
  • 断点:行断点、列断点、符号断点、正则断点、条件断点、一次性断点、依赖断点、异常断点、Swift 错误断点、运行时问题断点。
  • 状态检查:变量、按原始地址查看对象、汇编帧中的寄存器与 $arg1、回溯、线程、镜像、内存。
  • 流程控制:单步、finish、thread return、thread jump、拖动指令指针、在遵守断点的情况下运行函数。
  • 运行时状态修改:修改值、调用方法、自动继续的断点动作、替换一行、为函数打桩、刷新 Core Animation,无需重新构建。
  • 视图调试:场景与窗口选择、布局、命中测试、键盘焦点、深色模式、动画、SwiftUI 重渲染。
  • 监视点与内存:监视点、内存图、malloc 历史、泄漏、vmmap、僵尸对象、sanitizer、jetsam。
  • 崩溃与符号化:崩溃日志、dSYM、UUID、atos、源码映射、核心文件、异常类型含义。
  • Swift 调试:po 或 p 失败、类型缺失、变量被优化掉时的处理方法。
  • 无源码调试:识别二进制与切片、地址转换、查找继承的 Objective-C 实现、读取 Mach-O 结构,以及寄存器、调用约定、arm64 指令、栈帧、DWARF 位置。
  • 运行时与内存细节:block、按镜像的类转储、被剥离的 Objective-C 栈、堆实例、单例存储、交叉引用、模拟器系统进程。
  • 动态加载与插入:加载诊断库、插入 C 调用、在自有应用中 swizzle Objective-C 方法、转发模拟器启动环境。
  • 签名与附着诊断:附着失败、库被拒绝、调试器下应用退出(签名、权限、加固运行时、PT_DENY_ATTACH)。
  • 自定义命令:别名、正则命令、Python 命令、数据格式化器、.lldbinit 布局、第三方命令包,以及结构化 SBValue、分配历史与内置辅助命令。
  • 追踪与 DTrace:无需源码追踪整个进程或 Apple 代码,包括断点追踪器、停止钩子、统一日志、挂起采样,以及递归感知计时、系统调用参数和破坏性 DTrace 动作。
  • 远程与工具链:远程 debugserver 会话、lldb-dap、LLDB 的 MCP 服务器、自定义断点解析器、脚本化进程或线程计划。
  • 常见场景的分步操作手册,以及报告前应检查的反模式清单。

工作方式有两种:一种由代理持有调试器,通过终端附着并批量执行命令、读取输出、分离;另一种由用户持有调试器,代理给出逐条控制台命令、说明预期输出,并保持用户会话不中断。两种方式的交付物相同:观察到了什么、证明了什么、修复方案,以及如何在运行时和干净运行中验证。

技能还给出决策树,帮助选择打印命令(v、p、po 或 frame variable)、停止方式(行、符号、正则、条件、监视点、异常断点等)、是否重新构建、无源码时的起点,以及重复命令的持久化方式(别名、正则、Python 命令、类型摘要)。核心注意事项包括:Swift 中优先用 v;理解当前语言上下文;持久变量以 $ 开头且不跨语言上下文;符号断点在类未重写方法时不会命中;Objective-C 方法入口的 $arg1/$arg2/$arg3 含义;UIKit 中应选择正确场景窗口;修改 UI 后刷新 Core Animation;thread jump 前先看反汇编。

使用限制方面,该技能依赖 LLDB 与 Xcode 调试环境,涉及无源码、签名、加固运行时等场景时需要相应条件;部分操作(如描述对象、调用方法)会执行目标代码,在死锁或生命周期调查中应避免。