这可能是由于当 Chrome 版本低于 110 时， Android 13 上出现已知的 Chrome 驱动程序问题。此问题可以通过升级到 Chrome 版本 110 或更高版本来解决。

Android 设备当前不支持在测试期间拨打和接听电话，这可能会导致设备断开连接。

运行 Chrome 驱动程序所需的网络 Security Services (NSS) 库默认情况下不包含在 Linux OS 8.x 版本中。因此，Chrome 驱动程序无法启动，并且会话失败。使用以下命令安装 nss 包:  

sudo yum makecache – refresh
sudo yum -y install nss

如果在您的 Linux 计算机, 上无法访问 Internet，则应单独下载并安装脱机 RPM。

此问题可以解决启用 ART 支持。

1. 打开 ApkInufser 属性文件位于以下位置:
   < Digital Lab 服务器安装路径>/server/Android Tools/ApkInfuser/ApkInfuser.properties

2. 将该行[global.enableART = false]更改为[global.enableART = true]。

3. 保存文件

4. 上载再次应用程序。

5. 重新启动连接器。

1. 找到 connection.properties 文件。将以下行的值更改为 false :
   android.javavnc.useMinicap = false
2. 重新启动连接器。

备注您无法使用具有安全布局的应用程序。

在设备的键盘设置中，选择 QWERTY 布局。

如果英语字母未转换为日语，请使用以下解决方法之一:

• 对于直接从计算机键盘键入:

  1. 安装谷歌日语输入从设备上的 Google Play，或上传 apk 到 Digital Lab，然后安装在 Digital Lab 设备上。

  2. 开启设备选择 Google 日语输入键盘。在 Google 日语输入设置中，将键盘布局设置为 QWERTY。

•类型使用设备控制面板中的发送文本选项。

•类型，方法是单击设备的屏幕键盘。

某些设备管理器 (如 HTC 同步管理器和 Samsung Kies) 会在连接设备时自动启动，并启动其 ADB 服务器。启动 ADB 服务器时，它检测到已存在正在运行的 ADB 服务器 (Digital Lab ’ s)) 并停止该服务器。这会导致全部 Android 设备断开连接。
解决方法: 卸载设备管理器，或确保在将 Android 设备与 Digital Lab 一起使用时不会自动启动该管理器。

对于运行 Android 版本低于 7.0 的 Samsung 设备，请执行以下步骤以允许通过远程设备视图进行访问。

1. 找到 connector.properties 文件。

   服务器和连接器: $ {Digital Lab 安装路径}/server/conf

   远程连接器: $ {Digital Lab 安装路径}/connector/conf

2. 打开文件并将设备模型 (以逗号分隔) 添加到 android.javavnc.model.enable 属性。例如:

   android.javavnc.model.enable=LG-H990,Nexus 5X,Nexus 4,LG-H961N,Nexus 9,LG-H870,ONEPLUS A5000,LG-D855,ONEPLUS A3000,SM-N950F,SM-N960F,SM-G960F,SM-G965F

3. 重新启动要使更改生效的服务器/连接器。

在某些情况下，您可能会收到以下错误，当尝试确认“允许 USB 调试”。错误消息为“由于应用程序遮挡权限请求，因此设置无法验证您的响应。”

解决方法是，执行以下操作:

1. 断开连接 USB 电缆从设备。
2. 重新启动设备处于安全模式。要执行此操作，请在重新启动设备时按住小量按钮或查看制造商的指导。您应在屏幕的左下角看到安全模式。
3. 将 USB 电缆连接到设备。
4. 在“开发者”选项中，启用 USB 调试。
5. 重新启动设备处于正常模式。

对于由 Proguard 混淆并由 Digital Lab 自动注入代码的应用程序，录制和回放可能无法正常工作。
解决方法: 包应用程序手动使用 APKInfuser 工具。

1. 转至 AppDelivery Marketplace。选择当前版本的 Digital Lab 并下载 APKInfuser 工具。
2. 解压缩存档文件，并在 ApkInfuser 文件夹中找到 ApkInfuser.bat 文件。
3. 在 AndroidStudio 中构建应用程序时，找到 Proguard 生成的 mapping.txt 文件。

