安装 Windows 计算机上的连接器

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

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

开始之前

Digital Lab 的单机版连接器可以作为完全安装进行安装，也可以作为 Digital Lab (UFT Mobile) 3.0 或更高版本的现有连接器安装升级。

启动之前，请确保满足以下先决条件:

连接器要求

检查您的计算机是否符合建议的系统要求以及您的设备是否受支持。有关详细信息，请参阅、连接设备到 Digital Lab 和安装和配置最佳实践中的支持矩阵连接器要求。
仅限 Windows 11 内部版本 22572 和更高版本

安装 WMI 命令行 (WMIC) 实用程序。

  1. 打开设置，方法是同时按 Windows + I 键。

  2. 单击应用程序。

  3. 单击可选特征。

  4. 单击功能显示按钮。

  5. 搜索 Wmic。选择旁边的复选框，然后按下一步。

  6. 单击安装。
仅限新安装
  1. 连接器应该可以访问服务器。导航到: http/s://<Digital Lab 服务器 IP 地址 >:< 服务器端口 > ，并检查您是否可以访问 Digital Lab。
  2. 确保计算机上尚未安装 Digital Lab 服务器。

后退到顶部

安装连接器

安装连接器之前，请确保计算机满足连接器要求。

要安装连接器，请执行以下操作:

  1. 从 Digital Lab 服务器获取连接器的访问密钥。

    • 管理员用户:选择访问键选项卡。单击生成新建并提供名称、类型 (连接器)、到期日期、描述 (可选) 。然后，单击生成。
    • 非管理员用户:从管理员处请求一个用户。选择联系管理员 (位于“帮助”菜单的右上角) 。

    有关访问密钥的更多详细信息，请参阅访问密钥管理.

  2. 下载连接器。

    • 对于管理员，选择下载连接器位于 CONNECTORS 页中。下载相应的连接器。
    • 对于非管理员用户，从 Digital Lab 控制台右上角的“帮助”菜单中选择下载连接器。下载相应的连接器。

  3. 将连接器安装文件的内容提取到计算机上的某个文件夹中。找到 .exe 文件。

  4. 双击 .exe 文件以打开安装向导。阅读内容并单击下一页。

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

    身份验证

    输入您的凭据。输入由您的管理员提供的访问密钥。

    Digital Lab SaaS: 应选择启用 SSL 选项。
    如果通过代理连接，则在代理部分中选择服务器地址，并根据需要指定服务器、端口和凭据。
    连接器配置
    为连接器提供有意义的名称，因为这样可以根据连接器名称有效地筛选设备。输入连接器的 IP 地址 (如果 IP 是静态的) 或 FQDN，或者接受默认值。

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

警告: 为确保与 Digital Lab 一起存储的信息的完整性和机密性，强烈建议您在安装文件夹和临时文件夹中包含文件系统监视。

后退到顶部

准备设备

通过执行以下步骤，将 Windows 计算机设置为检测要连接到 Digital Lab 的设备:

iOS 设备

  1. 确保在您的电脑上安装了 iTunes，以便设备在您的 Windows 计算机 .有关详细信息，请参阅 Apple 文档。

    注: 对于 iOS 15 和更高版本，需要 iTunes 12.11 和更高版本。

  2. 如果尚未执行此操作，请按照步骤设置 iOS 设备。

Android 设备

  1. 下载设备的 USB 驱动程序。有关原始设备制造商 (OEM) USB 驱动程序的链接列表，请参阅 Android 开发人员文档。或者，在 Web 上搜索 Windows 的 USB 驱动程序，查找您的设备。

    对于 Google Nexus 设备，请下载 Google USB 驱动程序。有关详细信息，请参阅 AndroidDevelopers 文档。

  2. 提取下载的驱动程序归档文件的内容。

  3. 将设备连接到您的计算机，并按 Windows 版本安装驱动程序，如 Android Developers 文档中的安装 OEM USB 驱动程序所述。

    注: 当您通过 USB 端口连接设备时，安全消息可能会要求您允许 USB 调试或信任连接的计算机。接受警告。

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

后退到顶部

