跳到主要内容

KXBuild

跨平台 iOS 开发 IDE，Windows、Linux、macOS 上都能开发 iOS

在 Windows、Linux、macOS 开发 iOS App。完美兼容xcode工程和xcodebuild命令。Swift、Objective-C、Flutter、React Native、Expo、Unity3d、uni-app 等工程不需要修改即可开发调试和构建发布

安装 看 IDE 怎么用 →
Windows 上的 VS Code 里，断点停在 iPhone 上运行的 Swift App，左侧是变量、调用栈和线程

Windows 上的 VS Code。按 F5 之后，断点停在 USB 连接的 iPhone 上，变量和调用栈都在左边。

支持的工程 Flutter React Native Expo Uni-App Kotlin Multiplatform Unity3D Godot cocos2d-x Cordova Objective-C Swift
运行在 Windows 10 / 11 Linux/WSL macOS

多种工程类型

现有 Xcode 工程拿来就用，不用改一行配置

.xcodeproj、.xcworkspace、Swift Package、CocoaPods 工作区原样打开就能构建，scheme、配置和构建设置都按工程里的来。Flutter、React Native、Expo、Kotlin Multiplatform 只编译其中的 iOS 原生部分，各自的命令照常用。

新工程从 11 个模板起步。SwiftUI、UIKit（Swift、Objective-C、混编）、WKWebView 套壳、CocoaPods、Flutter、React Native、Expo、Swift 框架、Objective-C 静态库。

看新建、打开与导入工程 →

新建项目向导的模板列表

真机调试

Windows 上 iOS 真机调试，连上 iPhone 按 F5

手机接到这台电脑上，不用写 launch.json。Swift、Objective-C、C / C++ 的断点、变量、调用栈都在 VS Code 里，Flutter 工程会再自动接上 Dart 调试。设备日志、崩溃报告、截图、CPU 和内存采样都直接从真机上拿。

看运行与调试 →

侧边栏列出的 iPhone、构建配置和工程

构建与发布

在 Windows、Linux、macOS 上打包 ipa，上架 App Store

Release 构建在工程目录下生成可上传的 .ipa，交给 Transporter 或 Appuploader 上传到 App Store Connect，TestFlight 和提审流程与平时相同。

看发布与上架 →

PS D:\projects\MyApp> kxbuild build MyApp.xcodeproj -c Release
INFO build output: D:\projects\MyApp\build
CompileSwiftSources normal arm64 (in target 'MyApp')
CompileStoryboard LaunchScreen.storyboard (in target 'MyApp')
CompileAssetCatalog Assets.xcassets (in target 'MyApp')
Ld MyApp.app/MyApp normal (in target 'MyApp')
CodeSign MyApp.app (in target 'MyApp')
INFO Build succeeded executed=42 up-to-date=0 duration=1m12s
INFO Packaged ipa path=D:\projects\MyApp\build\MyApp.ipa

工程文件编辑器

工程设置、Info.plist、图标，不开 Xcode 也能可视化编辑

工程设置、Info.plist、资源目录、图标文档都有图形界面，不用手改 XML 和 project.pbxproj。

  • 六个编辑器

    工程设置、属性列表、资源目录与 App 图标、本地化字符串表、图标文档、描述文件查看。保存的就是 Xcode 能打开的原文件。

  • 代码提示不用先构建

    打开工程就有补全、跳转、悬停和诊断，Swift、Objective-C、C / C++ 都一样，系统框架的 API 也能补全。

  • AI 助手照常用

    Copilot、Claude Code 这些 VS Code 里的助手都在，iOS 工程和别的工程没有区别。

看 VS Code 插件的全部功能 →

工程设置编辑器
工程设置编辑器 →
属性列表编辑器
属性列表编辑器 →
资源目录编辑器
资源目录编辑器 →
图标文档编辑器
图标文档编辑器 →

命令行

命令行兼容 xcodebuild，构建脚本和 CI 流水线不用改

kxbuild 管工程与构建，一条命令从源码到 .ipa，装到手机、看日志、抓性能也都是一条命令。

  • 一条命令从源码到 .ipa

    Xcode 工程、工作区、Swift Package 直接构建。Release 出可上传的 .ipa，Debug 加 --install 顺手装到手机。

  • xcodebuild、xcrun 同名兼容

    安装目录里有同名的 xcodebuild 和 xcrun，React Native、Expo、Flutter、Cordova 的构建脚本原样运行。

  • 构建机可用 Windows、Linux 或 macOS

    Windows、Linux 的流水线跑机上照样出包，固定输出目录，产物和本地一致。

  • --json 给脚本和 AI 用

    每条命令都能输出机器可读的进度、诊断和结果，退出码可判。ai和自动化更加方便流畅

看命令行工具 →

