包 aniOS 应用程序手动使用 iOS 启用程序

iOSEnabler 实用程序用于简化和支持应用程序的重新签名和重新打包。iOSEnabler 在 GUI 和命令行版本中都可用。

先决条件

确保您的 Mac 电脑满足所需的系统要求。有关详细信息，请参阅支持矩阵。

  1. 在终端窗口中，键入codesign
    应显示协同设计的用法。
  2. 如果缺少 codesign 命令， Xcode 将无法正确安装，您应该重新安装它。

所需的其他资源

复制以下资源到您的 Mac 计算机:

資源 详细信息
iOS 启用程序

Enabler 位于 Digital Lab 服务器计算机上的代理目录中:
Linux:
< 服务器安装文件夹的路径 >/server/Agent

Windows:
< 服务器安装文件夹的路径 > \server\Agent

也可以从 ADM Marketplace 下载它。

iOSEnabler 工具在 GUI 和命令行版本中都可用。
代理应用程序 (仅当使用 iOSEnabler 对代理应用程序进行签名时)

从 Apps > iOS Agent Apps 在 Digital Lab 控制台下载 Agent 应用程序 (仅管理用户)。

ValueEdgeDigital Lab: Locate 连接器的代理文件夹中的代理应用程序。
UFT Mobile dylib 此库使应用程序能够与 Digital Lab 一起使用。该库包含在 iOS Enabler 包，可以从 ADM Marketplace下载。它还可以在 Digital Lab 服务器计算机上的以下位置中找到:
Linux:<Digital Lab_server_installdir>/server/Agent

Windows: <Digital Lab_server_installdir>\server\代理
代码签名证书

这是您的组织用于代码签名应用程序的证书。证书必须安装在您正在使用的 Mac 计算机上，并且可以在 Keychain Access 程序中看到。有关所需证书的更多详细信息，请参阅 iOS 应用程序签名。
代码签名预配配置文件 这是您的组织用于对应用程序进行代码签名的移动调配配置文件。这最初是从 Apple 开发人员成员网站下载的文件，并安装在您的 Mac 上。有关如何生成置备配置文件的详细信息，请参阅生成开发预置描述文件。

后退到顶部

iOS 启用程序在 Mac - GUI 版本

GUI 版本的 iOSEnabler 允许您使用图形界面，以准确、简单的方式输入必需的值。

要使用 GUIiOSEnabler 重新签名或重新打包应用程序，请执行以下操作:

  1. 将文件从下载的 Enabler.zip 软件包提取到 Mac 计算机上。

  2. 打开 iOSEnabler-GUI.app: 按住 Ctrl 键并单击或右键单击应用程序，然后从关联菜单中选择打开。

    备注: GUI 版本的启用程序不是通过 Mac 应用程序 Store 分发的。如果尝试通过应用程序 Store 安装它，它将发出安全警告，指示无法打开应用程序，因为它来自无法识别的开发者。而应使用上述方法。

  3. 填写 iOSEnabler 中的字段。

    用户接口元素如下所述:

    UI 元素 描述
    Agent/L-AUT
    启用程序模式:
    代理 /L 模式。用于对代理应用程序进行代码签名
    AUT 模式。用于签名和打包应用程序
    原始 IPA
    要重新签名的原始 ipa 文件的完整路径。例如，如果您要重新签名代理应用程序，请输入 /<full_path>/Agent.ipa
    Digital Lab Dylib

    仅在 AUT 模式下。要注入的库，可使应用程序与 Digital Lab 一起使用。该库包含在 iOSEnabler.zip 文件中。它还可以在 Digital Lab 服务器计算机上的 Agent 目录中找到。
    目的地
    目标生成的文件在您的 Mac 计算机上。
    预配概要文件
    Mac 计算机上的预配配置文件的路径。
    证书名称

    从钥匙串中安装的证书的下拉列表。选择列表中的证书，或单击建议以获取推荐的证书。如果未列出该证书，则说明该证书未正确安装在此 Mac 计算机上。

    备注: iOS 启用程序不检查证书的有效性，因此必须确保其有效。
    详细
    如果代理未正确启用，则在文本区域中显示警告和错误消息。

    提示: 要保留现有权利，请确保配置配置文件字段为空，并且在证书名称字段中使用与原始 IP 相同的证书名称。

  4. 单击运行。这将生成使用代码签名证书和预配配置文件定制的其他 ipa 文件。

  5. 将创建一个新的 ipa 文件:
    代理应用程序: 转到分发重新签名的代理应用程序 (仅限手动签名)
    其他应用程序: 上载新的 ipa 到 Digital Lab 。

    注: 每当您上载新的或修改的 ipa 文件时，由于添加或更改 iOS 设备，请确保拔下设备并再次插入。

  1. 确保您已准备了 Apple 开发证书和预配配置文件。有关更多详细信息，请参阅 iOS 用于签署应用程序的资源。
  2. 下载 iOSEnabler 应用程序代码注入程序工具，可用于 ADM Marketplace或 Digital Lab 服务器计算机上的代理目录中的版本。

  3. 复制文件夹到 Mac 计算机上，然后双击该应用程序文件。如果出现系统警告，请导航到 System Preference > Security|Privacy > 常规并单击打开任意，以允许来自标识的开发者的应用程序运行。

    Open an app that was blocked fom opening because the identity of the developer cannot be confirmed.

  4. 要使用开发证书重新签署 Agent 应用程序，请选择 Agent/L 选项卡。

    iOS Enabler Agent/L tab selected

    输入以下信息:

    1. 原始 IPA。输入原始 .ipa 文件的完整路径，例如 /<full_path>/Agent.ipa。
    2. 目标。为 Mac 计算机上的代码签名文件指定目标。
    3. 预配概要文件。浏览下载到 Mac 计算机上的预配配置文件的位置。
    4. 证书名称。选择开发证书，从下拉列表中的“ iPhone 开发人员”开始。
  5. 在设置中，选择详细以在未正确启用代理的情况下在文本区域中显示警告和错误消息。

  6. 单击运行。观察重新签名的进度。如果存在任何弹出窗口，请单击允许。

    重新签名的代理文件将生成为 Agent-Codefined.ipa .

  7. 重复上述步骤以重新签署 Digital Lab Runner 应用程序 (WebDriverAgentRunner_less15 .ipa 和 WebDriverAgentRunner .ipa)

  8. 重命名通过从文件名中删除 - 已设计来生成文件。例如，应将代理文件从 Agent-Codesigner.ipa 重命名为 Agent.ipa .

  9. 上载应用程序到 Digital Lab。

  10. 导航到设备实验室 > 连接器，在网格中选择所需的连接器，然后单击分发代理 。将更新后的代理应用程序分发到连接器后，从网格中选择相关的连接器，然后单击重新连接设备。有关详细信息，请参阅查看和管理连接器。
    备注，即使在应用程序卡中选择了代理应用程序的早期上载，也始终使用最新上载分发到连接器。

