安装 Mac 计算机上的连接器

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

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

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

开始之前

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

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

后退到顶部

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

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

千万
OpenText 建议允许访问所有 *.apple 域名。

如果服务器计算机通过代理服务器访问 Internet，请在“管理”设置中配置代理服务器详细信息。有关详细信息，请参阅管理设置中的代理设置。

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

APPLE_HTTP_PROXY_HOST=<代理主机名>
APPLE_HTTP_PROXY_PORT=<代理端口号>
APPLE_HTTP_PROXY_USERNAME=<连接到代理服务器的用户名>
APPLE_HTTP_PROXY_PASSWORD=<用于连接到代理服务器的密码>

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

后退到顶部

先决条件

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

仅限新安装

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

后退到顶部

设置 Mac 电脑

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

管理员用户: 单击下载连接器 (位于 CONNECTORS 页中)。
非管理员用户: 从实验室控制台右上角的帮助菜单中，选择下载连接器。

macOS Catalina 及更高版本: 如果从 OpenText 官方网站将连接器直接下载到 Mac，请通过运行以下命令删除下载文件中的元数据:

终端: xattr -c fileName.zip

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

提取文件:
终端: unzip <name of macOS connector installation file>.zip –d <target folder>
移动连接器安装文件夹到应用程序文件夹。
终端: cp –r desktop/<target folder> /Applications
使用终端更改文件夹权限:
1. 更改连接器安装文件夹和子文件夹的权限:
1. 更改安装期间用于临时文件的文件夹的权限 (默认: tmp):
macOS Mojave 及更高版本: 验证安装程序是否具有完全磁盘权限:
1. 打开系统首选项
2. 在安全和隐私中，选择隐私选项卡
3. 选择完全磁盘访问，然后单击锁定图标。使用系统管理员凭据的 TouchID 或输入，然后单击解锁。
4. 点击 + 按钮，安装 OpenText Functional Testing Lab。

后退到顶部

安装安装向导

在 Applications 文件夹下，找到您的 Connector 文件夹，找到相应的安装文件 (.app 文件)。
作为根用户或管理员用户来运行文件。

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

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

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

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

后退到顶部

安装与终端

导航到以下文件夹:
cd /Applications/<Connector installation folder>/install.app/Contents/MacOS
运行 sudo./install。出现提示时按 Enter 和 Y /N 键，例如接受许可协议。

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

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

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

后退到顶部

连接设备

共同设计代理应用程序并将其分发到连接器计算机。有关详细信息，请参阅重新签名代理应用程序。如果 Mac 连接器正在运行，请重新启动它。

通过执行以下步骤，设置 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 设备初始配置的步骤执行操作。

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

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

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

macOS EL Capitan (10.11.6) - macOS Mojave (10.14.6): 对于新安装的 macOS EL Capitan-Mojave，请确保在插入设备之前打开 iTunes。
请等待，直到设备上运行代理。

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

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

instruments -s devices

此命令的结果应为设备 ID (UDID) 列表。如果连接到 USB 端口时未列出您的设备，这可能意味着:
- USB 端口不工作 (硬件问题)。
- 您使用的不是最新版本的 iTunes。升级您的 iTunes 版本。
连接设备后，执行特定设备可能需要的任何其他配置。有关更多详细信息，请参阅已知设备问题。

后退到顶部

开始或停止 Mac 连接器

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

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

Copy code

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

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

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

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

操作	命令
启动连接器	`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 文件夹中的“修改配置”。

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

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

后退到顶部

Mac 连接器故障诊断

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

后退到顶部

卸载 Mac 连接器

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

注: 如果使用终端 (PuTTY) 安装了连接器，则只能使用终端将其卸载。

卸载连接器:

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

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

将目录更改为连接器安装文件夹。cd/opt /FunctionalTestingLabForMobileAndWeb /installation /
运行卸载脚本:
./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 下载最新版本。

产品

详细信息

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 下载最新版本。

另请参阅: