### 在 PyCharm 中配置并创建 monkeyrunner 脚本 要在 PyCharm 中成功创建和运行 `monkeyrunner` 脚本，需要完成以下几部分的配置： #### 1. 安装与配置 Android SDK 确保已经正确安装了 Android SDK，并设置了环境变量以便可以在任何地方调用 `monkeyrunner` 工具。 - **设置环境变量**: 将 Android SDK 的 `tools` 和 `platform-tools` 添加到系统的 `Path` 环境变量中。例如： ``` E:\android_SDK\sdk\tools; E:\android_SDK\sdk\platform-tools; ``` #### 2. 配置 PyCharm 解释器 为了让 PyCharm 支持 `monkeyrunner` 脚本的编写，需要手动指定 Python 解析器路径。 ##### 设置步骤： - 打开 PyCharm，进入菜单栏中的 `File -> Settings -> Project: <Your_Project_Name> -> Python Interpreter`。 - 点击齿轮图标选择 `Add...` 来新增一个新的解释器。 - 在弹出窗口中选择 `System Interpreter`，然后点击右侧的文件夹图标浏览至 Jython 的可执行文件位置（通常位于 Android SDK 的 tools/lib 目录下）。例如： ``` E:\android_SDK\sdk\tools\lib\jython.jar ``` - 确认无误后点击 OK 完成解析器的选择[^3]。 #### 3. 导入必要模块 在新建的 `.py` 文件顶部引入所需的库以支持 `monkeyrunner` 功能实现。 ```python from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice ``` #### 4. 编写基本脚本逻辑 下面是一个简单的例子展示如何利用 `monkeyrunner` 启动某个应用程序并截取屏幕图像保存下来。 ```python def main(): # 等待设备连接 device = MonkeyRunner.waitForConnection() if not device: raise Exception('无法连接设备') print("设备已连接") package_name = 'com.example.app' activity_name = 'com.example.MainActivity' run_component = f'{package_name}/{activity_name}' device.startActivity(component=run_component) MonkeyRunner.sleep(5) screenshot = device.takeSnapshot() screenshot.writeToFile('./screenshot.png', 'png') if __name__ == '__main__': main() ``` #### 5. 配置运行/调试配置 为了能够在 IDE 内部直接触发脚本执行而不是每次都切换回命令行操作，还需要定义相应的 Run Configuration。 - 点击右上角的 `Edit Configurations...` 按钮。 - 点击左上方的加号 (+)，选择 `Python`。 - 填充 Name 字段为你希望显示的名字；Script path 应指向刚才编写的 .py 文件全路径名。 - 参数区域留空因为我们将通过标准入口函数控制流程走向。 - Working directory 设定为项目根目录或者其他合适的地方存储输出数据如截图等成果物。 - 最后记得关联之前建立好的特殊用途 jython interpreter 实例作为 Execution target。 完成后保存更改即可以按绿色三角形按钮一键启动测试过程而无需离开集成开发环境界面[^4]。 --- ### 注意事项 - 若发现仍然存在问题可能是因为某些低级依赖未满足或者版本冲突引起，请仔细核对各个组件之间的兼容关系。 - 当尝试多次仍失败时考虑重置整个工作区重新初始化所有相关设定直至找到根本原因所在为止。