本地设备

概述

要设置本地设备以使用“移动自动化”活动，无论是物理设备还是模拟器，您都需要运行 Appium 的本地实例，并拥有自动化 Android 或 iOS 设备的必要工具。

主题版块:

• 应用程序存储
• Android 设备配置
• Android 设备配置

应用程序存储

您需要将移动应用程序存储在运行 Appium 服务器的同一台计算机上，或者将APK或IPA文件上传到 Appium 服务器可匿名访问的 URL（例如Blob 存储）。

无法从 Play 商店或 App Store 安装应用程序，除非您手动自动化这些应用程序以安装特定应用程序。

Android 设备配置

要配置本地 Android 设备，您需要准备环境并将其添加到移动设备管理器。

本节中的主题：

• 准备 Android 环境
• 启动 Appium Server
• 创建 Android 模拟器
• 使用 WebDriver 实现网页自动化和混合自动化
• 配置 Android 物理设备
• 在移动设备管理器中添加本地 Android 设备

准备 Android 环境

准备并配置您的环境。

1. 下载并安装 Node.js。
2. 打开 Node.js 命令提示符并运行以下命令以安装 Appium:

   npm install -g appium

   有关 Appium 配置的更多信息，请参阅“Appium 入门”。

3. 在 Windows 中，导航至“高级系统设置”>“高级”>“环境变量”
4. 在“系统变量”下，单击“新建”并配置以下变量:

   A. ANDROID_HOME 变量。

变量名称： ANDROID_HOME 变量值： C:\Users\Username\AppData\Local\Android\Sdk 注意： 变量值 路径中的Username部分必须替换为在计算机上操作的用户的实际名称。

b. JAVA_HOME 变量。您需要先安装 Java 才能配置此变量。您可以 在此处通过 zip 文件下载 Java。

变量名称: JAVA_HOME 。

变量 value：JDK 在计算机上的路径。 例如： C:\Program Files\Java\jdk8 。

重要：如果 Java 是自动更新的，则需要使用更新后的路径手动配置此变量。

c. 单击“确定”以确认。

1. 编辑用户的 Path 变量以包括 Android Debug Bridge (ADB)：

   a. 单击“新建”并添加以下值：

   %ANDROID_HOME%\platform-tools

   b. 单击“确定”以确认。

2. 单击“确定”以设置变量。

   
   

   

   
   

启动 Appium Server

在启动设备上的任何应用程序之前，您需要在计算机上开始运行 Appium 服务器。打开命令提示符并使用以下参数运行 Appium:

appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

备注：

• 如果自动下载失败，您可以指向已下载的 chromedriver.exe，通过连接以下命令:

--chromedriver-executable "path_to_chromedriver"

• 要获得有关 Appium 调试的帮助，请运行以下命令:

appium-doctor

• 要终止 Appium，请使用ctrl + c命令。

创建 Android 模拟器

使用 Android Studio 创建您的 Android 模拟器。

1. 下载并安装 Android Studio。
2. 打开 Android Studio。
3. 单击“配置”，然后从下拉列表中选择“SDK 管理器”。
4. 取消选中“隐藏已过时的包”，并确保选择了“Android SDK 工具（已过时）”。
   
   

   

   
   
5. 单击“应用”，然后单击“确定”以关闭。
6. 导航至“配置”>“AVD 管理器”以配置虚拟设备。有关详细信息，请参阅“创建和管理虚拟设备”。
   
   

   

   
   
7. 更新设备的 Google 应用程序。

使用 WebDriver 实现网页自动化和混合自动化

启用 WebView 调试。

如果 Appium 未在您的 Android 上自动检测 Chrome 或 WebView 版本，请选择以下选项之一：

1. 使用--allow-insecure chromedriver_autodownload命令。 这使 Appium 能够自动检测并下载与您的环境对应的 ChromeDriver 版本。
2. 手动指定并下载适用于 Chrome 的 WebDriver：

   2.1. 在 Android Studio 中打开您的设备。

   2.2.前往“设置”>“应用程序和通知”。

   2.3 单击 “查看所有应用程序”。

   2.4.单击垂直省略号按钮，然后从下拉列表中选择“显示系统”。

   2.5.使用搜索功能查找“Android 系统 WebView”。

   2.6.打开应用程序并转到“高级”。

   2.7.复制屏幕底部的版本号。

   2.8.下载 WebDriver for Chrome 并考虑以下事项:

   • 选择与上一步中的 Android 系统 Webview 版本相对应的版本，并将其解压缩到文件夹中。
   • 您正在寻找版本的精确匹配项 (major.minor.patch.revision)。
   • 如果没有精确匹配项，请使用与 Android 系统 Webview 的主要版本匹配的 ChromeDriver 的最新主要版本。
   • 如果您想自动化 Chrome 应用程序，只需执行与上述相同的步骤，并记下 Chrome 版本。

配置 Android 物理设备

1. 下载并安装 Android Studio。
2. 打开 Android Studio。
3. 单击“配置”，然后从下拉列表中选择“SDK 管理器”。
4. 取消选中“隐藏已过时的包”，并确保选择了“Android SDK 工具（已过时）”。
5. 单击“应用”，然后单击“确定”以关闭。
6. 打开命令行并运行以下命令以启动调试服务器:

   %LOCALAPPDATA%\\Android\\Sdk\\platform-tools\\adb.exe start-server

