侧边栏与状态栏
插件在 VS Code 里占了哪几个位置。KXBuild 视图的每个节点、标题栏按钮、右键菜单和状态栏各做什么，接上手机后在哪里选设备，App 输出和构建日志在哪个面板。
| 编号 | 位置 | 用途 |
|---|---|---|
| ① | 活动栏图标 | 点击打开 KXBuild 视图 |
| ② | 视图标题栏 | 构建并运行、运行、构建、刷新设备列表，最右边的「···」展开更多命令 |
| ③ | 视图节点 | 设备、构建配置、工程和 target，点击切换或操作 |
| ④ | 状态栏 | 当前工程类型、设备和配置，点击切换设备 |
视图节点
| 节点 | 内容 | 点击 |
|---|---|---|
| 设备 | 当前设备名、连接方式和系统版本，如 USB · iOS 17.5。没有设备驱动时显示「点击配置」 | 切换设备，或安装驱动 |
| 构建配置 | Debug 或 Release | 切换构建配置 |
| 工程 | 打开目录中的每个 .xcworkspace / .xcodeproj，多工程时启动项目带星标 | 展开，多工程时切换启动项目 |
| target | 工程中全部 target，类型标在后面，app、test、extension、framework、library、bundle | 行内按钮构建该 target，可运行的 target 还有「构建并运行」「运行」 |
| 资源目录 | 工程目录下的 .xcassets | 打开资源目录编辑器 |
target 读不出来时先运行一次体检。
标题栏与右键菜单
| 位置 | 命令 |
|---|---|
| 标题栏按钮 | 构建并运行 · 运行 · 构建 · 刷新设备列表 |
| 标题栏「···」更多命令 | 新建项目 · 导入 uni-app 项目 · 体检并修复开发环境 · 选择构建配置 · 附加到运行中的 App · 选择启动项目 · 选择工具链 · 安装工具链 |
| 工程节点右键 | 编辑工程设置 |
| target 节点右键 | 编辑目标设置 |
| 资源管理器中右键 .xcodeproj / .xcworkspace | 构建并运行 · 构建 · 设为启动项目 · 生成 compile_commands.json · 工程设置… |
这些命令在命令面板里都以「KXBuild:」开头，Ctrl+Shift+P 输入 KXBuild 也能找到。
状态栏
右下角显示 工程类型 · 设备名 · Debug，忙碌时前面转圈，悬停查看当前状态。点击切换设备。切换配置用视图中的构建配置节点。
设备与日志
用数据线接上 iPhone，视图中的设备节点和状态栏立即显示出来，插拔不用刷新。接了多台时点设备节点或状态栏选一台，F5 和「构建并运行」都装到这一台。设备节点显示「点击配置」说明还没装设备驱动，点一下按提示安装，详见设备连接。
| 内容 | 位置 |
|---|---|
| App 的输出，print、NSLog、os_log | 输出面板 → KXBuild Console |
| 构建日志 | 输出面板 → KXBuild |
| 编译错误和警告 | 问题面板，点击跳到源码 |
输出面板用 Ctrl+Shift+U 打开，右上角下拉框切换 KXBuild 与 KXBuild Console。构建或运行失败时通知上有「Show Output」，点击直接跳到对应日志。
启动项目
一个窗口中有多个工程时，F5、标题栏按钮和状态栏都作用于启动项目。在工程节点上点击切换，或在资源管理器中右键 .xcodeproj 选择「设为启动项目」。要单独构建某个库或扩展，直接点该 target 行上的按钮，不用切换启动项目。