1. 环境准备Java 8与Android Studio安装在Windows 10系统上搭建MonkeyRunner测试环境首要任务是确保基础运行环境配置正确。我经历过多次环境配置失败最终发现Java版本的选择至关重要。1.1 Java 8安装与配置Oracle官方已停止Java 8的公开下载但通过Java Archive仍可获取。建议下载jdk-8u361-windows-x64.exe版本截至2023年3月的最新补丁。安装时需注意安装路径避免空格和中文如默认的C:\Program Files\Java\jdk1.8.0_361安装过程中关闭所有安全软件特别是国产输入法如百度输入法可能导致安装程序无响应安装完成后需要配置两个环境变量新建系统变量JAVA_HOME值为JDK安装路径在Path变量中添加%JAVA_HOME%\bin验证安装是否成功java -version # 应显示类似java version 1.8.0_361 javac -version # 应显示对应版本号1.2 Android Studio安装要点从官网下载Android Studio最新稳定版当前为2022.3.1。安装时特别注意自定义安装选项中必须勾选Android SDKAndroid SDK PlatformPerformance (Intel® HAXM)首次启动时的网络配置若出现代理设置弹窗选择No Proxy在SDK Manager中配置镜像源如阿里云镜像可加速下载SDK路径设置建议路径如E:\Android\SDK全英文无空格勾选Show Package Details确保安装完整组件2. SDK工具链配置与问题排查2.1 关键组件安装通过SDK Manager安装以下必要组件组件类别必须安装的组件版本要求SDK PlatformsAndroid 11.0 (API 30)与测试设备匹配SDK ToolsAndroid SDK Build-Tools30.0.3及以上Android SDK Platform-Tools最新版Android SDK Tools (Obsolete)26.1.1Android Emulator31.3.10及以上特别注意必须安装标记为Obsolete的旧版SDK Tools因为MonkeyRunner相关脚本存放在这些旧工具中。2.2 环境变量配置需要配置三个关键环境变量ANDROID_HOME指向SDK安装目录如E:\Android\SDKPath中添加%ANDROID_HOME%\platform-tools%ANDROID_HOME%\tools%ANDROID_HOME%\tools\bin验证配置adb version # 应显示版本号 monkeyrunner -version # 此时可能报错需继续后续配置3. MonkeyRunner脚本修复实战3.1 常见错误与修复方案首次运行monkeyrunner通常会遇到两类错误错误1SWT文件夹缺失SWT folder ..\framework\x86_64 does not exist. Please set ANDROID_SWT to point to the folder containing swt.jar解决方案定位到SDK目录下的tools\bin\monkeyrunner.bat修改以下内容:: 原始内容 set frameworkdir..\framework :: 修改为 set frameworkdir..\lib错误2adb.exe找不到Cannot run program ..\framework\adb.exe解决方案 继续修改monkeyrunner.bat:: 找到-Dcom.android.monkeyrunner.bindir参数 :: 原始值 -Dcom.android.monkeyrunner.bindir..\framework :: 修改为 -Dcom.android.monkeyrunner.bindir..\..\platform-tools3.2 批处理文件完整修改点以下是必须修改的四个关键位置framework目录指向set frameworkdir..\lib # 原为..\frameworkSWT路径设置set swt_path%ANDROID_HOME%\tools\lib # 明确指定绝对路径bindir参数修改-Dcom.android.monkeyrunner.bindir..\..\platform-toolsJava扩展目录-Djava.ext.dirs%frameworkdir%;%swt_path%4. 测试验证与自动化脚本开发4.1 基础功能测试成功配置后执行交互测试monkeyrunner # 进入交互界面后执行 from com.android.monkeyrunner import MonkeyRunner device MonkeyRunner.waitForConnection() device.touch(200, 500, DOWN_AND_UP)4.2 自动化脚本示例创建屏幕滑动脚本screen.py#!/usr/bin/env monkeyrunner import time from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice # 连接设备超时10秒 device MonkeyRunner.waitForConnection(10) # 滑动参数配置 start_point (300, 1500) # 起始坐标(x,y) end_point (300, 800) # 终点坐标 duration 0.5 # 滑动持续时间(秒) steps 10 # 滑动步数 interval 60 # 操作间隔(秒) for i in range(100): device.drag(start_point, end_point, duration, steps) MonkeyRunner.sleep(interval)执行脚本monkeyrunner screen.py4.3 进阶技巧截图比对功能# 截取屏幕 result device.takeSnapshot() # 保存参考图 reference MonkeyRunner.loadImageFromFile(reference.png) # 比对相似度 if result.sameAs(reference, 0.9): print(界面匹配成功) else: print(界面存在差异)按键操作封装def press_home(device): device.press(KEYCODE_HOME, MonkeyDevice.DOWN_AND_UP) def press_back(device): device.press(KEYCODE_BACK, MonkeyDevice.DOWN_AND_UP)异常处理try: device MonkeyRunner.waitForConnection(5) if not device: raise Exception(设备连接超时) except Exception as e: print(f测试失败: {str(e)}) exit(1)5. 常见问题解决方案5.1 设备连接问题现象adb devices列表为空但设备已连接检查USB调试是否开启执行adb kill-server adb start-server更换USB接口或数据线现象提示未授权在设备上勾选始终允许此计算机调试5.2 脚本执行异常Python缩进错误MonkeyRunner使用Python 2.7语法必须使用空格缩进建议4空格ImportError确保从com.android.monkeyrunner导入不要安装额外Python库5.3 性能优化建议减少截图频率截图操作耗时约0.5-1秒使用相对坐标适配不同分辨率设备增加等待时间关键操作后添加MonkeyRunner.sleep(1)关闭动画开发者选项中关闭所有动画效果6. 环境维护与升级6.1 组件版本兼容性记录当前稳定版本组合Java: 1.8.0_361Android SDK Tools: 26.1.1Platform-tools: 33.0.3Build-tools: 30.0.36.2 备份策略备份整个SDK目录下的tools文件夹导出环境变量配置set env_backup.txt保存修改过的批处理文件副本6.3 迁移到新机器复制整个SDK目录安装相同版本的Java 8重新配置环境变量验证monkeyrunner.bat中的路径我在实际使用中发现保持环境隔离非常重要。建议使用虚拟机或容器保存整套测试环境避免因系统更新导致环境失效。每次升级组件前先在测试机上验证兼容性。