4. 应用程序上的运行 APKInfuser，使用 native、combined 和 mappingFile 命令行选项。

   ApkInfuser.bat-native-mix-mapping 文件< FULL_PATH_TO_MAPPING_FILE > < FULL_PATH_TO_APA >

   结果是一个具有调试签名的带有 Web 检测代码的文件。

   例如:

   ApkInfuser.bat – native – hybrid -mappingFile c:\mapping.txt my-android-app.apk

   以上命令生成文件: my-android-应用程序。apk.signed.debug.apk，该文件与原始的 API 位于同一文件夹中。

   提示: 有关 APKInfuser 工具的帮助，请参阅 ApkInfuser 文件夹中的 Use.txt 文件。

5. 上载生成的*.signed.debug.apk 文件到 Digital Lab。

某些运行 Android 7.0 的 Samsung 设备使用导致此问题的电池优化工具。如果遇到断开连接问题，请执行以下操作:

1. 打开设置>应用程序。
2. 单击更多按钮 (三个 vertica 垂直点)，然后选择特殊访问。
3. 在特殊访问区域中，选择优化电池使用。
4. 在优化电池使用区域中，选择全部应用程序。
5. 滚动到 Digital LabAgent 应用程序并将其切换到关闭。

某些 Android 设备 (主要是由中国供应商制造的设备) 使用影响内存和电池使用的安全工具。如果遇到断开连接问题，请执行以下操作:

1. 启用自动启动 Digital Lab 代理: 打开设备的主页页面中的安全应用程序，然后单击权限。选择 Autostart , 查找 Digital Lab Agent 应用程序, 并启用它。
2. 关闭电池保护程序: 打开设备的主页页面中的安全应用程序，然后单击电池。将电池节省程序设置为关闭。或者，要在上使用电池节省程序，请选择应用程序电池节省程序，然后查找 Digital Lab 代理应用程序。选择否限制。

某些 LG 设备断开连接后更改方向从“控制面板”中的远程视图。日志文件包含异常消息。如果发生这种情况，请执行以下操作:

1. 在 DEVICES 选项卡上检查断开连接的设备的设备卡，并确定其型号数量。这通常是制造商名称"LG"后跟连字符和短字符串。例如， SG-D855。

2. 打开连接器。properties file in C : \ Program Files \ UFT Digital Lab 服务器\server\conf (默认情况下)。
3. 添加模型断开的设备以"VNC _ USE_64ARTIFACT_MODELS "行。保存并关闭文件。
4. 重新启动连接器服务 (开始> Digital Lab 连接器>重新启动 Digital Lab 服务)，并在更改方向后验证连接是否稳定。

如果应用程序在录制会话期间崩溃或强制终止，则即使重新启动应用程序。，也不再录制您的操作必须从头开始重新生成会话录制。

可以通过在 Dexguard 中编译应用程序来使用 Dexguard 安全性。请按照下列步骤操作:

1. 上载将原始的、注入代码的或非注入代码的应用程序设置为 Digital Lab。
2. 在原始应用程序上记录测试。

3. 使用以下选项重新编译 Dexguard 中的应用程序:

   " - keepresourcexmlattributenames * */id-keepressources id/*"

4. 上载将应用程序的 Dexguard 包装版本设置为 Digital Lab。
5. 使用 Dexguard 包装版本的应用程序重播测试。

不支持跨域 iframe 调用。例如，如果您的测试使用指向其他域中网页的 iframe，则测试失败。

Android 限制可能会导致设备在安装某些应用程序时发出消息 INSTALL_FAILED_INSUFFICIENT_STORAGE。此限制还可能导致某些连接的设备在连接一段时间后从设备页面中消失。
解决方法: 重新启动设备。

使用混合非注入代码的应用程序时，确保启用远程内容调试。有关详细信息，请参阅启用 Android 应用程序的远程内容调试。

