Appium 使用指南 或 Appium 安装配置

### Appium 使用教程 #### 什么是 Appium？ Appium 是一个开源的移动端自动化测试框架，支持对原生、混合以及移动 Web 应用进行测试[^1]。它能够用于 iOS 和 Android 平台的应用程序测试，并且具有跨平台特性，可以在 macOS、Windows 和 Linux 上运行。 --- #### Appium 的安装与配置指南 ##### 1. **环境准备** 在开始之前，请确保已安装以下工具： - Java Development Kit (JDK) - Node.js - Python 或其他编程语言（可选） - Android SDK 工具包 对于 Android 开发者来说，在完成 Android Studio 安装后，可以通过 `Preference -> Appearance & Behavior -> System Settings -> Android SDK` 配置所需的 Android 版本。默认情况下会下载最新的 API 级别（如 API 33 对应 Android 12），但如果需要特定版本，则需手动选择并安装相应组件[^4]。 ##### 2. **安装 Appium Server** 通过 npm 命令来全局安装 Appium Server： ```bash npm install -g appium ``` 启动服务端命令如下所示： ```bash appium ``` 这一步骤将初始化服务器监听客户端请求。 ##### 3. **解决常见错误——Invalid Argument Exception** 当尝试连接至新版 Appium Server 运行时可能会遇到异常提示：“InvalidArgumentException: 'automationName' can't be blank”。此问题是由于未指定 automation name 参数引起，在较新的版本中推荐使用 UiAutomator2 替代旧版驱动器作为解决方案之一[^2]： 执行插件管理操作前确认当前可用驱动列表状态： ```bash appium driver list ``` 接着按照指示添加必要依赖项到本地环境中去： ```bash appium driver install uiautomator2 ``` 以上步骤有助于修复因缺失关键属性而导致的功能障碍情况发生。 ##### 4. **编写第一个脚本** 下面展示了一个简单的 Python 脚本来演示如何利用 Desired Capabilities 启动模拟设备上的应用程序实例。 ```python from appium import webdriver desired_caps = { "platformName": "Android", "deviceName": "emulator-5554", "appPackage": "com.example.app", "appActivity": ".MainActivity" } driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps) # 执行某些交互动作... driver.quit() ``` 此处定义了几个重要参数比如目标操作系统名称(platformName)，虚拟机或者真机标识(deviceName)等等。这些信息共同构成了描述能力(desired capabilities)，它们告诉 server 如何设置 session 条件以便正确加载待测 APP 文件。 --- ###