后退到顶部

iOS 启用程序在 Mac - 命令行版本

使用 iOSEnabler 的命令行版本，您可以使用终端命令行对应用程序进行重新签名和重新打包。

从终端命令行运行 Enabler 时，请使用以下语法。

$ <path> /iOS Enabler <path> /<original_ipa>.ipa [<options>]

命令行选项:

选项 详细信息
- inject

将动态库注入应用程序。提供 UFT Mobile dylib 的完整路径。
- codesign

使用证书共同设计应用程序。这是您的组织用于代码签名应用程序的证书。证书必须安装在您正在使用的 Mac 计算机上，并且可以在 OSX Keychain Access 程序中看到。

使用证书的全名，如钥匙串所示。

有关所需证书的更多详细信息，请参阅 iOS 应用程序签名。
- p 将移动预配配置文件附加到应用程序。提供 Mac 计算机上的预配配置文件的路径。
- e 权利文件。
- r 资源规则列表。自定义资源规则文件。
-- original-res-rules 使用原始 APIResourceRules.plist 中的 Resources rules 文件。
-- generic-res-rules 应用常规资源规则定义。如果由于资源问题导致协同设计失败，请尝试此选项。将使用通用模板。
-- force-res-rules 运行启用程序，就像设置了-- original-res-rules 选项一样。如果未找到原始规则，它将运行启用程序，就像使用了-- generic-res-rules 选项一样。
-- no-url-scheme 不要在信息 .plist 中添加唯一的 URL 方案。预留者默认值，已添加。方案的格式为 hpmc- (a 32char uid)
-- verify-agent 如果代理未正确启用，则发出警告。
- d 目标文件夹 放置新 .ipa 文件的文件夹的可选路径。文件夹必须存在。
- n 新文件名 新 .ipa 文件的可选名称。
- v verbose
- V 打印版本
- h 打印用法

运行启用器后，将创建一个新的 ipa 文件。

注: 每当您上载新的或修改的 ipa 文件时，由于添加或更改 iOS 设备，请确保拔下设备并再次插入。

以下示例显示了 Enabler 命令行工具的一些常见用法。

  • 重新签署代理应用程序

    <iOS Enabler> <path> /Agent.ipa – codesign <certificate_name>-p <path to mobile.provision> -- verify-agent

  • 重新签署 WebDriverAgentRunner .ipa

    $ <path to iOS Enabler> <path>/WebDriverAgentRunner.ipa – codesign <certificate_name> -p <path to mobile.provision>

  • 重新签名 WebDriverAgentRunner_less15.ipa

    $ <path to iOS Enabler> <path>/WebDriverAgentRunner_less15.ipa – codesign <certificate_name> -p <path to mobile.provision>

  • 重新打包应用程序

    $ <path to iOS Enabler> <path to your_app.ipa>-inject <path to UFT Mobile dylib>-codesign <certificate name>-p <path to mobile.provision>-d <destination_folder>


后退到顶部

分发重新签名的代理应用程序 (仅限手动签名)

重新签名代理应用程序后，请按以下方式部署它们:

  1. 重命名通过从文件名中删除 - 已设计来生成文件。例如，应将代理文件从 Agent-Codesigner.ipa 重命名为 Agent.ipa .

  2. 上载应用程序到 Digital Lab。

  3. 导航到设备实验室 > 连接器，在网格中选择所需的连接器，然后单击分发代理 。将更新后的代理应用程序分发到连接器后，从网格中选择相关的连接器，然后单击重新连接设备。有关详细信息，请参阅查看和管理连接器。
    备注，即使在应用程序卡中选择了代理应用程序的早期上载，也始终使用最新上载分发到连接器。

    备注: 如果代理未在设备上安装或运行，则很可能是代码签名证书或设置配置文件有问题。确保:

    • “ get-task-allow ”权限设置为 true。
    • 您设备的所有 UDID 都包含在列表中。

    后退到顶部

    另请参阅: