安装 Mac 计算机上的连接器

设备连接器是用于将设备连接到 OpenText Functional Testing Lab 的独立组件。 可以将连接器作为独立组件安装在 Mac 计算机上，并将其配置为连接到 OpenText Functional Testing Lab 服务器。设备连接到分布式连接器计算机将成为 OpenText Functional Testing Lab 设备实验室的一部分。

本节介绍如何在 Mac 计算机上安装连接器以测试 iOS 或 Android 手机。

有关如何查看所有连接器的详细信息，请参阅查看和管理连接器。

在本主题中:

开始之前

独立连接器可以作为完整安装进行安装，也可以作为对现有连接器安装的升级进行安装。

在安装或更新连接器之前，请检查计算机是否符合推荐的系统要求以及设备是否受支持。有关详细信息，请参阅、连接设备和安装和配置最佳实践中的支持矩阵连接器要求。

后退到顶部

iOS 17 及更高版本的注意事项

iOS 17 及更高版本的设备，如果计划直接接入到连接器计算机，需要考虑如下事项:

后退到顶部

先决条件

在安装连接器之前，请确保满足以下先决条件:

仅限新安装

1. 连接器应该可以访问服务器。去吧: http/s://<OpenText Functional Testing Lab 服务器 IP 地址 >:< 服务器端口 > ，并检查您是否可以访问 OpenText Functional Testing Lab。
2. 确保连接器计算机上的时区与 OpenText Functional Testing Lab 服务器的时区相匹配。
3. 从 OpenText Functional Testing Lab 服务器获取连接器的访问密钥。在连接器安装过程中，系统会提示您输入密钥。
   • 管理员用户:选择访问键选项卡。单击生成新建并提供名称、类型 (连接器)、到期日期、描述 (可选) 。然后，单击生成。
   • 非管理员用户:从管理员处请求一个用户。选择联系管理员 (位于“帮助”菜单的右上角) 。

后退到顶部

设置 Mac 电脑

1. 要使用现有用户安装连接器，该用户必须在主机组 1 中。要将现有用户添加到主机组 1，请运行以下命令:
   sudo dscl.- create/ 用户 /< userName > PrimaryGroupID 1
2. 以下是安装连接器的先决条件: OpenSSL 1.1.0h 或 LibreSSL 2.2.7。
3. 在装有 Apple Silicon 处理器的 Mac 计算机上安装连接器时，必须在计算机上安装 Apple Rosetta。Mac 计算机需要访问 Apple 更新服务才能安装此程序。

4. 下载 Mac 连接器通过以下方式之一:

• 管理员用户: 单击下载连接器 (位于 CONNECTORS 页中) 。
• 非管理员用户: 从实验室控制台右上角的帮助菜单中，选择下载│ 。
  
  macOS Catalina 及更高版本: 如果从 OpenText 官员 Web 站点将连接器直接下载到 Mac，请通过运行以下命令删除下载文件中的元数据:
  

终端: xattr -c fileName.zip

示例: xattr -c install-connector-macos-x64-X.XX-XXXXX.zip

5. 提取文件:
   终端: unzip <name of macOS connector installation file>.zip –d <target folder>
   
6. 移动连接器安装文件夹到应用程序文件夹。
   终端: cp –r desktop/<target folder> /Applications
7. 使用终端更改文件夹权限:
   1. 更改连接器安装文件夹和子文件夹的权限:

   sudo chmod-R 777/ 应用程序 /< 目标文件夹 >

   2. 更改安装期间用于临时文件的文件夹的权限 (默认: tmp):
      

   sudo chmod -R 777 /private/tmp

8. macOS Mojave 及更高版本: 验证安装程序是否具有完全磁盘权限:

   1. 打开系统首选项
   2. 在安全和隐私中，选择隐私选项卡
   3. 选择完全磁盘访问，然后单击锁定图标。使用系统管理员凭据的 TouchID 或输入，然后单击解锁。
   4. 单击 + 按钮并添加 OpenText Functional Testing Lab 安装应用程序。
      

后退到顶部

安装安装向导

1. 在 Applications 文件夹下，找到您的 Connector 文件夹，找到相应的安装文件 (.app 文件)。

2. 运行 the file as root or admin user.
   

注: 通过输入用户密码，接受尝试安装新帮助器工具的所有弹出窗口。

3. 此时将打开安装向导。阅读内容并单击下一页。

4. 按照以下指南填写信息或回答每个安装向导页面中的问题:

   身份验证
   输入您的凭据。对于 OpenText Functional Testing Lab，输入您的管理员提供的访问密钥。 OpenText Core Functional Testing Lab: 应选择启用 SSL 选项。
   如果通过代理连接，则在代理部分中选择服务器地址，并根据需要指定服务器、端口和凭据。
   连接器配置
   为连接器提供有意义的名称，因为这样可以根据连接器名称有效地筛选设备。输入连接器的 IP 地址或 FQDN，或接受默认值。

后退到顶部

安装与终端

1. 导航到以下文件夹:
   cd /Applications/<Connector installation folder>/install.app/Contents/MacOS

2. 运行 sudo./install。出现提示时按 Enter 和 Y /N 键，例如接受许可协议。

3. 按照以下指南填写信息或回答每个安装向导页面中的问题:

   身份验证
   输入您的凭据。对于 OpenText Functional Testing Lab，输入您的管理员提供的访问密钥。 OpenText Core Functional Testing Lab: 应选择“启用 SSL ”选项。
   如果通过代理连接，则在代理部分中选择服务器地址，并根据需要指定服务器、端口和凭据。
   连接器配置
   为连接器提供有意义的名称，因为这样可以根据连接器名称有效地筛选设备。输入连接器的 IP 地址或 FQDN，或接受默认值。

4. 有关如何在安装后更改配置的详细信息，请参阅重新配置 Mac 连接器。

后退到顶部

连接设备

1. 共同设计代理应用程序并将其分发到连接器计算机。有关详细信息，请参阅重新签名代理应用程序。如果 Mac 连接器正在运行，请重新启动它。
2. 通过执行以下步骤，设置 Mac 计算机以检测要连接到 OpenText Functional Testing Lab 的设备:
   

   设备 OS	详细信息
   iOS	macOS EL Capitan (10.11.6) - macOS Mojave (10.14.6): iTunes 12.8 或更高版本必需才能同步到 Mac 计算机 .检查您的 Mac 上是否有 iTunes 的更新版本。 对于 macOS Catalina (10.15) 及更高版本，只有 Finder 必需才能进行同步。 确保您的 iOS 设备受支持。有关详细信息，请参阅支持矩阵。 遵循步骤为初始设备配置
   Android	安装设备的 USB 驱动程序。每个设备制造商都有自己的 Mac USB 驱动程序。按照设备制造商的说明进行操作。有关原始设备制造商 (OEM) USB 驱动程序的链接列表，请参阅 Android 开发人员文档。 如果尚未执行此操作，请按照 Android 设备初始配置的步骤执行操作。

3. 使用 USB 端口将设备连接到计算机。
   

   在某些设备上，使用 USB 端口连接设备时，设备会发出安全警报。接受警告。

   提示: 某些电话的 USB 设置允许从充电连接单独启用数据连接。如果您的手机具有此选项，请检查设置以确保已启用 USB 数据连接。

   macOS EL Capitan (10.11.6) - macOS Mojave (10.14.6): 对于新安装的 macOS EL Capitan-Mojave，请确保在插入设备之前打开 iTunes。

4. 请等待，直到设备上运行代理。

5. (可选) 如果您已经安装了 Xcode，可以使用乐器命令查看计算机是否能识别 iOS 设备。

   器械 - s 设备

   此命令的结果应为设备 ID (UDID) 列表。如果连接到 USB 端口时未列出您的设备，这可能意味着:

   • USB 端口不工作 (硬件问题) 。
   • 您使用的不是最新版本的 iTunes。升级您的 iTunes 版本。

后退到顶部

开始或停止 Mac 连接器

当您运行安装时，默认情况下 Mac 连接器作为 Mac 服务进行安装。系统将提示您在安装结束时启动此服务。

如果您连接 iOS 17 设备，请注意，安装器接口中的启动选项不会完全启动所有相关过程。iOS 17 设备支持的所有进程都开启成功，执行以下命令启动服务。

sudo /Users/<user name used when installing the connector>/DL_service restart

如果您选择不在安装结束时启动服务，则可以稍后在终端中停止并启动连接器。

若要启动、重新启动或停止连接器，请执行下列操作:

在终端中，切换到 /opt/FunctionalTestingLabForMobileAndWeb/scripts 并执行以下命令。这些命令需要超级用户访问权限。

后退到顶部

重新配置 Mac 连接器

如果需要修改您的连接器详细信息，例如要更改服务器或连接器详细信息，可以重新配置连接器的设置，而无需重新安装。

要重新配置连接器，请执行以下操作:

双击计算机的 Applications >OpenText Functional Testing Lab Connector 文件夹下的 OpenText Functional Testing Lab_Update。

要从终端重新配置，请执行以下操作:

1. 将目录更改为安装文件夹。cd /opt/FunctionalTestingLabForMobileAndWeb/installation/
   
2. 运行升级脚本:
   ./DL_update.command

后退到顶部

Mac 连接器故障诊断

有关解决 Mac 连接器故障的提示和指南，请参阅 Mac 连接器。

后退到顶部

修补程序安装

要从最新的增强功能和修复中获益，请安装最新版本的修补程序。服务器和连接器补丁可从软件许可和下载下载。最新的修补程序包括以前任何修补程序的内容。无需安装以前的修补程序。

在将服务器升级到最新的修补程序时，还应该升级以下内容:

• 所有连接符。

• 手动签名工具 (如果适用)。
  

  • iOS 启用手动签署 iOS 应用程序。安装服务器修补程序后，可在代理文件夹中找到 iOS 启用程序。补丁可从 ADM Marketplace 获取。

  • Android 启用程序以手动签署 Android 应用程序。安装服务器修补程序后，服务器文件夹中提供了更新后的 Android Enabler。

按照修补程序发行说明中包含的修补程序安装说明进行操作。

后退到顶部

卸载 Mac 连接器

可以通过在 Mac OS 计算机上运行卸载程序或使用终端来删除用于 Mac 的连接器。卸载需要超级用户或管理员权限。

卸载连接器:

双击计算机的 Applications > OpenText Functional Testing Lab Connector 文件夹下的 FunctionalTestingLabForMobileAndWeb_Uninstall。

要使用终端卸载，请执行以下操作:

1. 将目录更改为安装文件夹。 cd /opt/FunctionalTestingLabForMobileAndWeb/installation/
   
2. 运行卸载脚本:
   ./DL_update.command
   

另请参阅:

• 管理设备
• 安装连接器在 Linux 计算机上
• 安装 Windows 计算机上的连接器