KXBuild 文档

第一次用先看「上手」里的两篇之一，一篇走完从安装到上架。之后按你要做的事翻「常用任务」；插件每个功能和每条命令的详解，从顶栏的「IDE」和「命令行」进。

上手

两篇流程教程，步骤一一对应。用 VS Code 插件的看第一篇，只用终端或要接 CI 的看第二篇。

用 KXBuild 的 VS Code 插件在 Windows 上走通 iOS 开发主线，新建项目、设置证书、真机调试、编译发布版 ipa，Linux 和 macOS 操作相同。

只用终端在 Windows 上走通 iOS 开发主线，新建项目、设置证书、真机安装调试、编译发布版 ipa，Linux 和 macOS 操作相同。

不分工具，讲清一件事怎么做成；每篇里「IDE 里」和「命令行里」两种做法并列。

下载 iPhoneOS.platform.zip 和 toolchain.zip 两个压缩包，放进 sharedcomponents，运行 kxbuild doctor 安装。

新建项目时可选的 11 个内置模板，模板目录的结构，以及如何添加自定义模板。VS Code 向导和命令行使用同一份模板。

Debug 和 Release 的区别，scheme / target / 配置怎么选，怎么覆盖构建设置，产物在哪，.ipa 什么时候出，Swift Package 依赖何时解析。

用 Distribution 证书构建 Release 直接得到 .ipa，用 Appuploader 或 Transporter 传到 App Store Connect，走 TestFlight 和提审；Ad Hoc / 企业分发同一条路。

先跑 kxbuild doctor；然后按错误消息查安装、工程、签名、设备、发布、插件六类问题，以及日志在哪看。

没有 Instruments 也能分析性能。kxdevice 直接从真机采集 CPU、内存分配、网络、耗电、掉帧和调用栈，命令行或网页界面都可以。

没有证书也能编译，但装不进手机。准备好 .p12 和 .mobileprovision 放进证书目录，之后每次构建自动签名；工程里怎么指定证书、命令行怎么临时覆盖。

让电脑识别 iPhone。电脑上安装驱动，手机上信任并打开开发者模式，第一次调试时下载符号库，多台设备如何选择。

要在终端里装机、看日志、传文件、采性能？ kxdevice 命令参考

安装脚本跑不通，或者想自己决定每个组件的版本和位置？看手动安装步骤