跳到主要内容
本页目录

KXBuild快速上手

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

1

安装

按系统执行对应的命令,按提示完成。

Windows · PowerShell

PS> irm https://www.kxbuild.net/install.ps1 | iex

Linux / macOS · 终端

$ curl -fsSL https://www.kxbuild.net/install.sh | bash

安装后新开一个终端执行 kxbuild doctor,全部通过即可。其他安装方式见安装页。

2

新建项目

用 SwiftUI 模板新建一个,指定项目名、Bundle ID 和父目录。

> kxbuild project create -t app_swiftui -n MyApp -b com.example.myapp -o D:\projects

工程创建在 D:\projects\MyApp。kxbuild project templates 列出全部模板,详见项目模板。已有工程直接使用它的路径。

3

设置证书

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

development.p12=123456
4

连接手机

手机连上电脑,查看是否识别。

> kxdevice device list

第一次连接需要完成三件事。

  • 安装驱动,电脑上没有 Apple 设备驱动时上面的命令会提示运行 kxdevice doctor,请先从 Microsoft Store 安装并打开「Apple 设备」,确认软件里能看到手机。
  • 信任此电脑,在手机弹出的提示中点「信任」
  • 打开开发者模式,手机「设置 → 隐私与安全性 → 开发者模式」,打开后重启
5

编译并安装到手机

构建命令加 --install,编译、签名、安装一次完成,默认 Debug 配置。安装后在手机上打开 App。

> kxbuild build D:\projects\MyApp\MyApp.xcodeproj --install
6

编译发布版 ipa

keychain 目录中放好 Apple Distribution 证书和 App Store 类型的描述文件,用 Release 配置构建。

> kxbuild build D:\projects\MyApp\MyApp.xcodeproj -c Release

完成后工程目录下生成 build\MyApp.ipa,用 Appuploader 或 Transporter 上传到 App Store Connect,详见发布与上架。

接下来