iOS 离线打包 SDK

lemon_yyds
4 阅读6分钟

Pandora/apps/ 这个目录并不是凭空产生的，它是你下载的 iOS 离线打包 SDK 中自带的项目模板目录。

简单来说，Pandora/apps/ 的完整路径结构如下：

text

复制下载

你解压的SDK文件夹
└── HBuilder-Hello (demo工程文件夹)
    └── HBuilder-Hello.xcodeproj (Xcode工程文件)
    └── HBuilder-Hello (源码主目录)
        └── Pandora (核心资源目录，以蓝色文件夹形式存在)
            └── apps (你的应用资源存放处)
                └── __UNI__XXXXXX (默认的示例项目，需要被替换)

这个目录的出现，遵循以下步骤：

1. 下载官方 SDK

你需要从 DCloud 官网（nativesupport.dcloud.net.cn/AppDocs/download/ios.html）下载 iOS 离线打包 SDK-3。

2. 解压并找到模板工程

解压下载的 SDK 文件后，你会在文件夹中看到一个名为 HBuilder-Hello 的文件夹。这就是 DCloud 官方提供的原生工程模板-1-2-10。

3. 用 Xcode 打开模板

打开 HBuilder-Hello 文件夹，双击里面的 HBuilder-Hello.xcodeproj 文件，即可在 Xcode 中打开这个完整的原生项目-4-8。此时，Pandora/apps/ 目录就已经存在于这个 Xcode 项目的文件导航器中。

需要注意的细节

  • 特殊文件夹：在 Xcode 中，Pandora 文件夹通常显示为蓝色。这是一种 "Folder Reference"（文件夹引用）类型-9。这意味着 Xcode 只是引用了这个文件夹的位置，所以你可以放心地在 Finder 中直接对它进行操作。

  • 替换你自己的项目资源：

    1. 在 HBuilderX 中通过“发行” -> “原生App-本地打包”生成属于你的应用资源文件夹（通常以 __UNI__ 开头）-1-3-10。
    2. 在 Finder（访达）  中，进入 .../HBuilder-Hello/HBuilder-Hello/Pandora/apps/ 目录。
    3. 删除该目录下原有的 __UNI__ 开头的示例文件夹，然后将你在 HBuilderX 中生成的新 __UNI__ 文件夹完整地复制进来-2-6。

完成替换后，回到 Xcode，新内容就会出现在项目导航器中了。

提示：由于 Pandora 是文件夹引用，如果替换资源后运行应用发现代码没有更新，通常需要在模拟器或真机上先删除旧应用，再重新运行，这样就能加载最新的资源了[-4]

在 Mac 上双击安装 .mobileprovision 文件（即描述文件/Profile）后，这个文件本身的数字内容会被导入并存储在你的 Mac 系统中，让 Xcode 在编译和签名应用时能够找到并使用它。

这个过程是“安装”而不是“运行应用”，所以你不会看到任何程序窗口打开。它的安装结果主要体现在以下两个层面：

1. 对系统：文件被存储到指定位置

无论你是否能看到明显的安装成功提示，这个文件都会被操作系统复制并存储到一个专用的文件夹中，以便开发工具（主要是 Xcode）随时调用-8。

  • 存储路径：~/Library/MobileDevice/Provisioning Profiles/
  • 文件名的变化：这是双击安装时最容易忽略的一点。当你双击安装时，系统会使用该文件的SHA1哈希值作为新文件名进行存储-8。也就是说，你在那个文件夹里看到一个名字像 9f8a3b2c... 的随机字符串文件，它就是刚才安装的那个描述文件-1-4。这种命名方式虽然对系统来说更高效，但对开发者而言，无法直接从文件名看出它对应哪个应用。

2. 对开发工具：Xcode 能自动识别并使用

