故障排除场景

如果遇到问题，请考虑以下故障排除方案：

移动设备自动化

以下主题描述了移动设备自动化的问题及其相应的解决方法。

生成错误的工作流和活动

说明：Studio 中的工作流引发意外错误，并且活动包不显示已安装的版本。

原因 ：在项目中， UI.Automation 活动包的主要版本与 Mobile.Automation 活动包的主要版本不匹配。 例如，安装的 UI.Automation 包的主要版本是 22.10.x， 安装的 Mobile.Automation 包的主要版本为 22.4.x。

解决方法：确保项目中安装的 UI.Automation 和 Mobile.Automation 活动包的主要版本匹配。 例如， 将 UI.Automation.Activities 版本 22.10.x 配对 仅适用于 Mobile.Automation.Activities 版本 22.10.x。

重要提示： 始终使用 UI.Automation 和 Mobile.Automation 活动包的最新可用修补程序。 例如，如果您安装了 UI.Automation 或 Mobile.Automation 22.10，则下载 22.10 的最新可用补丁。

未找到 wd/hub/ 会话的路由

条件：使用 Appium 2.0时。

说明: 未找到/wd/hub/session的路由。

解决方法：在启动 Appium 会话之前手动添加以下参数： --base-path /wd/hub 。

所有非标准功能都需要供应商前缀

条件：使用 Appium 2.0时。

说明：所有非标准功能都应具有供应商前缀。

解决方法：为所有功能手动添加appium:前缀，如下所示：

• 在命令提示符或终端中，输入--default-capabilities "{\"appium:systemPort\": 8201}"而不是--default-capabilities "{\"systemPort\": 8201}" }。
• 在移动设备管理器的“ 添加设备 ” 选项卡中，在任何其他所需功能的名称前手动添加appium:前缀。

自动化名称不能为空

条件：使用 Appium 2.0时。

说明: automationName功能不能为空。

解决方法：添加appium:作为前缀。 例如appium:automationName 。

找不到已安装的驱动程序

条件：使用 Appium 2.0时。

说明：找不到已安装的驱动程序以支持给定的大写字母。

Appium 2.0 不会自动安装所需的驱动程序。 您必须单独下载它们。

解决方法：为您的平台安装所需的驱动程序。

• 对于 Android 设备，请使用appium driver install uiautomator2命令安装uiautomator2驱动程序。
• 对于 iOS 设备，请使用 appium driver install xcuitest 命令来安装 xcuitest 驱动程序。

Android

以下主题描述了 Android 设备的问题及其相应的解决方法。

由于代理原因，Appium 安装失败

说明：运行npm install -g appium （对于 Appium 1.x）或npm install -g appium@next （对于 Appium 2.0）命令失败，因为您是在代理后面运行。 该错误将引发以下消息：

npm 错误!网络 这是与网络连接相关的问题。

npm 错误!网络 在大多数情况下，您使用代理服务器或网络设置错误。

npm 错误!网络 npm 错误!网络如果您使用代理，请确保 npm ERR!网络“代理”配置已正确设置。 请参阅：“npm 帮助配置”

解决方法：配置 npm 以使用您的代理。 请按照以下步骤操作：

1. 获取您的代理服务器地址和端口号：

   • 转到“ Internet 选项”。
   • 选择“ 连接 ” 选项卡。

   • 选择“ 局域网设置” ，然后复制“ 地址” 和“ 端口 ” 字段中的内容。

     
     

     

     
     

2. 返回到 Node.js 命令提示符，然后运行以下格式的命令：

   • 对于 HTTP 代理： npm config set http://your_proxy_address:your_port_number 。
   • 对于 HTTPS 代理：npm config set https://your_proxy_address:your_port_number。
3. 再次运行npm install -g appium （对于 Appium 1.x）或npm install -g appium@next （对于 Appium 2.0）命令。

无法访问所提供的网页上下文

说明：无法访问提供的 Web 上下文。请确保 Android WebView 可调试。详情请访问 https://developers.google.com/web/tools/chrome-devtools/remote-debugging/webviews。

补救措施：

• 在无法识别的网页上下文中将 WebView 用作原生选取器。
• 如果选取器适用于网页应用程序，但不适用于应用程序，则应用程序不会启用调试网页视图。 在这种情况下，请参阅 远程调试 Android 网页视图入门和 远程调试网页视图。

设备未授权

说明: 设备未授权。

解决方法：执行以下步骤：

1. 使用adb devices命令检查现有设备。
2. 撤消手机上的 调试 。
3. 按以下顺序重新启动 ADB 服务器： adb kill-server ，然后是adb start-server 。
4. 重新连接设备，并确认您同意该设备上的连接。

从启动屏幕启动时的浏览器自动化

说明：Android 设备启动浏览器自动化，而不是给定的应用程序，因此导致错误。

解决方法：首先使用网页浏览器。

Android 应用程序无法启动

说明：您创建的 Android 应用程序无法在移动设备管理器中启动。

补救措施：

• 将鼠标悬停在应用程序上，然后单击“ 编辑” 。
• 在“ 应用程序包 ” 和“ 应用程序活动 ” 字段中添加有关应用程序的信息。

iOS

以下主题描述了 iOS 设备的问题及其相应的解决方法。

iOS 物理设备无法启动

说明：iOS 物理设备无法启动。

解决方法：执行以下步骤：

• 确保您的设备信任该证书。在您的设备上，前往“设置”>“通用”>“配置文件与设备管理”，单击电子邮件条目（例如，Apple 开发: [e-mail]），然后信任该证书。如果设备使用的是您的公司帐户，则不需要此操作。
• 如果收到无法访问端口 8100 的错误，请关闭 Appium (ctrl + c)，然后重新启动。
• 如果您收到其他错误，请考虑查看 Appium XCUITest 驱动程序真实设备。

iOS 16.0 设备无法启动

说明：iOS 16.0 设备无法启动或连接。

补救措施：安装并使用 Appium 2.0，而不是 Appium 1。有关安装和管理 Appium 2.0 的更多信息，请查看本地 iOS 设备先决条件 部分。

iOS 12.4.5 故障

说明：与 Appium 1.22.3 配对时，iOS 12.4.5 无法正常运行。

原因：这是由 Appium 的问题引起的。

解决方法：选择以下选项之一：

• 使用较低版本的 Appium，例如 1.17.0。

重要提示： 这可能会导致最新版本的 XCode 出现问题，并且可能无法在 macOS Monterey 上按预期运行。

• 将设备升级到等于或高于 iOS 14 的版本。