要在具有良好 Connect 客户端的设备上使用远程视图，必须将防止 Android 屏幕捕获策略设置为关闭。要使策略生效，必须使用 2.3.18.687.117 及更高版本的发行版。有关详细信息，请参阅 Blackberry 知识库文章。

要在 Android 上支持输入法编辑器 (IME) 操作，所测试的应用程序必须由应用程序开发人员使用 Android : imeOptions 特性进行自定义。如果执行此操作失败，则会导致某些 IME 操作 (如上一个和完成,) 无法按预期工作。

如果未安装 SIM 卡，则在运行 XCUITEST 时，由于否- SIM 弹出窗口，设备的即插即用功能可能会崩溃。要避免此故障，您可以使用虚拟 SIM 卡 (推荐) 或遵循以下准则 iOS 11.1 和更高版本:

1. 在设备的系统设置中，将设备的自动锁定配置为 30 秒。
2. 开启 iOS 代理上，轻按 Digital Lab 图标两次。

3. 选择 VNC 选项卡。

4. 将“避免设备锁定”选项设置为 1 分钟，以避免设备锁定 (即使设备的系统自动锁定设置也可能发生这种情况)。
   备注: 要将此设置应用于所有已连接的 iOS 设备，请在管理设置>iOS 选项中配置此设置。这样就无需在每个连接的设备上手动配置设置。

   

5. 强烈建议同时启用应用程序启动警报解除。如果禁用该设置并出现系统警报，则可能会阻止“避免设备锁定”功能的功能，从而导致设备锁定。
   备注: 要将此设置应用于所有已连接的 iOS 设备，请在管理设置>iOS 选项中配置此设置。这样就无需在每个连接的设备上手动配置设置。
   

安装设备上已安装的应用程序时，请确保使用与已安装的应用程序相同的开发人员证书。如果证书不匹配，安装将失败。例如，如果设备上的应用程序使用证书 A 签名，则无法安装使用证书 B 签名的同一应用程序。

如果设备上的应用程序使用企业证书进行签名，并且要安装使用开发人员证书进行签名的相同应用程序，则同样适用。

解决方法: 如果证书不匹配，请先删除设备上已安装的应用程序，然后使用其他证书在设备上重新安装应用程序。

在 Macintosh 上对应用程序进行代码签名时，必须安装 Apple 可信颁发机构证书，以便通过 Keychain Access 应用程序将 Apple 识别为可信颁发机构。如果未安装 Apple 可信授权机构证书，则由 Apple 发布的任何证书都将显示为无效。有关软件签名证书的更多详细信息，请参阅 Apple Developer 文档。

如果证书在 Keychain Access 应用程序中显示为无效 (红色)，后跟错误“此证书由未知授权机构签署”，则需要从 AppleWorldwide Developer Relationship Certificate Authority 下载并安装新证书。

安装证书，如下所示:

1.下载来自 AppleDeveloper 支持站点的证书。

2.双击证书。

3.请验证它是否有效 (绿色)，并且不显示以下错误: "This certificate was signed by an unknown authority "。

如果将设备设置为在特定时间间隔后锁定屏幕或进入睡眠状态，则这可能会影响您的重播。

要防止所有已连接的 iOS 设备锁定，请在管理设置>iOS 选项中配置防止自动锁定设置。这样就无需在每个连接的设备上手动配置设置。

或者，要手动防止设备的屏幕锁定，请确保将睡眠的显示设置设置为"从不"。

如果设备继续休眠并锁定屏幕，则可以应用变通办法向设备发送伪操作以防止其休眠，并解除设备锁定。此变通办法使用的伪操作是上卷和下卷控件。它不影响您的测试中的步骤，但您可以在设备屏幕上以一定的时间间隔短暂地查看控件。

要设置此操作，请执行以下操作:

1. 开启设备，请打开代理应用程序。

2. 开启上，Digital Lab icon, 轻按屏幕两次。高级开发者栏将显示在屏幕底部。

