跳到主要内容

KXBuild命令行工具

在 Windows、Linux、macOS 上用命令行编译 iOS 工程、出 ipa。kxbuild 兼容 xcodebuild 和 xcrun,现有工程的构建脚本、自动化工具和 CI 流水线不用改就能跑;每条命令都能输出 JSON,AI 和脚本调用更方便。

kxbuild:工程与构建

体检、修复、升级

检查开发环境,缺的装上、旧的更新,带上工程路径还会为 Flutter、React Native、Expo 等工程做好准备。安装后、升级后、构建报错时运行一次。

按模板新建

自带一批项目模板,一条命令建好工程,覆盖 SwiftUI、UIKit、CocoaPods、Flutter、React Native、Expo 等。也可以把自己的工程做成模板,放进安装目录的 resources/templates 即可。

一条命令从源码到 ipa

Xcode 工程、工作区、Swift Package 直接构建。Release 配置在工程目录下生成可上传的 .ipa,Debug 加 --install 顺手装到手机。

看工程、改设置

把 target、scheme、Bundle ID、构建设置以 JSON 打印出来。改一个设置、加一个文件夹分组、批量套用改动,都不用打开 project.pbxproj。

Swift Package 依赖

构建时自动解析,也可以单独解析。按 Package.resolved 钉版本、离线不拉远程、共享包缓存,Reset Package Caches 一个参数。

xcodebuild 兼容与自动化

xcodebuild / xcrun 兼容

安装目录里有同名的 xcodebuild 和 xcrun,常用参数与 Xcode 一致。现有工程的构建脚本、自动化工具不用改,React Native、Expo、Flutter、Cordova 自带的构建脚本也原样运行。

脚本、CI 与 AI

Windows、Linux、macOS 的流水线机器上都能出包,固定输出目录与包缓存后产物和本地一致。命令加上 --json,都会输出机器可读的进度、诊断和结果,退出码可判,脚本和 AI 编程助手可以直接调用。

目录与环境变量

安装目录里有什么、产物放哪、日志级别怎么开,都在这里。

环境变量 KXBUILD_HOME

喜欢图形界面?功能一样的 VS Code 插件

命令行能做的插件里都能做,产物和参数完全一样,两边随时切换。