安装的关键目的是让 Xcode 能识别这个描述文件。一旦安装成功，Xcode 就能在需要时自动调用它来完成代码签名。

  • 自动匹配：当你用 Xcode 打开一个项目，并在项目的 “Signing & Capabilities” 中配置了对应的 Bundle Identifier 后，Xcode 会自动在所有已安装的描述文件中筛选出匹配的那个。
  • 查看方式：你也可以在 Xcode 中手动查看。打开 Xcode，进入菜单栏的 Window -> Devices and Simulators，在左侧栏选中你的 Mac 电脑，你就能在下方看到已安装的所有描述文件列表-4。

💡 重要延伸：描述文件与真机测试的关系

你安装的 Profile 文件是实现真机测试或分发的关键桥梁-9，它的作用是为你的应用授予在特定设备上运行的权限。

  • 开发/Ad Hoc 类型：请务必确认，你安装的描述文件中包含了你用来测试的那台 iPhone 或 iPad 的 UDID。否则，即使安装了这个文件，你的应用也无法在那台设备上启动-1-9。
  • 企业/App Store 类型：这类描述文件不绑定具体设备，主要用于正式发布或企业内部大规模分发-2-4。

🗂️ 补充：描述文件 vs. 配置描述文件

这里有一个容易混淆的概念需要区分一下。我们这里讨论的 .mobileprovision 文件，是专供开发者（使用 Xcode）  打包和调试 App 用的。

而苹果官方文档中常提到的“配置描述文件”（通常是 .mobileconfig 格式），其安装和使用场景则完全不同-3-6：

  • 用途：用于给手机配置网络、邮箱、VPN 等系统级设置，而非用于开发打包。
  • 安装位置：不是在 Mac 上，而是在 iPhone 的 设置 -> 通用 -> VPN 与设备管理 中进行安装-7。

💎 开发者的一个小建议

虽然双击安装是最便捷的方式，但很多有经验的开发者会采用另一种方法：直接将下载的 .mobileprovision 文件拖拽到 Xcode 的图标上，或拖拽到 iTunes 中-8。  这样做的好处是，文件在存储到 Provisioning Profiles/ 文件夹时，会保留其原始的文件名（如 MyApp_Ad_Hoc_Profile.mobileprovision），方便你日后在文件夹里进行识别和管理，而不是看到一串无意义的哈希值。

control.xml：这个文件在哪里找 control.xml 文件位于你之前下载的 iOS 离线打包 SDK 工程中。要找到它，请按以下路径在 Finder（访达）中查找：

text

复制下载

你解压SDK的文件夹/HBuilder-Hello/HBuilder-Hello/control.xml

🗺️ 更详细的路径指引

  1. 找到你下载的 SDK 文件夹：找到你之前下载并解压的 iOS 离线打包 SDK 文件夹。
  2. 进入模板工程目录：依次打开 HBuilder-Hello -> HBuilder-Hello 文件夹。
  3. 找到目标文件：在这个文件夹里，你就能看到 control.xml 文件了-9。

它和 Pandora 文件夹、PandoraApi.bundle 文件在同一级目录下-9。

✏️ 找到后如何配置

找到文件后，你需要用代码编辑器（如 VS Code）打开它，并修改两个关键配置-4-5-10：

  • 修改 appid：将 appid 属性值，改为你项目的 AppID（即 manifest.json 中的 id 字段）。
  • （可选）开启调试模式：如果需要调试，可以在 <HBuilder> 标签中添加 debug="true" 和 syncDebug="true" 这两个属性。特别提醒，等要打包发布到 App Store 时，记得把这两个属性删掉-7-8。

xml

复制下载运行

<?xml version="1.0" encoding="utf-8"?>
<!-- appid 需与manifest.json中的id完全一致 -->
<HBuilder debug="true" syncDebug="true" version="...">
    <apps>
        <app appid="你的AppID" appver="1.0.0"/>
    </apps>
</HBuilder>

配置好并保存后，还需要确保 Pandora/apps/ 下的文件夹名称和这里的 appid 保持一致，这样 App 才能正确启动-4。

avatar
文章
阅读
粉丝