快速开始
安装插件、打开工程、选运行目标，按 Cmd+R 在模拟器或 iPhone 上停到第一个断点。
从安装插件到在模拟器或 iPhone 上停到第一个断点，大约五分钟。开始前确认 Mac 上已经装好 Xcode，并至少打开过一次。
1. 安装插件
在 VS Code 的扩展视图（Cmd+Shift+X）搜索 kxapp 并安装。用 Cursor、VSCodium 或想离线安装的，见安装页。
2. 打开工程所在的文件夹
用「文件 › 打开文件夹…」打开含有 .xcodeproj 或 .xcworkspace 的目录（工程可以在子目录里）。插件识别到工程后：
- 活动栏出现 Xcode 工程 视图，列出工程、Scheme、构建配置、运行目标、设备与模拟器和各个 target。
- 状态栏出现「Scheme · 配置」、运行目标和构建按钮。
同名的 .xcworkspace 和 .xcodeproj 同时存在时（例如 CocoaPods 工程）自动用工作区；文件夹里有多个不同的工程时，在视图里点「工程」一行切换。
3. 选 Scheme 和运行目标
点状态栏的 Scheme 选要运行的 App，再点运行目标选一台模拟器或用数据线连着的 iPhone。真机第一次使用前：
- 解锁手机、点「信任此电脑」，在「设置 › 隐私与安全性」里打开开发者模式。
- 在 Xcode 的「Window › Devices and Simulators」里让 Xcode 准备一次这台设备，之后调试才快。
- 在 Xcode「设置 › 账户」登录 Apple ID，工程使用自动签名。
4. 打断点，按 Cmd+R
在源码行号左侧点一下设断点，按 Cmd+R（或 F5）。插件依次构建、安装、启动 App 并接上调试器，断点命中后变量、调用栈和线程都在左侧的调试视图里。按 Cmd+. 停止。
App 的打印输出在「输出 › kxapp Console」，构建日志在「输出 › kxapp Build」。编译错误会进「问题」面板，点一下跳到出错的行。