UniApp iOS 本地打包 -1.0

lemon_yyds
5 阅读4分钟

UniApp iOS 本地打包完整流程

本地打包（离线打包）是将 UniApp 项目通过 Xcode 编译生成 IPA 文件的方式，相比云打包更灵活，适合需要自定义原生功能或频繁打包的场景-2-7。

一、准备工作

在开始之前，需要准备以下环境和工具：

项目要求
Mac 电脑iOS 开发必须在 Mac 环境下进行，macOS 26 及以上 最新xcode 支持macos 26及其以上
Xcode从 App Store 下载最新版本 26版本
HBuilderX4.26 及以上版本-1
iOS 离线 SDK从 DCloud 官网下载，版本必须与 HBuilderX 一致-4-7
苹果开发者账号个人或公司账号（年费 99 美元）-2

二、申请证书和描述文件

这是本地打包最关键的步骤，需要准备 P12 证书（私钥证书）和 Profile 文件（描述文件）-3-8。

没有 Mac 电脑？  可以使用香蕉云编或 Appuploader 等在线工具完成证书申请-3-8-9。

证书申请流程：

  1. 登录苹果开发者中心（developer.apple.com）

  2. 创建 App ID：Bundle ID 需与 UniApp 项目的 appid 保持一致-3

  3. 生成 CSR 文件：Mac 用户使用"钥匙串访问"生成，Windows 用户使用香蕉云编生成-8

  4. 创建证书：选择 iOS Distribution 类型（同时支持 Ad Hoc 和 App Store）-8

  5. 下载 CER 文件并导出为 P12 格式（使用钥匙串访问或香蕉云编）-3

  6. 创建 Profile 描述文件：

    • 真机测试选择 Ad Hoc（需添加设备 UDID）
    • 上架发布选择 App Store-3

  7. 下载 Profile 文件并双击安装-2

三、HBuilderX 导出资源文件

  1. 打开 UniApp 项目，配置 manifest.json：

    • 设置应用名称、版本号
    • 配置 Bundle ID（需与 Apple 后台一致）-2

  2. 导出资源：

    text

    复制下载

    HBuilderX → 发行 → 原生App-本地打包 → 生成本地打包App资源 → 勾选iOS → 点击生成

    -1-5

  3. 导出成功后，资源文件位于：项目目录/unpackage/resources/-1

四、配置 Xcode 工程

  1. 导入离线 SDK：解压下载的 iOS 离线 SDK，双击 HBuilder-Hello.xcodeproj 打开-4-7

  2. 替换资源文件：

    • 将导出的资源文件夹（如 __UNI__xxxxxx）拷贝到 Xcode 项目的 Pandora/apps/ 目录下-4
    • 替换原有的同名文件夹

  3. 修改 control.xml：

    • 路径：Supporting Files/control.xml
    • 将 appid 改为与 manifest.json 一致-4

  4. 配置签名（Signing & Capabilities） ：

    • 选择 Team（登录 Apple ID）
    • Bundle Identifier 改为与 App ID 一致
    • 勾选 Automatically manage signing 或手动选择 Profile-7

  5. 配置 App Key：

    • 登录 DCloud 开发者后台，创建应用并申请 iOS 离线打包 Key
    • 在 Xcode 的 Info.plist 中配置 dcloud_appkey-7

  6. 其他配置：

    • Deployment Target：建议 12.0 及以上-1
    • Other Linker Flags：添加 -ObjC-1
    • 应用名称：修改 CFBundleDisplayName（注意 InfoPlist.strings 优先级更高）-4-7
    • 应用图标：在 Assets.xcassets 的 App Icon 中拖入各尺寸图标-4

五、编译打包

  1. 清理并编译：

    text

    复制下载

    Product → Clean Build Folder（Command + Shift + K）
Product → Build（Command + B）

    -7

  2. 选择目标设备：

    • 打包 IPA 需选择 Any iOS Device 或 Generic iOS Device（不要选模拟器）-4-7

  3. 归档 Archive：

    text

    复制下载

    Product → Archive

  4. 导出 IPA：

    • Archive 成功后打开 Organizer 窗口
    • 点击 Distribute App
    • 选择分发方式：Ad Hoc（测试）或 App Store Connect（上架）-2
    • 选择对应的 Profile 证书，点击 Export 保存 IPA-4

六、真机调试（可选）

如需在真机调试：

  1. 打开 iPhone 设置 → 隐私与安全性 → 开发者模式（iOS 16+ 需要）-7
  2. Xcode 中连接设备，选择对应真机运行
  3. 首次运行需在 设置 → 通用 → VPN与设备管理 中信任证书-7

七、常见问题与解决

问题解决方案
HBuilderX 与 SDK 版本不一致确保两者版本号完全相同-4
Profile 不包含当前设备Ad Hoc 包需先在开发者后台添加设备 UDID-4-8
appkey 配置错误检查 Info.plist 中的 dcloud_appkey 是否正确-7
找不到 PDRCore.hSDK 版本与 HBuilderX 不匹配-4
模拟器编译成功但真机失败确保 Build Settings 中 Build Active Architecture Only 设置为 NO

温馨提示：如果是首次打包，建议先用模拟器运行验证工程配置正确，再尝试真机调试和导出 IPA-7。正式发布前需要移除 control.xml 中的 debug="true" 配置-4-7

avatar
文章
阅读
粉丝