KXBuild IDE 快速上手

安装插件

先按安装页安装 kxbuild 工具链，再在 VS Code 扩展视图（Ctrl+Shift+X）搜索 KXBuild 并安装。安装后左侧活动栏出现 KXBuild 图标。使用 WSL 开发的再安装 WSL 扩展。

新建项目

命令面板（Ctrl+Shift+P）运行 KXBuild: 新建项目，模板选「iOS 应用（SwiftUI）」，填写项目名和 Bundle ID，选择目录。创建后打开该目录，KXBuild 视图中显示工程和 target。已有项目直接打开目录即可，详见新建、打开与导入工程。

设置证书

把 .p12 证书和 .mobileprovision 描述文件放进项目根目录下的 keychain 目录，或 KXBUILD_HOME 下的 keychain 目录，再在同目录的 password.properties 中写一行「文件名=密码」。描述文件必须是开发类型且包含这部手机的 UDID。详见证书与签名。

连接手机

手机连上电脑，在 KXBuild 视图的「设备」节点中点击手机选为当前设备。第一次连接需要完成四件事。

• 安装驱动，设备节点提示「点击配置」时点一下并确认管理员授权
• 信任此电脑，在手机弹出的提示中点「信任」
• 打开开发者模式，手机「设置 → 隐私与安全性 → 开发者模式」，打开后重启
• 等待符号库下载，第一次调试前自动下载，有几个 GB，大约十多分钟，只需一次

真机调试

打断点，按 F5。构建、签名、安装、启动、附加调试器自动完成，断点命中后进入 VS Code 调试视图。App 输出在「输出 → KXBuild Console」，编译错误在「问题」面板。

编译发布版 ipa

keychain 目录中放好 Apple Distribution 证书和 App Store 类型的描述文件，在 KXBuild 视图的「构建配置」节点把配置切到 Release，命令面板运行 KXBuild: 构建。完成后工程目录下生成 build\MyApp.ipa，用 Appuploader 或 Transporter 上传到 App Store Connect，详见发布与上架。