android-emulator-skill
通过语义导航在Android模拟器上自动化构建、测试和操作应用。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：android-emulator-skill。 它的用途是：通过语义导航在Android模拟器上自动化构建、测试和操作应用。 完整的 Skill 内容见：https://321skill.com/skills/android-emulator-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我在模拟器上启动我的应用，然后找到登录按钮并点击，再在用户名输入框里填入测试账号。'，它会依次调用 `app_launcher.py`、`screen_mapper.py` 和 `navigator.py` 等脚本，以语义化的方式完成屏幕分析、元素查找和交互操作，并返回简洁的操作日志。
介绍
Android Emulator Skill 旨在解决开发者在Android应用自动化测试和交互中，依赖像素坐标、操作繁琐且难以维护的问题。它提供了一套基于无障碍服务（Accessibility）的Python脚本，允许开发者通过元素的文本、类型或资源ID等语义信息来定位和操作界面元素，从而实现精准且可读性高的自动化流程。
使用方式非常直接。开发者通过命令行调用不同的脚本，例如使用 screen_mapper.py 来获取当前屏幕的语义化结构，或使用 navigator.py 来查找并点击特定文本的按钮。所有脚本都支持 --help 查看详细参数，并可通过 --json 选项输出结构化数据，便于与其他工具集成。
这个Skill非常适合需要进行Android应用自动化测试、界面遍历、功能回归或构建CI/CD流水线的开发者。无论是测试工程师需要执行重复的测试用例，还是开发者在本地快速验证某个交互流程，都能从中受益。
使用前请确保已正确配置Android SDK环境变量（ANDROID_HOME和PATH），并安装Python 3.12+。对于涉及截图对比等高级功能，建议额外安装Pillow库。注意，其核心交互依赖于设备的无障碍服务，请确保模拟器或真机已开启相关选项。
核心特点
与同类基于图像识别或坐标点击的自动化工具不同，本Skill采用基于无障碍服务的语义导航，定位更精准、脚本可读性更高且不依赖屏幕分辨率；同时，其输出默认为简洁的3-5行摘要，显著优化了与大模型交互时的Token消耗。
注意事项
不适合需要在非Android系统（如iOS）或缺乏无障碍服务支持的环境中进行自动化操作的场景。
常见问题
这个Skill能用于真机测试吗？
可以，通过 `--serial` 参数指定设备序列号，支持连接和管理真实的Android设备。
和Appium有什么区别？
本Skill更轻量、脚本更简洁，专为与Claude等AI助手协同工作而设计，输出格式针对Token效率做了优化，适合快速自动化任务而非大型测试框架。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/android-emulator-skill/raw/index.md 读取 android-emulator-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/android-emulator-skill/raw/index.md（查看排版版本）