针对Python连接模拟器的需求，核心是通过Android Debug Bridge (ADB)建立通信通道，然后使用Python的`subprocess`模块或第三方库（如`pure-python-adb`）执行ADB命令来控制模拟器[ref_1][ref_3]。以下是详细的操作步骤和代码示例。 ### 1. 前置条件与环境准备 在连接前，需要确保以下工具已正确安装和配置。 | 工具/组件 | 作用 | 获取/安装方式 | | :--- | :--- | :--- | | **ADB (Android Debug Bridge)** | 与安卓设备（包括模拟器）通信的核心命令行工具。 | 通常包含在Android SDK的`platform-tools`目录中，也可单独下载[ref_3]。 | | **Python 3.x** | 运行自动化脚本的环境。 | 从Python官网下载安装。 | | **模拟器** | 安卓虚拟设备，如夜神、雷电、Mumu等。 | 从各模拟器官网下载安装[ref_1][ref_2][ref_3]。 | | **Python ADB库 (可选)** | 提供更Pythonic的ADB操作接口。 | 使用`pip install pure-python-adb`安装。 | **关键配置步骤：** 1. **配置ADB环境变量**：将ADB所在目录（如`C:\Android\platform-tools`）添加到系统的`PATH`环境变量中，以便在命令行或Python中直接调用`adb`命令[ref_3]。 2. **启动模拟器并开启调试**：确保模拟器已启动，并在其设置中开启“开发者选项”和“USB调试”模式[ref_2]。 ### 2. 连接模拟器与ADB 模拟器通常会监听一个特定的本地TCP端口以供ADB连接。首先需要获取并连接这个端口。 ```bash # 查看当前已连接的设备（包括模拟器） adb devices ``` 如果模拟器未出现在列表中，需要手动连接。不同模拟器的默认端口可能不同： * **夜神模拟器 (Nox)**： 端口`62001` (第一个实例，后续实例端口号递增)[ref_3][ref_4]。 * **雷电模拟器 (LDPlayer)**： 端口`5555`[ref_2]。 * **Mumu模拟器**： 端口`7555`[ref_1]。 使用以下命令进行连接： ```bash # 连接夜神模拟器 (示例) adb connect 127.0.0.1:62001 # 连接雷电模拟器 adb connect 127.0.0.1:5555 # 连接Mumu模拟器 adb connect 127.0.0.1:7555 ``` 连接成功后，再次运行`adb devices`，应能看到类似`127.0.0.1:62001 device`的条目[ref_3]。 ### 3. 使用Python进行连接与控制 #### 方法一：使用`subprocess`模块调用ADB命令 这是最直接、兼容性最好的方法。 ```python import subprocess import sys def run_adb_command(command): """执行ADB命令并返回结果。""" try: # 将完整的adb命令作为字符串列表传递 result = subprocess.run(['adb'] + command.split(), capture_output=True, text=True, check=True) return result.stdout.strip() except subprocess.CalledProcessError as e: print(f"命令执行失败: {e}") print(f"错误输出: {e.stderr}") return None def connect_to_emulator(emulator_port=62001): """连接到指定端口的模拟器。""" connect_cmd = f"connect 127.0.0.1:{emulator_port}" output = run_adb_command(connect_cmd) if output and "connected" in output.lower(): print(f"成功连接到模拟器 (127.0.0.1:{emulator_port})") return True else: print(f"连接失败: {output}") return False def get_connected_devices(): """获取已连接的设备列表。""" devices_output = run_adb_command("devices") if devices_output: # 解析输出，跳过第一行标题 lines = devices_output.split('\n')[1:] devices = [line.split('\t')[0] for line in lines if line.strip()] return devices return [] # --- 主程序示例 --- if __name__ == "__main__": # 1. 连接模拟器（以夜神为例） if connect_to_emulator(62001): # 2. 查看设备 device_list = get_connected_devices() print(f"当前连接的设备: {device_list}") # 3. 执行其他ADB操作，例如获取设备信息 if device_list: # 指定对第一个设备进行操作 device_serial = device_list[0] # 获取设备型号 model = run_adb_command(f"-s {device_serial} shell getprop ro.product.model") print(f"设备型号: {model}") # 安装APK (假设apk_path是本地APK文件路径) # apk_path = "your_app.apk" # install_output = run_adb_command(f"-s {device_serial} install -r {apk_path}") # print(f"安装结果: {install_output}") ``` 此方法通过Python的`subprocess`模块直接调用系统命令行的`adb`工具，可以执行所有ADB支持的功能，包括安装应用、推送文件、执行Shell命令等[ref_3]。 #### 方法二：使用第三方Python ADB库（如`pure-python-adb`） 这种方法提供了面向对象的接口，代码更简洁。 ```python # 首先安装库: pip install pure-python-adb from ppadb.client import Client as AdbClient def connect_with_lib(host='127.0.0.1', port=5037, emulator_port=62001): """ 使用pure-python-adb库连接模拟器。 host/port: ADB服务端地址，默认为本地和5037端口。 emulator_port: 模拟器监听端口。 """ # 1. 创建ADB客户端并连接到ADB服务端 client = AdbClient(host=host, port=port) # 2. 连接至模拟器（库内部会处理adb connect逻辑） # 注意：此库的`device`方法通常用于获取已连接的设备。 # 若要连接新设备，可能需要先通过`subprocess`执行`adb connect`，或确保模拟器已自动连接。 try: # 先尝试执行系统adb connect确保连接 import subprocess subprocess.run(['adb', 'connect', f'{host}:{emulator_port}'], capture_output=True) # 获取设备列表 devices = client.devices() if devices: print(f"找到 {len(devices)} 个设备:") for device in devices: print(f" 序列号: {device.serial}") # 示例：获取设备状态 state = device.get_state() print(f" 状态: {state}") # 示例：执行shell命令 # output = device.shell('pm list packages') # print(output) return devices else: print("未找到任何连接的设备。") return None except Exception as e: print(f"连接过程中发生错误: {e}") return None # 使用示例 if __name__ == "__main__": connected_devices = connect_with_lib(emulator_port=62001) ``` 这种方法抽象了底层的命令调用，但在处理初始连接时，有时仍需依赖传统的`adb connect`命令确保模拟器在ADB的设备列表中[ref_2]。 ### 4. 常见问题与排查 | 问题现象 | 可能原因 | 解决方案 | | :--- | :--- | :--- | | `adb devices` 无设备 | 1. ADB版本与模拟器不兼容。<br>2. 模拟器未开启USB调试。<br>3. 端口被占用或连接错误。 | 1. 更新ADB工具至最新版[ref_3]。<br>2. 确认模拟器设置中“开发者选项”和“USB调试”已开启[ref_2]。<br>3. 使用`netstat -ano`检查端口，并确认连接命令的IP和端口正确[ref_1]。 | | 连接被拒绝 | 模拟器的ADB服务未启动或端口未监听。 | 重启模拟器，并确保其网络桥接或设置正确（有时需在模拟器设置中重启ADB服务）[ref_4]。 | | 多个模拟器实例冲突 | 同时运行了多个模拟器实例，端口冲突。 | 为每个实例连接其对应的唯一端口（如夜神第二个实例为`62025`），或在Python脚本中通过`-s <serial>`指定操作设备[ref_3]。 | | Python执行`adb`命令报错 | 环境变量`PATH`中未包含`adb`，或Python未以适当权限运行。 | 使用`adb`的绝对路径（如`C:\\adb\\adb.exe`），或在Python中使用完整路径调用`subprocess`[ref_3]。 | ### 5. 进阶应用场景示例 成功连接后，Python脚本可以实现复杂的自动化操作。 **场景：自动安装APK并启动应用** ```python import subprocess import time def automate_app_install(device_serial, apk_path, package_name, main_activity): """自动化安装APK并启动应用。""" # 1. 安装应用 install_cmd = f"-s {device_serial} install -r {apk_path}" install_result = subprocess.run(['adb'] + install_cmd.split(), capture_output=True, text=True) if "Success" in install_result.stdout: print("APK安装成功。") # 2. 等待安装完成 time.sleep(2) # 3. 启动应用 launch_cmd = f"-s {device_serial} shell am start -n {package_name}/{main_activity}" launch_result = subprocess.run(['adb'] + launch_cmd.split(), capture_output=True, text=True) if "Error" not in launch_result.stdout: print("应用启动成功。") else: print(f"启动应用失败: {launch_result.stdout}") else: print(f"安装失败: {install_result.stdout}") # 使用示例 # automate_app_install('127.0.0.1:62001', 'my_app.apk', 'com.example.myapp', '.MainActivity') ``` **关键点总结**：Python连接模拟器的本质是**通过ADB建立桥梁**。首选方案是使用Python的`subprocess`模块直接调用ADB命令行，稳定且功能全面。在开始自动化脚本编写前，务必在命令行中手动测试`adb connect`和`adb devices`命令成功，这是所有后续操作的基础[ref_1][ref_3]。对于更复杂的UI自动化，可以在此基础上集成`uiautomator2`、`Appium`等框架[ref_4][ref_6]。