Windows 上本地打包 uni-app iOS App

开发 uni-app 项目

在 HBuilderX 中照常新建和开发 uni-app 项目。再从 DCloud 的 iOS 离线 SDK 下载页下载与 HBuilderX 同版本的 SDK 并解压，下一步导出时要用。Vue 2 项目的 HBuilderX 不能装在带括号的目录（例如 Program Files (x86)），否则页面编译失败。

导出 Xcode 工程

把 uni-app 工程和 DCloud 离线 iOS SDK 导出成一个独立、可构建的 Xcode 工程，manifest.json 里勾选的模块会用 CocoaPods 装好。需要准备三个目录：uni-app 工程目录（包含 manifest.json）、离线 SDK 根目录和一个输出目录。完成后在 VS Code 中打开输出目录，之后和普通 Xcode 工程一样开发、按 F5 调试。

以下两种做法任选其一

• VS Code 插件

  命令面板运行 KXBuild: 导入 uni-app 项目，依次选择 uni-app 工程目录、SDK 根目录和输出目录，再填写 Bundle ID 和 DCloud App Key，留空则使用 uni-app 工程 nativeResources/ios/Info.plist 中的配置。导出在 VS Code 的终端中执行。

• 命令行

  参数说明见 uniapp2xcode 命令参考。

  > uniapp2xcode --project D:\work\myuniapp --sdk D:\sdk\HBuilder-iOS-SDK --output D:\work\myuniapp-ios --bundle-id com.example.myapp --dcloud-appkey 你的AppKey --clean

  复制

体检

检查并修好编译需要的环境。

以下两种做法任选其一

• VS Code 插件

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

• 命令行
  > kxbuild doctor .\myuniapp-ios\HBuilder-Hello\HBuilder-Hello.xcworkspace

  复制

编码

页面代码照常在 HBuilderX 中编写，改完要重新导出才会进入 iOS 工程。应用名称、版本、图标、权限描述在 HBuilderX 的 manifest.json 里设置，额外的 Info.plist 项写进 uni-app 工程的 nativeResources/ios/Info.plist，每次导出都会应用。

调试

USB 连接 iPhone，在 KXBuild 视图中选中设备，按 F5。原生层断点在 VS Code 中调试，页面 JS 用 HBuilderX 自带的调试工具，两边互不影响。

发布

用 Release 配置构建，输出目录的 HBuilder-Hello\build 下生成以应用名称命名的 .ipa。上传到 App Store Connect 见发布与上架。

以下两种做法任选其一

• VS Code 插件

  在 KXBuild 视图的「构建配置」节点切到 Release，命令面板运行 KXBuild: 构建。

• 命令行
  > kxbuild build .\myuniapp-ios\HBuilder-Hello\HBuilder-Hello.xcworkspace -s HBuilder -c Release

  复制