在 Mac 计算机上安装连接器

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

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

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

开始之前

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

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

返回到顶部

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

若要连接 iOS 17 和更高版本上运行的设备，需要通过 Internet 随时从 Apple 获取签名密钥。服务器计算机必须能够访问以下内容:

  • https://gs.apple.com
    OpenText 建议允许访问所有 *.apple 域名。

如果服务器计算机通过代理服务器访问互联网，请在管理设置中配置代理服务器详细信息。有关详细信息，请参阅管理设置中的代理设置 (Web 访问)在。

如果服务器计算机不允许访问互联网，请确保连接器可以访问 http://gs.apple.com。如果该连接器使用代理服务器，请在 <installation_dir>/connector or server/conf/ 下的 connector.properties 文件中配置以下代理服务器详细信息:

  • APPLE_HTTP_PROXY_HOST=<代理主机名>

  • APPLE_HTTP_PROXY_PORT=<代理端口号>

  • APPLE_HTTP_PROXY_USERNAME=<连接到代理服务器的用户名>

  • APPLE_HTTP_PROXY_PASSWORD=<用于连接到代理服务器的密码>

在配置代理服务器详细信息后连接器属性文件，重启连接器服务。

有关支持的操作系统以及应考虑的其他注意事项，请参阅支持矩阵。

返回到顶部

先决条件

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

仅限新安装

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

返回到顶部

设置 Mac 电脑

  1. 要使用现有用户安装连接器，该用户必须在主机组 1 中。要将现有用户添加到主机组 1，请运行以下命令:
    sudo dscl . -create /Users/<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 官方网站将连接器直接下载到 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. 更改连接器安装文件夹和子文件夹的权限:

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

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

      2. sudo chmod -R 777 /private/tmp

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

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

返回到顶部

安装安装向导

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

  2. 作为根用户或管理员用户来运行文件。

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

  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
    1. 确保您的 iOS 设备受支持。有关详细信息，请参阅支持矩阵。
    2. 按照以下步骤操作:初始设备配置
    Android

    如果尚未执行此操作，请按照 Android 设备初始配置的步骤执行操作。

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

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

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

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

警告: 为确保与 OpenText Functional Testing Lab 一起存储的信息的完整性和机密性，强烈建议您在安装文件夹和临时文件夹上合并文件系统监控。

  1. (可选) 如果您已安装 Xcode，则可以使用以下方法检查计算机是否识别 iOS 设备: xctrace 命令:

    xctrace 列出设备

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

    • USB 端口不工作 (硬件问题)。
    • 电缆状况不佳。

  2. 连接设备后，执行特定设备可能需要的任何其他配置。有关更多详细信息，请参阅已知设备问题。

返回到顶部

开始或停止 Mac 连接器

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

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

复制代码 
sudo /Users/<user name used when installing the connector>/FTLab_service restart

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

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

在终端中运行以下命令。这些命令需要超级用户访问权限。

操作

命令
启动连接器 sudo /Users/<user name used when installing the connector>/FTLab_service start
重新启动连接器 sudo /Users/<user name used when installing the connector>/FTLab_service restart

 
停止连接器 sudo /Users/<user name used when installing the connector>/FTLab_service stop

返回到顶部

重新配置 Mac 连接器

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

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

双击计算机的 Applications Functional Testing Lab for Mobile and Web Connector 文件夹中的“修改配置”。

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

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

返回到顶部

Mac 连接器故障诊断

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

返回到顶部

卸载 Mac 连接器

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

卸载连接器:

双击计算机的 Applications > Functional Testing Lab for Mobile and Web Connector 文件夹中的卸载 Functional Testing Lab for Mobile and Web 。

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

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

返回到顶部

更新

有时，会发布包含增强功能和修补程序的更新。

产品 详细信息
OpenText Functional Testing Lab

要从最新的增强功能和修复中获益，请安装最新版本的修补程序。可从软件许可和下载下载服务器修补程序。最新的修补程序包括以前任何修补程序的内容。无需安装以前的修补程序。按照修补程序发行说明中包含的修补程序安装说明进行操作。

重要信息: 如果使用远程 iOS 签名服务，则应在升级服务器之前升级此服务。

将服务器升级到最新修补程序时，还必须升级以下内容:

  • 所有连接符。OpenText 建议启用连接器的自动更新设置。这样，便无需在安装服务器更新时手动更新连接器。有关详细信息，请参阅“管理设置”中的常规。

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

    • iOS 启用手动签署 iOS 应用程序。iOS enabler 将在代理文件夹或 ADM Marketplace 中提供。

    • Android 启用程序以手动签署 Android 应用程序。在安装完服务器修补程序后，可以在服务器文件夹或 ADM Marketplace 找到更新的 Android 启用程序。
OpenText Core SDP

当 OpenText 更新部署到服务的时候，Connector 也需要升级。OpenText 建议启用连接器的自动更新设置。有关详细信息，请参阅管理设置。

备注: 如果使用 iOS 或 Android Enabler 进行手动应用程序签署，更新服务器时需要升级它们。您可以从 ADM Marketplace 下载最新版本。

另请参阅: