Ionic 怎么在 Windows 打包 iOS？Capacitor 工程出 ipa

npx cap sync ios 之后，在 Windows 上编 ios/App 下的工程。

最后更新 2026-11-12

操作方式

Ionic / Capacitor 在 Windows 打包 iOS，先照常构建网页并执行 npx cap sync ios：Capacitor 生成的 ios/App 按普通 Xcode 工程由 KXBuild 编译，通过 USB 装到 iPhone 真机调试，Release 构建直接在 ios/App/build 下生成 ipa。npx cap 命令和插件照常使用，Capacitor 8 的工程用 Swift Package 管理插件，不需要 CocoaPods。

Windows 上怎么给 Ionic / Capacitor 工程添加 iOS 平台？

1. 构建网页并同步到 iOS 工程

已有工程在工程目录安装依赖、构建网页，再同步到 iOS 工程；还没有 ios/ 目录的，先执行一次 npx cap add ios。

> npm install

> npm run build

> npx cap sync ios

没有现成工程的，用 Capacitor 的脚手架新建，装上 iOS 平台包，构建网页后添加 iOS 平台，Xcode 工程生成在 ios/App 下。

> npx @capacitor/create-app MyApp --name MyApp --app-id com.example.myapp

> cd MyApp

> npm install @capacitor/ios

> npm run build

> npx cap add ios

之后在 VS Code 中「文件 → 打开文件夹」打开 ios/App 目录，或者把整个工程拖进 VS Code 即可。

2. 体检

它会检查编译需要的环境，并准备好 iOS 端的工程。

KXBuild 视图标题栏「···」中运行「体检并修复开发环境」。

> kxbuild doctor .\ios\App\App.xcodeproj

Capacitor 8 的工程把插件放在 ios/App/CapApp-SPM 这个 Swift Package 里，不需要 CocoaPods。较早版本的工程 ios/App 下有 Podfile，Windows 上 npx cap sync 不会自动安装，要在 ios/App 目录执行一次 pod install，之后构建 App.xcworkspace；每次增删插件后都要重新执行，见 CocoaPods。

ios\App> pod install

Ionic / Capacitor 的网页和原生代码怎么在 iPhone 上调试？

3. 编码

网页代码照常在 src/ 下编写，改完执行 npm run build 和 npx cap copy ios 同步到 iOS 工程，增删了 Capacitor 插件时改用 npx cap sync ios。原生插件代码在 VS Code 中有补全和跳转。

4. 调试

USB 连接 iPhone。

在 KXBuild 视图中选中设备，按 F5，Capacitor 运行时和原生插件代码在 VS Code 中断点调试。

构建并装到手机上启动：

> kxbuild run .\ios\App\App.xcodeproj

页面里的 JS 用 npm start 在电脑浏览器里运行，用浏览器的开发者工具调试。

第一次连手机前，Windows 上先从 Microsoft Store 安装并打开「Apple 设备」完成驱动安装；iOS 16 及以上的手机要在设置 → 隐私与安全性里打开开发者模式，打开后手机重启一次。完整步骤见 Windows 连接 iPhone 真机调试。

Ionic / Capacitor 在 Windows 怎么打包 iOS 的 ipa 并上架？

5. 发布

先执行 npm run build 和 npx cap sync ios，确保打进包里的是最新网页，再用 Release 配置构建，ios/App/build 下生成 .ipa。上传到 App Store Connect 见 Windows 上架 App Store。

运行 KXBuild: 生成 App Store ipa（命令面板或工程右键菜单）。

> kxbuild build .\ios\App\App.xcodeproj -c Release --export app-store

上架用的 ipa 要用 Apple Distribution 证书签名：把你自己的 .p12 证书和 .mobileprovision 描述文件放进 keychain/ 文件夹，之后每次构建自动签名，申请方法见 Windows 给 iOS App 签名。上传用 kxstore（kxstore build upload，Windows、Linux、macOS 都能用），TestFlight 和审核在 App Store Connect 网页上完成。这样 Ionic / Capacitor 在 Windows 打包 iOS、真机调试到上传审核都在同一台电脑上完成。

接下来

构建与配置

Debug 和 Release 的区别，scheme / target / 配置怎么选，怎么覆盖构建设置，产物在哪，.ipa 什么时候出，Swift Package 依赖何时解析。

发布与上架

用 Distribution 证书构建 Release 直接得到 .ipa，用 kxstore（或 Mac 上的 Transporter）传到 App Store Connect，走 TestFlight 和提审；Ad Hoc / 企业分发同一条路。

没找到你的工程类型？

kxbuild是通用编译工具，只要最终能产出 Xcode 工程，KXBuild 就能编。列出来的技术支持只是一些技术领域的应用，遇到问题随时联系我们

admin@kxbuild.net 全部技术栈