1. 项目概述为什么要在Windows上折腾Appium如果你是一名移动端测试工程师或者是一个对自动化测试感兴趣的后端、前端开发者那么“Appium”这个名字对你来说一定不陌生。它被誉为移动端自动化测试的“瑞士军刀”一个开源工具能让你用同一套代码去测试Android和iOS应用听起来就很酷对吧但很多朋友尤其是刚入门的新手往往在第一步——环境搭建上就栽了跟头特别是在Windows平台。网上的教程要么版本过时要么步骤跳跃照着做总会出现各种稀奇古怪的报错让人头大。这篇内容就是为你准备的。我将以一个在Windows 10/11系统上从零开始搭建一套稳定、可用的Appium自动化测试环境的完整过程拆解给你看。这不仅仅是一个“下一步、下一步”的安装指南我会把每一步背后的逻辑、可能遇到的坑以及我踩过之后总结的避坑技巧都毫无保留地分享出来。我们的目标很明确让你在Windows电脑上成功运行起第一个Appium测试脚本并能稳定地连接到Android模拟器或真机进行自动化操作。无论你是为了提升测试效率还是为了学习一项硬核技能这篇实战指南都将是你可靠的起点。2. 环境准备与核心组件解析在开始安装之前我们必须搞清楚Appium在Windows上运行需要哪些“零件”。它不是单一软件而是一个由多个核心组件协同工作的生态系统。理解它们能让你在出问题时快速定位。2.1 核心四大件JDK、Android SDK、Node.js与Appium Server1. Java Development Kit (JDK)作用Appium Server本身是用Java写的虽然2.0后核心用Node.js了但很多底层驱动和Android工具链依然依赖Java环境同时它也是编译和运行Android应用的基础。版本选择强烈推荐使用JDK 8或JDK 11LTS长期支持版。更高的版本如JDK 17虽然也可以用但可能与某些旧的Android构建工具产生兼容性问题。对于自动化测试环境稳定压倒一切。避坑点安装后务必配置JAVA_HOME系统环境变量并确保%JAVA_HOME%\bin添加到Path中。这是后续所有工具能正确找到Java的关键。2. Android SDK (Software Development Kit)作用这是与Android设备通信的桥梁。Appium需要通过SDK里的工具如adb,aapt来安装应用、获取设备信息、发送点击事件等。安装演变过去我们需要单独下载庞大的SDK现在谷歌推荐并通过Android Studio进行管理和下载。对于测试工程师我们完全可以只安装Android Studio来获取SDK而不必用它进行开发。核心工具安装后你需要关注%ANDROID_HOME%\platform-tools目录下的adb.exeAndroid调试桥它是与设备通信的核心命令工具。3. Node.js 与 npm作用Appium Server从2.0版本开始其核心是一个Node.js应用。我们需要Node.js环境来安装和运行它。npm是Node.js的包管理器用来安装Appium。版本选择选择最新的LTS版本即可。安装Node.js时会自动安装npm。4. Appium Server作用这是大脑和调度中心。它接收你编写的测试脚本通过WebDriver协议将其翻译成设备能够理解的操作指令通过UIAutomator2 for Android, XCUITest for iOS并下发给设备执行。两种形式Appium Desktop一个带图形界面的应用程序包含Server和元素定位工具Inspector适合新手入门和调试。Appium Server (via npm)通过命令行安装和启动的纯服务器更轻量更适合集成到CI/CD流水线中。2.2 环境变量配置让系统找到你的工具这是Windows平台最易出错的一环。很多“命令不是内部或外部命令”的错误都源于此。你需要配置的系统环境变量主要有三个JAVA_HOME指向你的JDK安装目录例如C:\Program Files\Java\jdk-11.0.xx。ANDROID_HOME指向你的Android SDK根目录例如C:\Users\你的用户名\AppData\Local\Android\Sdk。Path在Path变量中新增以下条目注意是新增不是覆盖%JAVA_HOME%\bin%ANDROID_HOME%\platform-tools%ANDROID_HOME%\tools%ANDROID_HOME%\tools\bin以及Node.js和npm的安装路径通常安装Node.js时会自动添加实操心得每次修改环境变量后必须重新启动命令行终端CMD或PowerShell甚至重启电脑以确保新的环境变量生效。这是一个高频踩坑点。3. 步步为营Windows平台完整安装实战现在让我们开始动手。请严格按照顺序操作。3.1 第一步安装与配置JDK下载前往Oracle官网或AdoptOpenJDK等开源站点下载JDK 8或11的Windows x64安装包.msi格式。安装运行安装程序记住你的安装路径。例如安装到C:\Java\jdk-11。配置环境变量打开“系统属性” - “高级” - “环境变量”。在“系统变量”部分点击“新建”变量名JAVA_HOME变量值C:\Java\jdk-11你的实际路径。找到“系统变量”中的Path点击“编辑”点击“新建”添加%JAVA_HOME%\bin。验证打开新的命令行窗口输入java -version和javac -version。如果正确显示版本号说明成功。3.2 第二步通过Android Studio安装Android SDK下载Android Studio从官网下载安装程序。安装运行安装程序在选择组件时确保勾选Android Virtual Device用于创建模拟器。其他按默认即可。首次运行与SDK配置首次启动会提示安装SDK。如果未提示可在启动后进入Settings-Appearance Behavior-System Settings-Android SDK。在SDK Platforms标签页选择一个Android版本进行安装例如 Android 13.0 (Tiramisu)。务必勾选“Show Package Details”然后确保安装Android SDK Platform和对应版本的Intel x86 Atom_64 System Image或Google APIs Intel x86 Atom_64 System Image用于创建模拟器。切换到SDK Tools标签页。同样勾选“Show Package Details”。必须安装Android SDK Build-Tools(选择一个版本如33.0.0)Android SDK Platform-Tools(会自动更新adb)Android EmulatorAndroid SDK Command-line Tools (latest)定位SDK路径并配置环境变量SDK默认安装路径通常是C:\Users\[你的用户名]\AppData\Local\Android\Sdk。设置系统变量ANDROID_HOME为上述路径。编辑Path添加提到的几个条目。验证新开命令行输入adb version。应显示ADB版本号。3.3 第三步安装Node.js与Appium安装Node.js从官网下载LTS版本的Windows安装包默认安装即可。验证Node.js与npm命令行输入node -v和npm -v显示版本号即成功。安装Appium Server (命令行版)打开命令行建议以管理员身份运行避免权限问题。执行命令npm install -g appium。-g表示全局安装。安装完成后执行appium -v验证。安装Appium DriversAppium 2.0之后驱动需要单独安装。对于Android我们需要安装UIAutomator2驱动appium driver install uiautomator2。可选安装Appium Desktop如果你喜欢图形界面可以从GitHub Releases页面下载最新的.exe安装包。它内部也集成了Server和Inspector。3.4 第四步准备测试设备——模拟器与真机使用Android模拟器 (AVD):打开Android Studio点击More Actions-Virtual Device Manager。点击“Create Device”选择一个设备定义如Pixel 5。选择之前下载好的系统镜像如Tiramisu。完成创建后点击启动。首次启动较慢。连接Android真机:手机开启“开发者模式”通常是在“关于手机”里连续点击“版本号”7次。在开发者选项中开启“USB调试”。用USB线连接电脑。在手机上弹出的“允许USB调试吗”对话框中点击“确定”。命令行输入adb devices。如果看到设备序列号后面跟着device而不是unauthorized说明连接成功。注意事项部分国产手机如小米、华为可能需要额外在开发者选项中开启“USB调试安全设置”或“仅充电模式下允许ADB调试”才能正常连接。4. 编写与运行你的第一个Appium测试脚本环境就绪设备就位是时候让代码跑起来了。我们以Python语言为例因为它语法简洁是自动化测试的热门选择。当然你也完全可以用Java、JavaScript等。4.1 初始化Python项目与依赖安装Python确保你的Windows已安装Python 3.7及以上版本。创建项目目录新建一个文件夹例如appium_demo。安装必要库在项目目录下打开命令行执行pip install Appium-Python-Client pip install seleniumAppium-Python-Client是Appium官方提供的Python客户端库。4.2 剖析第一个测试脚本计算器自动化我们来写一个打开系统计算器然后进行“123”计算的简单脚本。请将以下代码保存为test_calculator.py。from appium import webdriver from appium.webdriver.common.appiumby import AppiumBy import time # 1. 定义设备能力和App信息 desired_caps { platformName: Android, # 平台 platformVersion: 13, # 安卓版本根据你的设备修改 deviceName: emulator-5554, # 设备名通过 adb devices 获取 automationName: UiAutomator2, # 自动化引擎必须和安装的driver一致 appPackage: com.google.android.calculator, # 计算器的包名 appActivity: com.android.calculator2.Calculator, # 计算器的启动Activity noReset: True # 不重置应用状态避免每次清空数据 } # 2. 连接Appium Server # 默认情况下Appium Server运行在本地4723端口 driver webdriver.Remote(http://localhost:4723, desired_caps) # 等待应用加载 time.sleep(2) try: # 3. 定位元素并操作 # 点击数字 1 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/digit_1).click() # 点击加号 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/op_add).click() # 点击数字 2 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/digit_2).click() # 点击等号 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/eq).click() # 4. 获取结果并断言 result driver.find_element(AppiumBy.ID, com.google.android.calculator:id/result_final).text print(f计算结果为{result}) assert result 3, f断言失败期望结果是3实际是{result} print(测试通过) except Exception as e: print(f测试过程中发生错误{e}) finally: # 5. 无论成功与否最后都要关闭会话 driver.quit()4.3 脚本执行全流程启动Appium Server命令行方式新开一个命令行窗口输入appium。看到[Appium] Welcome to Appium v2.x.x和[Appium] Appium REST http interface listener started on 0.0.0.0:4723即表示启动成功。这个窗口不能关闭。Desktop方式启动Appium Desktop点击“Start Server”按钮。启动你的Android设备模拟器或已连接的真机。修改脚本中的能力配置platformVersion改为你设备的安卓版本。deviceName改为adb devices命令列出的设备名称。对于模拟器通常是emulator-5554。运行脚本在项目目录下执行python test_calculator.py。如果一切顺利你将看到模拟器或真机自动打开计算器并完成一次加法运算命令行打印出“计算结果为3”和“测试通过”。5. 核心技能进阶元素定位与等待策略第一个脚本跑通只是开始。真实的App页面复杂得多稳定的元素定位和合理的等待是编写健壮测试脚本的基石。5.1 Appium Inspector你的“元素侦查兵”你不能靠猜来写元素ID。Appium Desktop内置的Inspector或者独立的Appium Inspector工具是用来获取元素信息的利器。启动Appium Server确保automationName: UiAutomator2。在Appium Desktop中配置好同样的desired_caps去掉appPackage和appActivity先不启动App点击“Start Session”。工具会启动你设备上的一个待测App或你指定的App并加载出当前页面的UI层级树。你可以点击屏幕上的元素右侧会显示其各种定位信息resource-id(对应ID),text,content-desc,class等。使用“Tap”按钮可以模拟点击验证定位是否正确。5.2 八大元素定位策略详解在脚本中我们通过driver.find_element(By.XXX, ‘value’)来定位元素。AppiumBy继承了Selenium的By类并增加了一些移动端特有的方式。定位方式对应AppiumBy中的属性示例以计算器数字1为例适用场景与优缺点IDAppiumBy.IDidcom.google.android.calculator:id/digit_1首选。唯一性高定位最快最稳定。需要App开发给元素添加resource-id。Accessibility IDAppiumBy.ACCESSIBILITY_IDaccessibility_id某种描述对应元素的content-desc属性。为无障碍功能设计通常语义化是次优选择。XPathAppiumBy.XPATHxpath//android.widget.Button[text1]功能最强大可以通过层级、属性任意组合定位。但性能最差且易因UI改动而失效慎用。Class NameAppiumBy.CLASS_NAMEclass_nameandroid.widget.Button根据控件类型定位。通常一个页面同类控件太多不唯一常与其他方式结合使用。Android UIAutomatorAppiumBy.ANDROID_UIAUTOMATOR-Android原生强大的定位方式可以使用UIAutomator API的表达式如new UiSelector().text(1)。定位精准但语法稍复杂。iOS Predicate StringAppiumBy.IOS_PREDICATE-iOS原生强大的定位方式语法简洁灵活。仅用于iOS。iOS Class ChainAppiumBy.IOS_CLASS_CHAIN-另一种iOS定位方式性能优于XPath。仅用于iOS。Name (已废弃)AppiumBy.NAME-早期方式基本被Accessibility ID替代。实操心得定位策略的优先级应该是ID Accessibility ID Android UIAutomator/iOS Predicate Class Name XPath。尽量让开发同学为可操作元素添加唯一的resource-id这是提升自动化脚本稳定性和维护性的最有效手段。5.3 等待机制告别“NoSuchElementException”网络延迟、页面渲染速度都会导致元素尚未出现就执行操作从而报错。有三种等待方式强制等待time.sleep(秒数)。简单粗暴但效率低下无法适应动态加载。不建议在正式脚本中使用仅用于临时调试。隐式等待driver.implicitly_wait(秒数)。设置一个全局等待时间在查找每一个元素时如果找不到会持续等待直到超时。只需要设置一次。driver.implicitly_wait(10) # 后续所有find_element操作最多等10秒显式等待最推荐的方式。针对某个特定条件进行等待条件满足后立即继续更加智能高效。from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC # 等待“计算器结果框”出现最多等15秒每0.5秒检查一次 result_element WebDriverWait(driver, 15).until( EC.presence_of_element_located((AppiumBy.ID, ‘com.google.android.calculator:id/result_final’)) ) # 等待元素可点击 button WebDriverWait(driver, 10).until( EC.element_to_be_clickable((AppiumBy.ID, ‘some_button_id’)) ).click()组合策略通常的做法是设置一个较短的全局隐式等待如5秒作为保底。然后在关键步骤如页面跳转、网络请求后使用显式等待确保元素在可交互状态再进行操作。6. 常见问题排查与实战技巧实录即使按照教程一步步来也难免会遇到问题。这里汇总了我遇到的一些典型问题及解决方案。6.1 环境与连接类问题问题1adb devices列表为空或设备状态为unauthorized。排查USB线是否完好换一根线或USB口试试。手机是否弹出“允许USB调试”的提示勾选“始终允许”后确定。开发者选项中的“USB调试”是否确定已开启对于部分电脑可能需要安装手机对应的USB驱动。解决重新插拔USB线重启adb服务命令行执行adb kill-server然后adb start-server。问题2启动Appium Server时报错端口4723被占用。解决查找占用端口的进程netstat -ano | findstr :4723。记录PID在任务管理器中结束对应进程。或者启动Appium时指定其他端口appium -p 4724并在脚本中修改连接地址为http://localhost:4724。问题3运行脚本时报SessionNotCreatedException提示无法创建会话。排查desired_caps配置是否正确特别是platformVersion,deviceName,appPackage,appActivity。appPackage和appActivity是否正确可以用adb shell dumpsys window | findstr mCurrentFocus命令查看当前前台应用的这两个信息。Appium Server的日志就是启动Appium的那个命令行窗口里有更详细的错误信息是排查的金矿。6.2 脚本与执行类问题问题4元素定位失败抛出NoSuchElementException。排查定位符写错了用Inspector再确认一遍ID或XPath。页面还没加载出来增加显式等待。页面有WebView或混合应用需要切换上下文Context才能定位WebView内的元素。使用driver.contexts获取所有上下文然后driver.switch_to.context(‘WEBVIEW_xxx’)进行切换。元素在屏幕外或不可见可能需要先滑动屏幕。使用driver.swipe()或driver.find_element().location_once_scrolled_into_view。问题5在模拟器上运行正常在真机上失败。排查分辨率与缩放真机和模拟器的屏幕尺寸、密度可能不同导致基于坐标的操作失效。尽量避免使用基于坐标的绝对定位。系统差异不同手机厂商小米、华为、OPPO等对原生Android有定制可能导致某些控件属性或行为不一致。定位时优先使用resource-id它相对最稳定。性能差异真机可能更卡顿需要增加等待时间。6.3 独家避坑技巧日志是你的最佳伙伴永远不要忽略Appium Server的控制台输出和生成的日志文件。错误信息、设备通信详情都在里面。启动Server时可以用--log-level debug参数获取更详细日志。能力配置Desired Capabilities字典化将desired_caps写成JSON或YAML文件单独管理针对不同设备、不同App使用不同的配置文件使脚本更清晰。使用Page Object模式当测试用例增多时不要把所有元素定位和操作都写在测试脚本里。将每个页面封装成一个类元素定位是类的属性操作是类的方法。这样UI一变你只需要改一个地方极大提升可维护性。模拟器快照对于需要重复安装、登录的复杂测试可以利用模拟器的“快照”功能。在干净的状态下创建一个快照每次测试前恢复到这个快照能节省大量准备时间。真机设备池管理如果有多台真机可以考虑使用Appium Grid或STF等工具进行设备池化管理实现测试任务的自动调度。走到这里你已经成功在Windows上搭建了Appium环境并运行了第一个自动化测试脚本理解了核心的定位和等待机制。自动化测试之路环境搭建只是第一步后续还有框架设计如pytest/unittest、测试报告生成、持续集成等更广阔的天地。但请记住所有复杂的能力都源于今天这样一次成功的“Hello World”。当你下次再遇到环境问题时不妨回头看看这篇指南理清组件之间的关系耐心查看日志问题总能迎刃而解。
Windows平台Appium自动化测试环境搭建与实战指南
发布时间：2026/6/30 18:14:44
1. 项目概述为什么要在Windows上折腾Appium如果你是一名移动端测试工程师或者是一个对自动化测试感兴趣的后端、前端开发者那么“Appium”这个名字对你来说一定不陌生。它被誉为移动端自动化测试的“瑞士军刀”一个开源工具能让你用同一套代码去测试Android和iOS应用听起来就很酷对吧但很多朋友尤其是刚入门的新手往往在第一步——环境搭建上就栽了跟头特别是在Windows平台。网上的教程要么版本过时要么步骤跳跃照着做总会出现各种稀奇古怪的报错让人头大。这篇内容就是为你准备的。我将以一个在Windows 10/11系统上从零开始搭建一套稳定、可用的Appium自动化测试环境的完整过程拆解给你看。这不仅仅是一个“下一步、下一步”的安装指南我会把每一步背后的逻辑、可能遇到的坑以及我踩过之后总结的避坑技巧都毫无保留地分享出来。我们的目标很明确让你在Windows电脑上成功运行起第一个Appium测试脚本并能稳定地连接到Android模拟器或真机进行自动化操作。无论你是为了提升测试效率还是为了学习一项硬核技能这篇实战指南都将是你可靠的起点。2. 环境准备与核心组件解析在开始安装之前我们必须搞清楚Appium在Windows上运行需要哪些“零件”。它不是单一软件而是一个由多个核心组件协同工作的生态系统。理解它们能让你在出问题时快速定位。2.1 核心四大件JDK、Android SDK、Node.js与Appium Server1. Java Development Kit (JDK)作用Appium Server本身是用Java写的虽然2.0后核心用Node.js了但很多底层驱动和Android工具链依然依赖Java环境同时它也是编译和运行Android应用的基础。版本选择强烈推荐使用JDK 8或JDK 11LTS长期支持版。更高的版本如JDK 17虽然也可以用但可能与某些旧的Android构建工具产生兼容性问题。对于自动化测试环境稳定压倒一切。避坑点安装后务必配置JAVA_HOME系统环境变量并确保%JAVA_HOME%\bin添加到Path中。这是后续所有工具能正确找到Java的关键。2. Android SDK (Software Development Kit)作用这是与Android设备通信的桥梁。Appium需要通过SDK里的工具如adb,aapt来安装应用、获取设备信息、发送点击事件等。安装演变过去我们需要单独下载庞大的SDK现在谷歌推荐并通过Android Studio进行管理和下载。对于测试工程师我们完全可以只安装Android Studio来获取SDK而不必用它进行开发。核心工具安装后你需要关注%ANDROID_HOME%\platform-tools目录下的adb.exeAndroid调试桥它是与设备通信的核心命令工具。3. Node.js 与 npm作用Appium Server从2.0版本开始其核心是一个Node.js应用。我们需要Node.js环境来安装和运行它。npm是Node.js的包管理器用来安装Appium。版本选择选择最新的LTS版本即可。安装Node.js时会自动安装npm。4. Appium Server作用这是大脑和调度中心。它接收你编写的测试脚本通过WebDriver协议将其翻译成设备能够理解的操作指令通过UIAutomator2 for Android, XCUITest for iOS并下发给设备执行。两种形式Appium Desktop一个带图形界面的应用程序包含Server和元素定位工具Inspector适合新手入门和调试。Appium Server (via npm)通过命令行安装和启动的纯服务器更轻量更适合集成到CI/CD流水线中。2.2 环境变量配置让系统找到你的工具这是Windows平台最易出错的一环。很多“命令不是内部或外部命令”的错误都源于此。你需要配置的系统环境变量主要有三个JAVA_HOME指向你的JDK安装目录例如C:\Program Files\Java\jdk-11.0.xx。ANDROID_HOME指向你的Android SDK根目录例如C:\Users\你的用户名\AppData\Local\Android\Sdk。Path在Path变量中新增以下条目注意是新增不是覆盖%JAVA_HOME%\bin%ANDROID_HOME%\platform-tools%ANDROID_HOME%\tools%ANDROID_HOME%\tools\bin以及Node.js和npm的安装路径通常安装Node.js时会自动添加实操心得每次修改环境变量后必须重新启动命令行终端CMD或PowerShell甚至重启电脑以确保新的环境变量生效。这是一个高频踩坑点。3. 步步为营Windows平台完整安装实战现在让我们开始动手。请严格按照顺序操作。3.1 第一步安装与配置JDK下载前往Oracle官网或AdoptOpenJDK等开源站点下载JDK 8或11的Windows x64安装包.msi格式。安装运行安装程序记住你的安装路径。例如安装到C:\Java\jdk-11。配置环境变量打开“系统属性” - “高级” - “环境变量”。在“系统变量”部分点击“新建”变量名JAVA_HOME变量值C:\Java\jdk-11你的实际路径。找到“系统变量”中的Path点击“编辑”点击“新建”添加%JAVA_HOME%\bin。验证打开新的命令行窗口输入java -version和javac -version。如果正确显示版本号说明成功。3.2 第二步通过Android Studio安装Android SDK下载Android Studio从官网下载安装程序。安装运行安装程序在选择组件时确保勾选Android Virtual Device用于创建模拟器。其他按默认即可。首次运行与SDK配置首次启动会提示安装SDK。如果未提示可在启动后进入Settings-Appearance Behavior-System Settings-Android SDK。在SDK Platforms标签页选择一个Android版本进行安装例如 Android 13.0 (Tiramisu)。务必勾选“Show Package Details”然后确保安装Android SDK Platform和对应版本的Intel x86 Atom_64 System Image或Google APIs Intel x86 Atom_64 System Image用于创建模拟器。切换到SDK Tools标签页。同样勾选“Show Package Details”。必须安装Android SDK Build-Tools(选择一个版本如33.0.0)Android SDK Platform-Tools(会自动更新adb)Android EmulatorAndroid SDK Command-line Tools (latest)定位SDK路径并配置环境变量SDK默认安装路径通常是C:\Users\[你的用户名]\AppData\Local\Android\Sdk。设置系统变量ANDROID_HOME为上述路径。编辑Path添加提到的几个条目。验证新开命令行输入adb version。应显示ADB版本号。3.3 第三步安装Node.js与Appium安装Node.js从官网下载LTS版本的Windows安装包默认安装即可。验证Node.js与npm命令行输入node -v和npm -v显示版本号即成功。安装Appium Server (命令行版)打开命令行建议以管理员身份运行避免权限问题。执行命令npm install -g appium。-g表示全局安装。安装完成后执行appium -v验证。安装Appium DriversAppium 2.0之后驱动需要单独安装。对于Android我们需要安装UIAutomator2驱动appium driver install uiautomator2。可选安装Appium Desktop如果你喜欢图形界面可以从GitHub Releases页面下载最新的.exe安装包。它内部也集成了Server和Inspector。3.4 第四步准备测试设备——模拟器与真机使用Android模拟器 (AVD):打开Android Studio点击More Actions-Virtual Device Manager。点击“Create Device”选择一个设备定义如Pixel 5。选择之前下载好的系统镜像如Tiramisu。完成创建后点击启动。首次启动较慢。连接Android真机:手机开启“开发者模式”通常是在“关于手机”里连续点击“版本号”7次。在开发者选项中开启“USB调试”。用USB线连接电脑。在手机上弹出的“允许USB调试吗”对话框中点击“确定”。命令行输入adb devices。如果看到设备序列号后面跟着device而不是unauthorized说明连接成功。注意事项部分国产手机如小米、华为可能需要额外在开发者选项中开启“USB调试安全设置”或“仅充电模式下允许ADB调试”才能正常连接。4. 编写与运行你的第一个Appium测试脚本环境就绪设备就位是时候让代码跑起来了。我们以Python语言为例因为它语法简洁是自动化测试的热门选择。当然你也完全可以用Java、JavaScript等。4.1 初始化Python项目与依赖安装Python确保你的Windows已安装Python 3.7及以上版本。创建项目目录新建一个文件夹例如appium_demo。安装必要库在项目目录下打开命令行执行pip install Appium-Python-Client pip install seleniumAppium-Python-Client是Appium官方提供的Python客户端库。4.2 剖析第一个测试脚本计算器自动化我们来写一个打开系统计算器然后进行“123”计算的简单脚本。请将以下代码保存为test_calculator.py。from appium import webdriver from appium.webdriver.common.appiumby import AppiumBy import time # 1. 定义设备能力和App信息 desired_caps { platformName: Android, # 平台 platformVersion: 13, # 安卓版本根据你的设备修改 deviceName: emulator-5554, # 设备名通过 adb devices 获取 automationName: UiAutomator2, # 自动化引擎必须和安装的driver一致 appPackage: com.google.android.calculator, # 计算器的包名 appActivity: com.android.calculator2.Calculator, # 计算器的启动Activity noReset: True # 不重置应用状态避免每次清空数据 } # 2. 连接Appium Server # 默认情况下Appium Server运行在本地4723端口 driver webdriver.Remote(http://localhost:4723, desired_caps) # 等待应用加载 time.sleep(2) try: # 3. 定位元素并操作 # 点击数字 1 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/digit_1).click() # 点击加号 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/op_add).click() # 点击数字 2 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/digit_2).click() # 点击等号 driver.find_element(AppiumBy.ID, com.google.android.calculator:id/eq).click() # 4. 获取结果并断言 result driver.find_element(AppiumBy.ID, com.google.android.calculator:id/result_final).text print(f计算结果为{result}) assert result 3, f断言失败期望结果是3实际是{result} print(测试通过) except Exception as e: print(f测试过程中发生错误{e}) finally: # 5. 无论成功与否最后都要关闭会话 driver.quit()4.3 脚本执行全流程启动Appium Server命令行方式新开一个命令行窗口输入appium。看到[Appium] Welcome to Appium v2.x.x和[Appium] Appium REST http interface listener started on 0.0.0.0:4723即表示启动成功。这个窗口不能关闭。Desktop方式启动Appium Desktop点击“Start Server”按钮。启动你的Android设备模拟器或已连接的真机。修改脚本中的能力配置platformVersion改为你设备的安卓版本。deviceName改为adb devices命令列出的设备名称。对于模拟器通常是emulator-5554。运行脚本在项目目录下执行python test_calculator.py。如果一切顺利你将看到模拟器或真机自动打开计算器并完成一次加法运算命令行打印出“计算结果为3”和“测试通过”。5. 核心技能进阶元素定位与等待策略第一个脚本跑通只是开始。真实的App页面复杂得多稳定的元素定位和合理的等待是编写健壮测试脚本的基石。5.1 Appium Inspector你的“元素侦查兵”你不能靠猜来写元素ID。Appium Desktop内置的Inspector或者独立的Appium Inspector工具是用来获取元素信息的利器。启动Appium Server确保automationName: UiAutomator2。在Appium Desktop中配置好同样的desired_caps去掉appPackage和appActivity先不启动App点击“Start Session”。工具会启动你设备上的一个待测App或你指定的App并加载出当前页面的UI层级树。你可以点击屏幕上的元素右侧会显示其各种定位信息resource-id(对应ID),text,content-desc,class等。使用“Tap”按钮可以模拟点击验证定位是否正确。5.2 八大元素定位策略详解在脚本中我们通过driver.find_element(By.XXX, ‘value’)来定位元素。AppiumBy继承了Selenium的By类并增加了一些移动端特有的方式。定位方式对应AppiumBy中的属性示例以计算器数字1为例适用场景与优缺点IDAppiumBy.IDidcom.google.android.calculator:id/digit_1首选。唯一性高定位最快最稳定。需要App开发给元素添加resource-id。Accessibility IDAppiumBy.ACCESSIBILITY_IDaccessibility_id某种描述对应元素的content-desc属性。为无障碍功能设计通常语义化是次优选择。XPathAppiumBy.XPATHxpath//android.widget.Button[text1]功能最强大可以通过层级、属性任意组合定位。但性能最差且易因UI改动而失效慎用。Class NameAppiumBy.CLASS_NAMEclass_nameandroid.widget.Button根据控件类型定位。通常一个页面同类控件太多不唯一常与其他方式结合使用。Android UIAutomatorAppiumBy.ANDROID_UIAUTOMATOR-Android原生强大的定位方式可以使用UIAutomator API的表达式如new UiSelector().text(1)。定位精准但语法稍复杂。iOS Predicate StringAppiumBy.IOS_PREDICATE-iOS原生强大的定位方式语法简洁灵活。仅用于iOS。iOS Class ChainAppiumBy.IOS_CLASS_CHAIN-另一种iOS定位方式性能优于XPath。仅用于iOS。Name (已废弃)AppiumBy.NAME-早期方式基本被Accessibility ID替代。实操心得定位策略的优先级应该是ID Accessibility ID Android UIAutomator/iOS Predicate Class Name XPath。尽量让开发同学为可操作元素添加唯一的resource-id这是提升自动化脚本稳定性和维护性的最有效手段。5.3 等待机制告别“NoSuchElementException”网络延迟、页面渲染速度都会导致元素尚未出现就执行操作从而报错。有三种等待方式强制等待time.sleep(秒数)。简单粗暴但效率低下无法适应动态加载。不建议在正式脚本中使用仅用于临时调试。隐式等待driver.implicitly_wait(秒数)。设置一个全局等待时间在查找每一个元素时如果找不到会持续等待直到超时。只需要设置一次。driver.implicitly_wait(10) # 后续所有find_element操作最多等10秒显式等待最推荐的方式。针对某个特定条件进行等待条件满足后立即继续更加智能高效。from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC # 等待“计算器结果框”出现最多等15秒每0.5秒检查一次 result_element WebDriverWait(driver, 15).until( EC.presence_of_element_located((AppiumBy.ID, ‘com.google.android.calculator:id/result_final’)) ) # 等待元素可点击 button WebDriverWait(driver, 10).until( EC.element_to_be_clickable((AppiumBy.ID, ‘some_button_id’)) ).click()组合策略通常的做法是设置一个较短的全局隐式等待如5秒作为保底。然后在关键步骤如页面跳转、网络请求后使用显式等待确保元素在可交互状态再进行操作。6. 常见问题排查与实战技巧实录即使按照教程一步步来也难免会遇到问题。这里汇总了我遇到的一些典型问题及解决方案。6.1 环境与连接类问题问题1adb devices列表为空或设备状态为unauthorized。排查USB线是否完好换一根线或USB口试试。手机是否弹出“允许USB调试”的提示勾选“始终允许”后确定。开发者选项中的“USB调试”是否确定已开启对于部分电脑可能需要安装手机对应的USB驱动。解决重新插拔USB线重启adb服务命令行执行adb kill-server然后adb start-server。问题2启动Appium Server时报错端口4723被占用。解决查找占用端口的进程netstat -ano | findstr :4723。记录PID在任务管理器中结束对应进程。或者启动Appium时指定其他端口appium -p 4724并在脚本中修改连接地址为http://localhost:4724。问题3运行脚本时报SessionNotCreatedException提示无法创建会话。排查desired_caps配置是否正确特别是platformVersion,deviceName,appPackage,appActivity。appPackage和appActivity是否正确可以用adb shell dumpsys window | findstr mCurrentFocus命令查看当前前台应用的这两个信息。Appium Server的日志就是启动Appium的那个命令行窗口里有更详细的错误信息是排查的金矿。6.2 脚本与执行类问题问题4元素定位失败抛出NoSuchElementException。排查定位符写错了用Inspector再确认一遍ID或XPath。页面还没加载出来增加显式等待。页面有WebView或混合应用需要切换上下文Context才能定位WebView内的元素。使用driver.contexts获取所有上下文然后driver.switch_to.context(‘WEBVIEW_xxx’)进行切换。元素在屏幕外或不可见可能需要先滑动屏幕。使用driver.swipe()或driver.find_element().location_once_scrolled_into_view。问题5在模拟器上运行正常在真机上失败。排查分辨率与缩放真机和模拟器的屏幕尺寸、密度可能不同导致基于坐标的操作失效。尽量避免使用基于坐标的绝对定位。系统差异不同手机厂商小米、华为、OPPO等对原生Android有定制可能导致某些控件属性或行为不一致。定位时优先使用resource-id它相对最稳定。性能差异真机可能更卡顿需要增加等待时间。6.3 独家避坑技巧日志是你的最佳伙伴永远不要忽略Appium Server的控制台输出和生成的日志文件。错误信息、设备通信详情都在里面。启动Server时可以用--log-level debug参数获取更详细日志。能力配置Desired Capabilities字典化将desired_caps写成JSON或YAML文件单独管理针对不同设备、不同App使用不同的配置文件使脚本更清晰。使用Page Object模式当测试用例增多时不要把所有元素定位和操作都写在测试脚本里。将每个页面封装成一个类元素定位是类的属性操作是类的方法。这样UI一变你只需要改一个地方极大提升可维护性。模拟器快照对于需要重复安装、登录的复杂测试可以利用模拟器的“快照”功能。在干净的状态下创建一个快照每次测试前恢复到这个快照能节省大量准备时间。真机设备池管理如果有多台真机可以考虑使用Appium Grid或STF等工具进行设备池化管理实现测试任务的自动调度。走到这里你已经成功在Windows上搭建了Appium环境并运行了第一个自动化测试脚本理解了核心的定位和等待机制。自动化测试之路环境搭建只是第一步后续还有框架设计如pytest/unittest、测试报告生成、持续集成等更广阔的天地。但请记住所有复杂的能力都源于今天这样一次成功的“Hello World”。当你下次再遇到环境问题时不妨回头看看这篇指南理清组件之间的关系耐心查看日志问题总能迎刃而解。
![华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
![华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