$ kxbuild doctor ios/
INFO Running environment diagnostics...
INFO ✓ Development tools are up to date
$ kxbuild build ios/MyApp.xcworkspace -s MyApp -c Release --json
{"type":"progress","phase":"CompileSwiftSources","current":12,"total":42}
{"type":"progress","phase":"CodeSign","current":42,"total":42}
{"type":"result","command":"build","data":{"success":true,"duration":"1m12s","ipa":["ios/build/MyApp.ipa"]}}
$ kxdevice install ios/build/MyApp.ipa
installing: 100% Complete

支持范围

Windows 上能开发哪些 iOS 工程

kxbuild可以编译任何标准的xcode工程和swift工程，下面是常见的项目类型，在Windows 10 / 11、Linux/WSL、macOS 都能跑

工程类型 构建 装到真机 断点调试 Release .ipa
Xcode 工程（Swift / Objective-C） .xcodeproj / .xcworkspace，Storyboard、xib、资源目录、Core Data 模型都能编 ✓ ✓ ✓ ✓
Swift Package 远程 / 本地依赖、资源、宏、构建插件、二进制 xcframework，App 类的包转为 App 工程后出 ipa ✓ ✓ ✓ ✓
CocoaPods 工作区 工具链自带 Ruby 与 CocoaPods，pod install 直接跑 ✓ ✓ ✓ ✓
Flutter 打开工程根目录，原生和 Dart 都能断点，热重载照常用 ✓ ✓ ✓ ✓
React Native / Expo 社区 CLI 与 expo prebuild 工程，构建脚本不用改 ✓ ✓ ✓ ✓
uni-app（HBuilderX） 导入 HBuilder 工程 + 官方 iOS SDK，生成可构建的 Xcode 工程 ✓ ✓ ✓ ✓
Kotlin Multiplatform iosApp 工程，Kotlin 代码也能断点，Compose Multiplatform 也支持 ✓ ✓ ✓ ✓
Unity 导出的 Xcode 工程按原生工程处理 ✓ ✓ ✓ ✓
Godot 导出的 Xcode 工程按原生工程处理 ✓ ✓ ✓ ✓
cocos2d-x 按原生工程处理，引擎子工程一起编；4.x 的工程体检时生成 ✓ ✓ ✓ ✓
Cordova platforms/ios 下的 Xcode 工程，cordova 命令照常用 ✓ ✓ ✓ ✓

看各技术栈的开发步骤 →

常见问题

关于 Windows 开发 iOS，你可能想问

Windows 上真的能开发 iOS App 吗？
能。KXBuild 在 Windows 本机开发编译iOS App，装到 USB 连接的 iPhone 上调试；Release 构建直接出 .ipa。整个过程纯云生，无系统依赖，无性能损耗。也可以在linux和mac系统上运行
KXBuild 能在哪些系统上运行？
Windows、Linux、macOS 上都能原生运行。KXBuild 是一整套完整、独立的构建工具链，不限 CPU 架构，直接发挥本机的全部性能。
Flutter、React Native、Expo、uni-app 怎么接？
Flutter、React Native、Expo 工程直接打开根目录，KXBuild 负责 iOS 侧构建，它们的构建脚本不用改。uni-app 用「导入 uni-app 项目」把 HBuilder 工程和官方 iOS SDK 生成一个可构建的 Xcode 工程。各技术栈的步骤见技术栈页。
真机调试需要什么？
一部 iPhone、一根数据线，Windows 上从 Microsoft Store 安装并打开「Apple 设备」（提供 USB 驱动，需等驱动安装完成，并确认能看到手机）。手机上信任电脑、打开开发者模式，之后按 F5 即可。
需要安装 Xcode 吗？
不需要安装 Xcode。KXBuild 包含一整套完整开发工具套装，只需要一条命令即可安装开始开发，不依赖xcode
已有的 Xcode 工程能直接用吗？
能kxbuild兼容xcode，也对xcodebuild做了兼容，可以直接处理现有项目。.xcodeproj、.xcworkspace、CocoaPods 工作区、Swift Package 原样打开就能构建，scheme、配置都按工程里的来，不用改造工程文件。
现有的构建脚本和 CI 流水线能直接用吗？
能。安装目录里有同名的 xcodebuild 和 xcrun，调用它们的构建脚本、React Native、Expo、Flutter、Cordova 自带的脚本都不用改。Windows 和 Linux 的流水线机器上也能出包，产物和本地一致。
出的包能上架 App Store 吗？
能。KXBuild 产出的 .ipa 结构与 Xcode 的一致，Release 构建后用 Transporter 或 Appuploader 上传到 App Store Connect，走 TestFlight 和审核的流程与平时相同。

现在就在 Windows 上开发 iOS App

一行命令安装 KXBuild。Windows、Linux、macOS 都行。

Windows PowerShell

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

Linux · macOS

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

安装说明 →