3. 单击右下角的按钮 VNC，用于显示 VNC 服务器详细信息设置。
4. 单击位于避免设备锁定功能的右侧值列中。
5. 选择将伪操作发送到设备的时间间隔，从 1 到 5 分钟。

您可以通过以下方式获取数量中设备的崩溃日志:

将录制作为 iOS 上应用程序的代码注入版本时，记录器会在主页导航步骤之后生成两个定位步骤。

iOS 设备上的时区必须与连接器计算机上的时区匹配。如果不对齐时区，则会下载一个空文本文件。

某些元素 (如软键盘) 在物理设备上可见，但在远程设备显示器上不可见。这是由于 Apple 安全增强功能。在某些情况下，可能会将这些“不可见”图元放置在其他图元的顶部，从而阻止用户与其交互。例如，软键盘可以放在登录按钮上，从而防止用户单击它。

由于 Apple 的安全增强功能，当使用远程屏幕查看器在设备上键入密码时，虚拟键盘不显示，并且安全密码字段上的文本不可见。开启的物理设备，键盘和视觉指示器 (点) 的密码显示。即使不显示文本/键盘，也会按预期发送文本。

使用选项将文本发送到设备时观察到相同的行为。即使未显示文字，也会发送文字。

代码注入的 iOS 的记录和重播应用程序使用 accessibilityLabel 属性和值进行对象识别，而不是 accessibilityId。如果测试逻辑使用 accessibilityId 属性和值来区分特定对象，并且计划测试注入代码的应用程序，请按如下方式设置设备:

1. 开启设备，请打开代理应用程序。

2. 开启代理徽标，轻按屏幕两次。高级开发者栏将显示在屏幕底部。

3. 单击 VNC 按钮在屏幕的右下角，以显示设置。
4. 将 use accessibilityId for 注入代码的应用程序切换为启用。

在设备中插入 SIM 卡或虚拟 SIM 卡。

或者，在设备上手动配置设备和 Agent 应用程序，如下所示:

1. 开启设备，选择设置> Display|Brightness > Auto-lock 并将计时设置为 30 秒。
2. 打开设备上的 Agent 应用程序。
3. 轻按 Digital Lab 图标 2 次。开发者选项选项卡栏显示在底部。
4. 轻按 VNC 图标并将“避免设备锁定”设置为 1 分钟。

备注: 要将此设置应用于所有已连接的 iOS 设备，请在管理设置>iOS 选项中配置此设置。这样就无需在每个连接的设备上手动配置设置。

如果应用程序在启动或开始 Record 之后持续崩溃，或者如果无法使用安装应用程序选项 (实际选项名称可能因使用的工具而异) 启动它，则执行以下操作之一:

1. 运行测试的卸载或删除选项。
   

   工具	选项名称
   UFT 1	选择卸载复选框 (位于 Record and 运行设置对话框的 Mobile 选项卡中)。
   TruClient	删除应用程序 After Execution(位于 TruClient 常规设置对话框的 Digital Lab 设置选项卡中)。
   Sprinter	的 Digital Lab“应用程序” 选项卡中的“卸载”按钮。

2. 安装设备上重新代码注入的 AUT，并且仅使用重新启动选项。

   工具	选项名称
   UFT One	重新启动 (位于“录制和运行设置”对话框的移动选项卡中)。
   TruClient	重新启动应用程序 (位于 TruClient 常规设置对话框的 Digital Lab 设置选项卡中)。
   Sprinter	应用程序选项卡中的 Digital LabRESTART 按钮。

如果代理未在设备上启动，则验证服务器或连接器计算机是否识别设备:

Linux

1. 导航到:
   设备已连接到服务器计算机
   /< 服务器安装 文件夹> /server /libimobiledevice /linux /
   或
   设备连接到单机版连接器
   /< path 到连接器安装文件夹> /connector /libimobiledevice /linux /
   
2. 运行 idevice_id – l

此命令的结果应为设备 ID (UDID) 列表。如果命令返回空结果或 ERROR 消息，请尝试以下操作:

