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

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

3. 选择”VNC“ 选项卡。

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

   

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

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

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

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

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

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

安装证书，如下所示:

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

2.双击证书。

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

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

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

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

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

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

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

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

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. 轻按 UFT Mobile 图标2次。开发者选项选项卡栏显示在底部。
4. 轻按VNC图标并将“避免个设备锁定”设置为1分钟。

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

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

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

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

2. 安装设备上重新打包的AUT，并且仅使用重新启动选项。

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

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

”Linux“

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

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

1. 日志作为 UFT Mobile 服务器或 连接器计算机上的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设备上的非注入代码的应用程序。

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

对于连接到iOS1.1设备的Mac连接器: 如果设备无法连接到 UFT Mobile，请在执行”时检查连接器日志以查找错误。/ideviceadddocument “。这表明存在信任问题。

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

如果仍有问题:

最后的办法是:

如果Windows连接器已成功启动，但在 UFT Mobile 练习中看不到设备:

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

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

  • ”Windows服务器:“ <UFT Mobile 服务器安装文件夹的路径>\server\log
  • ”Linux服务器:“ < UFT Mobile 服务器安装文件夹的路径>/server/log

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

如果无法在 UFT Mobile 中查看远程设备，这可能是计算机上安装防病毒软件的结果。例如，McAfee主机Intrusion Protection会阻止访问。”解决方法:“运行测试时禁用防病毒。

Windows连接器已成功启动，并且设备显示在 UFT Mobile 练习中，但远程访问或录制无法正常工作。有时 UFT Mobile 会发出包含有问题的IP地址和端口的消息。在其他情况下，您可能会收到“连接被拒绝”消息，指出IP地址有问题:

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

  • ”Windows服务器:“ <UFT Mobile 服务器安装文件夹的路径>\server\log
  • ”Linux服务器:“ < UFT Mobile 服务器安装文件夹的路径>/server/log

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

  例如，如果在安装连接器时连接到其他网络或IP，则需要运行”开始> UFT Mobile连接器“下的 ”Modify configuration“ 实用程序，并将新IP输入作为连接器计算机的IP。

• 检查错误消息中显示的端口是否为连接器计算机上的传入通信打开。

• 如果在连接器设置期间指示SSL，则不支持 p 需要凭据的roxy计算机。
• 如果使用代理服务器为SSL环境安装连接器时连接了设备，则设备将不会显示在Mobile实验室中。”解决方法:“安装连接器软件后连接设备。

• 尝试连接到安全SSL UFT Mobile 服务器时: 如果收到消息“无法访问 UFTM 服务器”，这可能是由于服务器计算机上的CA证书已修改。
  ”解决方案:“重新配置或修改连接器并检索新证书。

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

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

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

如果计算机上运行的现有服务声明连接器在其上运行的端口 ，将发生冲突，连接器将不会启动。

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

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

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

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

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

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

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

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

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