安装 Mac 计算机上的连接器

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

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

在本主题中:

开始之前

单独连接器为 Digital Lab 可以作为完整的安装或升级到现有连接器的安装。

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

關於 iOS 17 的評論

 在安装 Mac 连接器之前，需要考虑一些考虑。

后退到顶部

先决条件

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

仅限新安装

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

iOS 17-UFT Digital Lab 23.4 只有

在安装 iOS 17 的 Mac 连接器之前:

1. 请确保 MacOS 已升级到 13.4 或更高版本，并且已安装 Xcode 15.0 或更高版本。

2. 安装 iOS 17 运行时间与 Xcode。
   在 Xcode 菜单中 , 选择设置 > 平台 > iOS 17 > GET。

3. 在 Xcode 中登录到您的 Apple Developer 帐户。此帐户必须是用于注册 Digital Lab Agent-Runner 应用程序的相同帐户。详细信息请参阅管理应用程序中的代理应用程序。

4. 在 Xcode 设置 > 帐户中 , 选择 Apple 帐户 , 然后单击下载手动个人资料。

5. 如果您在 Mac 上有多个 Xcode 版本 , 请确保 Xcode15 是默认版本。

   在 Xcode 设置 > 位置 > 命令线工具中 , 选择 Xcode 15.

6. 启动至少 Xcode 一次以初始化所有相关数据。如果需要 , 请接受许可协议。

7. 按照下面的步骤设置 Mac 计算机并安装 Digital Lab。连接器必须与您当前的 Xcode 用户一起安装。此用户必须有管理员许可。

后退到顶部

设置 Mac 电脑

1. 要使用现有用户安装连接器，该用户必须在主机组 1 中。要将现有用户添加到主机组 1，请运行以下命令:
   sudo dscl.- create/ 用户 /< userName > PrimaryGroupID 1
2. 以下是安装连接器的先决条件: OpenSSL 1.1.0h 或 LibreSSL 2.2.7。

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

• 管理员用户: 单击下载连接器 (位于 CONNECTORS 页中) 。
• 非管理员用户: 选择下载连接器，位于 Digital Lab 控制台右上角的“帮助”菜单中。
  
  macOS Catalina 及更高版本: 如果 UFT Digital Lab 连接器软件从 OpenText 官方网站直接下载到您的 Mac, 请通过执行下列命令删除下载文件中的代数据:
  

终端: xattr -c fileName.zip

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

4. 提取文件:
   终端: 解压缩 < Mac OS X 连接器安装文件的名称 >.zip – d < 目标文件夹 >
   
5. 移动连接器安装文件夹到应用程序文件夹。
   终端: cp – r desktop/< 目标文件夹 >/ 应用程序
6. 使用终端更改文件夹权限:
   1. 更改连接器安装文件夹和子文件夹的权限:

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

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

   sudo chmod-R 777/private /tmp

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

   1. 打开系统首选项
   2. 在安全和隐私中，选择隐私选项卡
   3. 选择完全磁盘访问，然后单击锁定图标。使用系统管理员凭据的 TouchID 或输入，然后单击解锁。
   4. 单击 the + button and add the UFT Digital Lab install 应用程序 .
      
      

后退到顶部

安装安装向导

1. 在应用程序文件夹中，导航到连接器安装文件夹并找到安装文件 (. 应用程序文件) 。

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

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

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

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

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

5. UFT Digital Lab 23.4:
   安装连接器后，通过运行以下命令修改文件访问:
   

   Copy code

   sudo chmod 644 /usr/local/lib/*

   
   对于具有 Intel 芯片的 Mac 计算机，请执行以下额外命令:
   
   Copy code

   mkdir -p /usr/local/opt/pcre2/lib/
   cp /usr/local/lib/libpcre2-8.0.dylib /usr/local/opt/pcre2/lib/
   mkdir -p /usr/local/opt/openssl@3/lib/
   cp /usr/local/lib/libssl.3.dylib /usr/local/opt/openssl@3/lib/
   cp /usr/local/lib/libcrypto.3.dylib /usr/local/opt/openssl@3/lib/
   

   
   对于具有 Apple 硅芯片的 Mac 计算机，请执行以下额外命令:
   
   Copy code

   sudo chmod 644 /usr/local/opt/openssl@3/lib/*
   sudo chmod 644 /usr/local/opt/pcre2/lib/*
   

   有关 Apple 芯片组的更多详细信息，请参阅 Apple 文档中包含 Apple 硅片的 Mac 计算机。

6. 重新启动 Digital Lab 服务。
   

   UFT Digital Lab 版本 24.2 和 ValueEdge Digital Lab: 如果您连接 iOS 17 设备，请注意，安装器接口中的启动选项不会完全启动所有相关过程。在命令即时运行下列操作，以启动服务:

   Copy code

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

后退到顶部

安装与终端

1. 导航到以下文件夹:
   cd/ 应用程序 /< 连接器安装文件夹 >/install. 应用程序 /Contents/MacOS

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

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

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

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

5. UFT Digital Lab 23.4:
   安装连接器后，通过运行以下命令修改文件访问:
   

   Copy code

   sudo chmod 644 /usr/local/lib/*

   
   对于具有 Intel 芯片的 Mac 计算机，请执行以下额外命令:
   
   Copy code

   mkdir -p /usr/local/opt/pcre2/lib/
   cp /usr/local/lib/libpcre2-8.0.dylib /usr/local/opt/pcre2/lib/
   mkdir -p /usr/local/opt/openssl@3/lib/
   cp /usr/local/lib/libssl.3.dylib /usr/local/opt/openssl@3/lib/
   cp /usr/local/lib/libcrypto.3.dylib /usr/local/opt/openssl@3/lib/
   

   
   对于具有 Apple 硅芯片的 Mac 计算机，请执行以下额外命令:
   
   Copy code

   sudo chmod 644 /usr/local/opt/openssl@3/lib/*
   sudo chmod 644 /usr/local/opt/pcre2/lib/*
   

   有关 Apple 芯片组的更多详细信息，请参阅 Apple 文档中包含 Apple 硅片的 Mac 计算机。

6. 重新启动 Digital Lab 服务:

   Copy code

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

后退到顶部

连接设备

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

   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 服务进行安装。系统将提示您在安装结束时启动此服务。

UFT Digital Lab 版本 24.2 和 ValueEdge Digital Lab: 如果您连接 iOS 17 设备，请注意，安装器接口中的启动选项不会完全启动所有相关过程。在命令即时运行下列操作，以启动服务:

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

如果您选择在安装结束时不启动该服务，则可以稍后停止并启动该连接器，如下所示:

在终端中，将目录更改为 /opt/UFTDigitalLab/scripts 并运行:

后退到顶部

重新配置 Mac 连接器

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

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

双击 Digital Lab_Update 中的计算机的应用程序 > UFT Digital Lab 连接器文件夹。

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

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

后退到顶部

Mac 连接器故障诊断

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

后退到顶部

修补程序安装

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

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

• 所有连接器

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

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

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

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

后退到顶部

卸载 Mac 连接器

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

卸载连接器:

双击 Digital Lab_Uninstall in the 计算机的应用程序 > UFT Digital Lab 连接器 folder.

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

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

另请参阅:

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