连接设备并验证连接

  1. 通过 USB 电缆将设备连接到计算机。接受连接设备时可能显示的所有通知、信任或位置弹出窗口。
  2. 当连接器正在运行时，下列项目将自动安装在插入连接器计算机的设备上:
    • 远程查看器服务
    • 代理应用程序

      在与设备交互之前，请等待代理运行。如果代理崩溃，请尝试拔出设备，然后再次将其插入。有关其他故障排除信息，请参阅 Windows 连接器疑难解答。

      提示: 如果拔出设备，请在重新连接之前等待 5 秒，以使系统稳定。

  1. 如果在连接设备后代理应用程序未启动，请检查设备是否可以识别:

    导航复制到< Windows 连接器 folder >\android-sdk-windows\platform-tools文件夹，然后在命令提示符下运行 adb。

    adb 设备

    全部连接的设备应列出。

    • 如果设备列为未经授权，请检查设备并接受任何安全弹出窗口。

    • 如果未列出您的设备，或者未列出任何设备，请检查以下内容:

      • 硬件问题。USB 端口可能不工作。

      • Windows 驱动程序的安装不正确。选择驱动程序 inf 文件，然后从右键菜单中选择安装。
      • Android 设备的驱动程序不正确。检查 AndroidDevelopers 文档中的 OEM USB 驱动程序列表，查看是否具有最新版本的驱动程序。

    1. 打开命令提示窗口
    2. 导航到 <Windows 连接器文件夹 >\libimobiledevice\win 文件夹
    3. 运行 idevice_id 命令:

    idevice _ id – l

    此命令的结果应为设备 ID (UDID) 列表。

    如果在设备连接到 USB 端口时没有列出任何设备，请检查以下各项:

    • 硬件问题。USB 端口可能不工作。

    • iTunes 的版本不正确。检查您使用的是最新版本的 iTunes。
    • 未启用 UI 自动化。对于具有开发人员签名代理应用程序的 iOS.x 及更高版本，在设置 > 开发人员 > 启用 UI 自动化中启用 UI 自动化。断开连接设备，等待 5 秒，然后重新连接它。

iOS 设备的其他注意事项

首次安装应用程序时，系统将提示安装使用企业证书 (不使用移动设备管理 (MDM) 解决方案) 签名的应用程序的个用户信任企业开发人员。要信任配置文件，请转到设置 > 常规 > 设备管理，选择企业开发人员配置文件并信任它。可以在设备上远程执行这些操作。

首次安装您的企业签名应用程序的所有用户也需要 Internet 连接。在设备上信任 Enterprise developer 配置文件后，如果打开相同配置文件的设备连接到 Internet，则不需要再次信任具有相同配置文件的其他应用程序。如果接受测试的应用程序的企业开发人员配置文件不受信任，代理将无法打开应用程序并发出 20444 错误 "。

后退到顶部

开始，停止并重新启动连接器

安装完成后，安装程序将提示您启动连接器服务。

如果选择在安装连接器服务后不启动该服务，则可以从“服务”控制台或直接从计算机的开始菜单执行手动开始、停止和重新启动:

  • 开始 > Digital Lab 连接器 > 开始Digital Lab服务
  • 开始 > Digital Lab 连接器 > 停止Digital Lab服务
  • 开始 > Digital Lab 连接器 > 重新启动Digital Lab服务

后退到顶部

修改连接符

如果需要修改您的连接器详细信息 (例如，要更改服务器或connector 端口) ，可以使用修改配置工具对其进行修改。

要访问此工具，请选择开始 > Digital Lab 连接器 > 修改配置。此时将打开配置向导。

运行时，向导将停止连接器服务。向导的最后一页会提示您再次启动该服务。

使用使用 SSL 的服务器时，如果更改了服务器详细信息，则不需要重新安装连接器。使用修改配置工具更新连接器详细信息。测试工具用户还需要重新配置其对 Digital Lab. 的 SSL 访问有关详细信息，请参阅 SSL 和证书。

注: 使用 CA 证书连接到使用 SSL 的 Digital Lab 服务器的连接器不支持修改配置实用程序。如果要在将 CA 证书导入连接器后修改与服务器的连接，请删除现有的连接器，然后重新安装它。

后退到顶部

启用本地化

要以英语以外的受支持语言显示系统应用程序 (应用程序，用于运行设备本身) ，请在安装连接器之后，导航到 < Windows 连接器文件夹的路径 >\conf\connector.properties 并取消注释文件中的以下行:
ENABLE _ LOCALIZATION = true

后退到顶部

Windows 连接器疑难解答

本节提供了一些使连接器正常工作的提示和准则。