1. 日志作为 Digital Lab 服务器或连接器计算机上的 root。
2. 找到过程 ID 的"usbmuxd""
   ps aux|grep ' [u] sbmuxd '
3. 终止进程:
   kill - 9< processID >
4. 开始 usbmuxd :
   usbmuxd
5. 运行 idevice_id – l 以查看是否识别设备。

Windows

1. 打开命令提示窗口并浏览到以下文件夹:
   设备 connected to server machine : < Path to your Windows server folder > server\libimobiledevice\win 或
   设备已连接到独立连接器 : < Windows 连接器文件夹的路径>\libimobiledevice\win
2. 运行以下命令: idevice_id – l

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

• USB 端口不工作 (硬件问题)
• iTunes 未安装，或者您未在连接器电脑上使用最新版本的 iTunes。下载最新版本的 iTunes。

尝试通过测试 (例如 UFT 1) 启动经过企业认证的应用程序时，首次启动应用程序可能会失败，因为 Apple 要求用户手动批准设备上的应用程序。请求批准的错误消息在测试工具的界面中不可见 (例如 UFT 1).)但是，如果手动启动应用程序，则它可见。

解决方案: 手动启动应用程序并批准其证书。然后，在测试中启动它。

在 XCUITest 设备上进行录制时，未录制 URL 导航。
解决方法: 如果导航到 URL 是测试的第一步，请至少等待 5 秒以确保 JavaScript 注入完成。单击一旦在地址栏中打开键盘-不执行双击或按清除按钮。类型在完整 URL 中，使用 PC 键盘 (不是设备的) 并按 Enter 键。

使用日期选取器选择日期时，请确保在 30 秒内进行选择。如果选择的持续时间超过 30 秒,，代理将超时。此问题仅适用于 iOS 设备上的非注入代码的应用程序。

如果设备无法正常工作，请尝试重置所有设置。例如，如果远程访问不起作用，则轻按不响应，应用程序不安装，依此类推，还原为原始默认设置:

对于连接到 iOS 11.1 设备的 Mac 连接器: 如果设备无法连接到 Digital Lab，请在执行时检查连接器日志以查找错误。/ideviceadddocument 。这表明存在信任问题。

如果代理在设备上停止工作，请执行以下操作:

如果仍有问题:

最后的办法是:

如果 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 环境变量。

这可能是由于注册表文件损坏造成的。

要解决此问题，请执行以下操作:

1. 卸载现有安装。

2. 确保已删除注册表文件 /Library/Preferences/.com.zerog.registry.xml。如果未手动删除文件，则为。

3. 安装 Mac 连接器。

用户界面 (UI) 的语言由连接到 Digital Lab 的测试工具的语言确定。

• Digital Lab 的 UI 支持以下语言 (L10N)- 英语、中文、法语、德语、意大利语、日语和西班牙语。
• 在没有测试工具的情况下访问实验室控制台时，显示的语言由浏览器语言确定。
• 对于不支持的语言 (如朝鲜语): 从语言包中的计算机打开 TruClient 测试工具时，将以英语显示 Digital Lab 界面。

使用功能 browserName : chrome , 在 Appium 检查器中打开 Chrome 浏览器会导致浏览器在打开时立即转到背景。Appium Desktop 保持循环，等待打开 Chrome，从而导致错误: "调用' getPageSource '失败...无法访问 Chrome。"

解决方法: 添加功能 appium : recreateChrome-DriverSessions : false。

此错误表示 Chrome 版本不匹配。如果您的上的 Chrome 版本与支持的 Digital Lab Chrome 版本不兼容，则会显示以下错误:“处理命令时发生未知服务器端错误。原始错误: 未知错误: Chrome 版本必须 > = 55.0.2883.0”。

• 开启您的设备上，导航到 https : //www.whatismybrowser.com 以检查正在使用的 Chrome 版本。

• 要查看 Digital Lab 支持的 Chrome 版本，导航到设备所连接的 Digital Lab connector/ 服务器的 Chrome 驱动程序文件夹。例如: C : \Program Files\UFT Digital Lab 连接器\connector\chromeDriver.