7. 通过数据线将设备连接到计算机。
8. 在您的设备上启用开发者选项和 USB 调试。有关更多信息，请参阅“配置设备开发者选项”。
9. 在手机上，导航至“设置”>“开发者选项”。
10. 在“网络”部分下，打开“默认 USB 配置”并将其设置为“仅为手机充电”。
11. 将您的设备添加到移动设备管理器。
12. 运行以下命令以启动 Appium 服务器:

    appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

    有关其他参数，请参阅“启动 Appium Server”。

    注意：确保 Appium 服务器连接在不受任何干扰的情况下运行。例如，如果您在终端内单击，则通信将被中断，这可能会导致移动设备管理器中出现通信错误。

在移动设备管理器中添加本地 Android 设备

1. 从 Studio 打开 MDM。
2. 在左侧导航面板中，转到“设备”。
3. 按如下方式配置您的设备:
   • 名称 - 在“设备”选项卡中输入用于标识设备的名称。
   • Appium URL - 输入本地主机。例如：http://localhost:10001/wd/hub。
   • 平台 - 单击字段以从下拉列表中选择“Android”。
   • 设备名称 - 输入设备名称。一种查看方法是通过 Android Studio 导航到“配置”>“AVD 管理器”，然后转到“更多操作”>“查看详细信息”。
   • 平台版本 - 添加 Android 操作系统的版本号。
   • 其他所需功能（可选） - 添加特定功能以自定义自动化会话。有关更多信息，请参阅 Appium 所需功能。
   • 设置地理位置（可选）- 设置设备位置以测试使用位置服务生成位置数据的应用程序。
4. （可选）在“日志记录”选项卡中配置日志记录和视频录制详细信息。
5. （可选）在“开发”选项卡中配置开发流程。
   • 关闭类似选项卡（默认情况下激活）: 关闭与类似设备和应用程序运行连接的选项卡。
   • 等待页面更新（默认激活）: 等待页面来源检索每个操作的屏幕截图。
6. 单击“保存并关闭”以添加设备。

   您的设备已添加到“设备”列表中。要添加本地设备，请参阅“本地设备”。

   
   

   

   
   

Android 设备配置

要配置本地 iOS 设备、模拟器或物理设备，并自动化应用程序，您必须在 macOS 计算机上设置 Appium 服务器。

重要提示：

如果您的应用程序工件使用APP扩展程序，并且您想要将该应用程序上传到公共 URL，则需要创建一个名为Payload的文件夹，将APP放入其中，存档Payload文件夹并进行更改将扩展名改为IPA而不是ZIP。

此外，请确保针对目标架构（模拟器或物理设备）编译您尝试自动化的应用程序。

本节中的主题：

• 准备 Android 环境
• 配置 iOS 物理设备
• 在移动设备管理器中添加本地 iOS 设备

准备 Android 环境

1. 安装 Xcode。
2. 打开终端并运行以下命令以安装 Homebrew:

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. 运行以下命令以安装 NodeJS:

   brew install node

4. 安装 Appium:

   npm install -g appium

5. 打开 Xcode 并允许其安装可能需要的任何其他组件。看到启动画面后，请关闭它。
6. 运行以下命令以启动 Appium:

   appium --port 10001

7. 使用 Spotlight 搜索（⌘-空格键）打开“网络实用程序”。
8. 复制 IP 地址以供以后在 MDM 中添加 iOS 设备时使用。这将包含在 Appium URL 中（例如http://<ipaddress>:8001/wd/hub）。
   
   

   

   
   

配置 iOS 物理设备

如果要在 iOS 实体设备上使用移动自动化活动，则需要 Apple 开发者帐户。

1. 按照 准备 macOS 环境中的步骤 1-5 操作
2. 将物理设备连接到 Mac。
3. 解锁您的设备，如果弹出警示，请确保允许计算机访问它。
4. 打开终端并运行以下命令:

   instruments -s devices

5. 在 MDM 中添加设备时，复制您的设备 ID 以备后用。例如，“deviceID”将作为 udid 功能添加:

   Known Devices: Username's iPhone (13.5.1) (<deviceID>)

6. 登录到您的 Apple 开发者帐户并转到“成员资格”。
7. 在 MDM 中添加设备时，复制您的团队 ID 以备后用。必须将您的团队 ID 添加到名为 xcodeOrgId 的设备功能中。
8. 打开 Xcode 并导航至“Preferences”>“Accounts”。
9. 添加您的 Apple 开发者帐户。

在移动设备管理器中添加本地 iOS 设备

1. 从 Studio 打开移动设备管理器。
2. 在左侧导航面板中，转到“设备”。
3. 按如下方式配置您的设备:
   • 名称 - 在“设备”选项卡中输入用于标识设备的名称。
   • Appium URL - 输入本地主机。例如：http://<ipaddress>:8001/wd/hub。
   • 平台 - 单击字段以从下拉列表中选择“iOS”。
   • 设备名称 - 输入设备名称。
   • 其他所需功能（物理设备） - 添加 udid 和 xcodeOrgId。有关更多信息，请参阅配置 iOS 物理设备
   • 设置地理位置（可选）- 设置设备位置以测试使用位置服务生成位置数据的应用程序。
4. （可选）在“日志记录”选项卡中配置日志记录和视频录制详细信息。
5. （可选）在“开发”选项卡中配置开发流程。
   • 关闭类似选项卡（默认情况下激活）: 关闭与类似设备和应用程序运行连接的选项卡。
   • 等待页面更新（默认激活）: 等待页面来源检索每个操作的屏幕截图。
6. 单击“保存并关闭”以添加设备。

   您的设备已添加到“设备”列表中。要添加本地设备，请参阅“本地设备”。

   如果您无法启动设备，请参阅“故障排除：实体设备启动失败”。