告别adb shell：用Python脚本一键搞定Android屏幕截图与导出

Python自动化告别adb shell一键搞定Android屏幕截图与导出每次调试Android应用时手动敲adb命令截图、导出、重命名是不是让你感到效率低下作为一名长期与Android设备打交道的开发者我深知这种重复劳动的痛苦。本文将分享如何用Python脚本彻底告别adb shell的繁琐操作实现全自动化的屏幕截图工作流。1. 为什么需要自动化截图工具在日常开发中我们经常需要截取设备屏幕状态。无论是调试UI布局、记录测试步骤还是生成产品演示素材截图都是高频操作。传统方式需要手动执行以下步骤连接设备并确保adb可用输入adb shell screencap -p /sdcard/temp.png执行adb pull /sdcard/temp.png手动重命名文件避免覆盖重复上述步骤进行批量截图这个过程不仅耗时还容易出错。通过Python脚本自动化我们可以节省时间一键完成截图、导出、命名全过程减少错误自动处理文件冲突和连接问题批量处理轻松实现定时或连续截图集成扩展与其他自动化工具无缝衔接2. 核心工具与准备工作2.1 环境配置在开始编写脚本前需要确保以下环境就绪# 检查adb是否可用 adb version # 确保设备已连接 adb devicesPython环境需要安装以下依赖pip install pillow # 用于图像处理2.2 ADB命令原理分析Android的截图功能主要通过screencap命令实现其核心参数如下参数说明示例-p保存为PNG格式screencap -p /sdcard/screen.png-d指定显示IDscreencap -d 4619827259835644672(无)输出原始数据到stdoutscreencap raw.data注意直接输出到stdout时数据包含4字节的宽度、高度等信息需要特殊处理3. Python自动化脚本实现3.1 基础截图功能封装首先实现最基本的截图和导出功能import subprocess import os import time def take_screenshot(device_idNone, output_dirscreenshots): 基础截图功能 if not os.path.exists(output_dir): os.makedirs(output_dir) timestamp time.strftime(%Y%m%d_%H%M%S) filename f{output_dir}/screen_{timestamp}.png # 设备选择参数 device_arg [-s, device_id] if device_id else [] try: # 截图并保存到设备 subprocess.run( [adb] device_arg [shell, screencap, -p, f/sdcard/{timestamp}.png], checkTrue ) # 导出到电脑 subprocess.run( [adb] device_arg [pull, f/sdcard/{timestamp}.png, filename], checkTrue ) # 删除设备上的临时文件 subprocess.run( [adb] device_arg [shell, rm, f/sdcard/{timestamp}.png], checkTrue ) return filename except subprocess.CalledProcessError as e: print(f截图失败: {e}) return None3.2 高级功能扩展基础版本已经能工作但我们可以添加更多实用功能自动重试机制def robust_screenshot(max_retries3, **kwargs): 带重试机制的截图 for attempt in range(max_retries): try: return take_screenshot(**kwargs) except Exception as e: if attempt max_retries - 1: raise time.sleep(1)多设备支持def get_connected_devices(): 获取已连接的设备列表 result subprocess.run( [adb, devices], capture_outputTrue, textTrue ) devices [] for line in result.stdout.splitlines()[1:]: if line.strip() and device in line: devices.append(line.split(\t)[0]) return devices定时截图功能def scheduled_screenshots(interval5, count10): 定时连续截图 for i in range(count): take_screenshot() time.sleep(interval)4. 工程化实践与优化4.1 性能优化技巧直接使用adb shell命令虽然简单但在高频截图场景下性能不佳。我们可以通过以下方式优化减少adb调用次数合并多个操作为一个shell命令使用stdout直接传输避免临时文件读写并行处理多设备同时截图优化后的核心代码示例def fast_screenshot(): 高性能截图实现 process subprocess.Popen( [adb, shell, screencap, -p], stdoutsubprocess.PIPE ) image_data, _ process.communicate() # 修复Android的换行符问题 image_data image_data.replace(b\r\n, b\n) with open(screenshot.png, wb) as f: f.write(image_data)4.2 错误处理与日志完善的错误处理是自动化脚本的关键import logging logging.basicConfig( filenamescreenshot.log, levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s ) def safe_screenshot(): try: filename take_screenshot() logging.info(f截图成功: {filename}) return filename except subprocess.CalledProcessError as e: logging.error(fADB命令执行失败: {e}) except FileNotFoundError: logging.error(ADB未找到请检查环境变量) except Exception as e: logging.error(f未知错误: {e})4.3 与其他工具集成我们可以将截图功能集成到更大的自动化框架中class AndroidAutomator: def __init__(self, device_idNone): self.device_id device_id def screenshot(self, filenameNone): 集成截图方法 if filename is None: filename fscreenshot_{int(time.time())}.png take_screenshot(device_idself.device_id, output_pathfilename) return filename # 可以添加其他自动化方法...5. 完整脚本示例与应用场景5.1 可直接运行的完整脚本#!/usr/bin/env python3 Android自动化截图工具 功能 1. 一键截图并保存到指定目录 2. 支持自动命名(时间戳) 3. 支持多设备选择 4. 带错误重试机制 import subprocess import os import time import argparse from datetime import datetime def parse_args(): parser argparse.ArgumentParser(descriptionAndroid自动化截图工具) parser.add_argument(-d, --device, help指定设备ID) parser.add_argument(-o, --output, defaultscreenshots, help输出目录(默认: screenshots)) parser.add_argument(-n, --count, typeint, default1, help截图次数) parser.add_argument(-i, --interval, typefloat, default1.0, help连续截图间隔(秒)) return parser.parse_args() def check_adb(): try: subprocess.run([adb, version], checkTrue, stdoutsubprocess.DEVNULL) return True except: return False def take_screenshot(deviceNone, output_dirscreenshots): 执行截图操作 if not os.path.exists(output_dir): os.makedirs(output_dir) timestamp datetime.now().strftime(%Y%m%d_%H%M%S_%f) filename os.path.join(output_dir, fscreen_{timestamp}.png) device_args [-s, device] if device else [] try: # 使用管道直接传输避免临时文件 with open(filename, wb) as f: subprocess.run( [adb] device_args [shell, screencap, -p], checkTrue, stdoutf ) print(f截图已保存: {filename}) return filename except subprocess.CalledProcessError as e: print(f截图失败: {e}) if os.path.exists(filename): os.remove(filename) return None def main(): args parse_args() if not check_adb(): print(错误: adb未找到请检查Android SDK配置) return print(f开始截图共{args.count}次间隔{args.interval}秒) for i in range(args.count): print(f\n第{i1}次截图...) success False for attempt in range(3): # 最多重试3次 if take_screenshot(args.device, args.output): success True break time.sleep(1) if not success: print(截图多次尝试失败请检查设备连接) break if i args.count - 1: # 最后一次不需要等待 time.sleep(args.interval) if __name__ __main__: main()5.2 典型应用场景UI自动化测试配合测试框架自动截图记录测试结果应用演示制作定时截图生成操作流程文档竞品分析批量采集其他应用的界面设计远程调试通过截图了解设备实际显示状态监控系统定期截图监控设备运行状态# 示例在UI测试中使用 from uiautomator import Device d Device(emulator-5554) d(textSettings).click() take_screenshot(after_click_settings.png)6. 进阶技巧与问题排查6.1 常见问题解决方案问题1截图出现黑屏或花屏可能原因设备屏幕已关闭使用了不支持的色彩模式设备性能不足解决方案# 唤醒设备后再截图 subprocess.run([adb, shell, input, keyevent, KEYCODE_WAKEUP]) time.sleep(0.5) # 等待屏幕完全唤醒 take_screenshot()问题2截图速度慢优化方案降低截图分辨率使用jpeg格式替代png关闭不必要的adb日志# 使用低分辨率截图 subprocess.run([ adb, shell, screencap, -p, --size, 720x1280, , screen.jpg ])6.2 高级功能实现实时屏幕监控import cv2 import numpy as np def realtime_preview(): 实时屏幕预览(需要OpenCV) while True: process subprocess.Popen( [adb, shell, screencap, -p], stdoutsubprocess.PIPE ) img_data process.stdout.read() # 转换图像数据 nparr np.frombuffer(img_data, np.uint8) img cv2.imdecode(nparr, cv2.IMREAD_COLOR) cv2.imshow(Android Screen, img) if cv2.waitKey(1) 0xFF ord(q): break cv2.destroyAllWindows()基于内容的自动截图from PIL import Image import imagehash def capture_until_change(threshold5): 检测到屏幕变化时自动截图 last_hash None while True: current_screen take_screenshot() with Image.open(current_screen) as img: current_hash imagehash.average_hash(img) if last_hash and (current_hash - last_hash) threshold: print(检测到屏幕变化!) return current_screen last_hash current_hash time.sleep(0.5)在实际项目中这套自动化截图系统为我节省了大量时间。特别是在需要收集大量测试截图时只需简单设置参数就能自动完成所有工作。最实用的功能是定时连续截图配合图像差异检测可以完美记录用户操作的完整流程。