Windows 上本地构建 Expo iOS App

自动 prebuild 生成 ios/，原生侧在 Windows 上编译装机，JS 侧照常跑 Metro。

Expo 工程在 Windows 上可以本地构建 iOS 端并真机调试，不经过 EAS Build。没有 ios/ 目录的工程，体检时会自动生成。JS 部分照常运行 Metro，原生代码可以断点调试。

步骤

按 Expo 官网的说明安装 Node.js，新开一个终端能看到版本号即可。

> node --version

已有工程在 VS Code 中「文件 → 打开文件夹」打开工程根目录，或者把工程目录拖进 VS Code 即可。没有现成工程的，用下面的方式新建。

以下两种做法任选其一

VS Code 插件
命令面板运行 KXBuild: 新建项目，模板选「Expo 应用」。
命令行
父目录用短路径，依赖目录很深。

> kxbuild project create -t expo_app -n expohello -o D:\work

第一次打开工程必须先做这一步。它会检查 Expo 环境，并生成、准备好 iOS 端的工程。

以下两种做法任选其一

体检之后在 ios 目录安装原生依赖，见 CocoaPods。

ios> pod install

JS 和 TypeScript 照常在 VS Code 中编写，保存后 Metro 自动刷新。ios/ 下的原生代码由 KXBuild 提供补全和跳转。

另开一个终端在工程目录运行 npx expo start，然后选中设备按 F5。原生断点在 VS Code 中调试，JS 断点用 Metro / Hermes 自己的调试器，两边互不影响。

用 Release 配置构建，JS 会打包进 App，ios 目录下生成 .ipa。上传到 App Store Connect 见发布与上架。

以下两种做法任选其一

构建与配置

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

发布与上架

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

没找到你的工程类型？

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