如果 Windows 连接器已成功启动，但在 Digital Lab 控制台中看不到设备:

  • 验证您的计算机是否可以检测到您的设备。
  • 检查位于 < Windows 连接器文件夹 >\connector\log 文件夹中的 connector.log 文件，确保没有“连接被拒绝”消息或其他错误。

  • 如果 connector.log 未显示任何错误，请检查 Digital Lab 服务器计算机上的 service.log 文件。文件位于以下位置: 

    • Windows 服务器: <Digital Lab 服务器安装文件夹的路径 > \server\log
    • Linux server:<Path to the Digital Lab server installation folder>/server/log

如果在安装期间， Windows 发出警告“ Windows 防火墙已阻止此应用程序的某些功能”，请单击允许访问或与系统管理员联系。发出此消息时，当前连接器安装将中止。

如果无法在 Digital Lab 设备实验室中查看远程设备，则可能是由于在计算机 . 上安装了防病毒软件例如， McAfee 主机 Intrusion Protection 会阻止访问。解决方法: 运行测试时禁用防病毒。

Windows 连接器已成功启动，并且设备显示在 Digital Lab 设备实验室中，但远程访问或录制不起作用。有时，Digital Lab 会发出包含有问题 IP 地址和端口的消息。在其他情况下，您可能会收到“连接被拒绝”消息，指出 IP 地址有问题:

  • 检查 Digital Lab 服务器计算机上的 service.log 文件，并查找可能的“连接被拒绝”错误:

    • Windows 服务器: <Digital Lab 服务器安装文件夹的路径 > \server\log
    • Linux server:<Path to the Digital Lab server installation folder>/server/log

  • 检查 Digital Lab 尝试访问的 IP 地址 (如错误消息所示) 是否适用于连接器计算机。要显示计算机的 IP 地址，请打开命令行窗口并键入ipconfig。

    例如，如果在安装连接器时连接到其他网络或 IP，则需要在开始 > Digital Lab 连接器下运行修改配置实用程序，然后输入连接器的新 IP 计算机 .

  • 检查错误消息中显示的端口是否为连接器计算机上的传入通信打开。
  • 如果在连接器设置期间指示 SSL，则不支持 p需要凭据的 roxy 计算机。
  • 如果在为 SSL 环境using 代理服务器安装连接器时连接了设备，则设备不会显示在 Digital Lab.解决方法: 安装连接器软件后连接设备。
  • 尝试连接到安全 SSL Digital Lab 服务器时: 如果收到消息“无法访问 Digital Lab 服务器”，这可能是由于服务器计算机上的 CA 证书已修改。
    解决方案: 重新配置或修改连接器并检索新证书。

尝试运行安装时，如果安装程序发出“连接被拒绝”或“连接超时”警告，则可能意味着:

  • 服务器已关闭。请检查是否可以 ping 服务器。
  • Digital Lab 服务器的 IP 地址错误。
  • Digital Lab 连接器的端口错误。
  • 您使用的连接器版本与 Digital Lab 服务器的版本不兼容。选中Digital Lab ADM Marketplace 以查看您使用的是最新版本的连接器。

如果自上次安装连接器后服务器详细信息 (IP 地址或端口) 已更改，请修改连接器并指定新信息。

如果计算机上运行的现有服务声明连接器在其上运行的端口, 存在冲突，连接器未启动。

要更改端口，请运行开始 > Digital Lab 连接器菜单下的修改配置实用程序。

如果为特定用户 (不是 SYSTEM 用户) 安装了 AndroidSDK，则 Windows 连接器安装程序可能无法安装代理，因为 SYSTEM 用户无法访问手动安装的 SDK。
解决方法: 重新安装 AndroidSDK (作为 SYSTEM 用户)，并删除 ANDROID _ HOME 环境变量。

后退到顶部

卸载连接器

可以使用下列方法之一卸载连接器:

  • 双击桌面上的快捷方式并选择卸载 Digital Lab 服务器。
  • 或者，从设置中的应用程序页卸载，或者从程序和功能控制面板卸载。

如果卸载过程中打开了某些应用程序，则某些旧的连接器文件将保留。这可能会影响将来的安装。因此，建议您检查是否已删除所有连接器文件。否则，手动删除全部文件和文件夹，默认情况下位于 C:\ Program Files \ UFT Digital Lab 连接器 \connector.

后退到顶部

修补程序安装

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

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

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

  • 所有连接器

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

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

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

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

后退到顶部

另请参阅: