KXBuild快速上手
只用终端在 Windows 上走通 iOS 开发主线,新建项目、设置证书、真机安装调试、编译发布版 ipa,Linux 和 macOS 操作相同。
安装
按系统执行对应的命令,按提示完成。
Windows · PowerShell
PS> irm https://www.kxbuild.net/install.ps1 | iexLinux / macOS · 终端
$ curl -fsSL https://www.kxbuild.net/install.sh | bash安装后新开一个终端执行 kxbuild doctor,全部通过即可。其他安装方式见安装页。
新建项目
用 SwiftUI 模板新建一个,指定项目名、Bundle ID 和父目录。
> kxbuild project create -t app_swiftui -n MyApp -b com.example.myapp -o D:\projects工程创建在 D:\projects\MyApp。kxbuild project templates 列出全部模板,详见项目模板。已有工程直接使用它的路径。
设置证书
把 .p12 证书和 .mobileprovision 描述文件放进项目根目录下的 keychain 目录,或 KXBUILD_HOME 下的 keychain 目录,再在同目录的 password.properties 中写一行「文件名=密码」。描述文件必须是开发类型且包含这部手机的 UDID。详见证书与签名。
development.p12=123456连接手机
手机连上电脑,查看是否识别。
> kxdevice device list第一次连接需要完成三件事。
- 安装驱动,电脑上没有 Apple 设备驱动时上面的命令会提示运行 kxdevice doctor,请先从 Microsoft Store 安装并打开「Apple 设备」,确认软件里能看到手机。
- 信任此电脑,在手机弹出的提示中点「信任」
- 打开开发者模式,手机「设置 → 隐私与安全性 → 开发者模式」,打开后重启
编译并安装到手机
构建命令加 --install,编译、签名、安装一次完成,默认 Debug 配置。安装后在手机上打开 App。
> kxbuild build D:\projects\MyApp\MyApp.xcodeproj --install编译发布版 ipa
keychain 目录中放好 Apple Distribution 证书和 App Store 类型的描述文件,用 Release 配置构建。
> kxbuild build D:\projects\MyApp\MyApp.xcodeproj -c Release完成后工程目录下生成 build\MyApp.ipa,用 Appuploader 或 Transporter 上传到 App Store Connect,详见发布与上架。