跳到主要内容

安装 KXBuild

一条命令装好 iOS 开发环境,支持 Windows、Linux 和 macOS。遇到问题请联系 admin@kxbuild.net

推荐方式通过WSL安装

1

安装 WSL,然后重启电脑

PS> wsl --install
2

安装 Ubuntu

PS> wsl --install --web-download Ubuntu --location D:\wslubuntu

--location 参数指定wsl子系统的安装路径。wsl --list --online命令查看可用版本

3

安装KXBuild

打开 Ubuntu 终端(PowerShell 执行 wsl),执行下面命令。安装过程中可以根据提示设置安装路径。

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

默认安装路径 ~/kxbuild(Ubuntu 内)

4

设置 iOS SDK

下载 iOS SDK 的两个压缩包 iPhoneOS.platform.zip 和 toolchain.zip,放进 KXBUILD_HOME/sharedcomponents/。可以从 ios sdk 之类的地方下载,或下载 Xcode 后用 ios-sdk-extractor 之类的工具提取,详见 iOS SDK 安装说明。

5

检验安装是否成功

新开一个 Ubuntu 终端(PowerShell 执行 wsl),执行下面命令,它会安装放好的 SDK 并检查环境:

$ kxbuild doctor

直接在 Windows安装

1

安装KXBuild

打开 PowerShell,执行下面命令。会自动安装swift,vs studio等需要几分钟到几十几分钟不等,安装过程中按提示选择安装路径,确认授权等

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

默认安装路径 %USERPROFILE%\kxbuild

2

设置 iOS SDK

下载 iOS SDK 的两个压缩包 iPhoneOS.platform.zip 和 toolchain.zip,放进 KXBUILD_HOME/sharedcomponents/。可以从 ios sdk 之类的地方下载,或下载 Xcode 后用 ios-sdk-extractor 之类的工具提取,详见 iOS SDK 安装说明。

3

检验安装是否成功

新开一个 PowerShell 窗口(让 PATH 生效),执行下面命令,它会安装放好的 SDK 并检查环境:

PS> kxbuild doctor
注意:这种方式需要安装 Visual Studio C++ 生成工具,占用10-20 GB 磁盘;而且 Windows 默认有 260 字符的路径长度限制,编译时可能因路径过长而报错。建议优先用 WSL 方式。

按需下载

这几样要从 Apple 或应用商店下载,安装脚本不会自动安装,用到时再装。

Apple Devices

Windows

Windows 连接 iPhone 需要先从 Microsoft Store 安装「Apple 设备」并打开它,等待提示的驱动安装完成,确认软件里能看到你的 iPhone,再使用 KXBuild。

Metal Developer Tools

Windows

工程里有 .metal 着色器时需要。下载要登录 Apple 账号,装好后直接构建,KXBuild 会自动找到它。

Xcode 安装包(.xip)

Windows · Linux

SDK 也可以直接用 Xcode 安装包:把 .xip 放进 sharedcomponents,doctor 会从里面提取 SDK。下载要登录 Apple 账号。

接下来