Oh My Android

Oh My Android

测试 Android 应用在深色模式、大字体、RTL 和 TalkBack 下的表现：每项只需点击一次，无需运行 adb 命令。
一款免费的 Mac 原生 ADB GUI，停靠在 Android Emulator 旁边。也支持真机。

_{深色模式、字体大小、阿拉伯语 RTL、收到短信和来电。每项只需点击一次。}

brew install --cask ateymoori/tap/oh-my-android

_{或者下载来自 Releases 的已签名、经过公证的 zip · macOS 26 Tahoe+ · Apple silicon · 使用你已有的 Android SDK（详情）· ⭐ 点星支持，让更多 Android 开发者发现它}

• 🎛️ 近 50 项测试操作，始终可见。 深色模式、字体和显示大小、语言和区域设置（包括 RTL 和伪区域设置）、TalkBack、粗体文本、布局边界、显示点击、关闭动画、网络速度、GPS、来电和短信。每个图标都会显示设备的实际状态。
• 📐 适用于任何应用的 dp 布局检查器。 将鼠标悬停在视图上，即可查看其大小和周围间距（单位为 dp），Compose 和 Views 均适用。将 Figma 导出文件拖放到上方，对比设计与实现。⇧⌘A 可为 TalkBack 停靠项编号，并标记缺失的标签以及小于 48 dp 的触控目标。
• 🗄️ 无需 adb 即可检查调试版本。 读取 SharedPreferences 和 SQLite、清除数据、打开深层链接、拖放 APK 进行安装、重置权限。
• 🪶 原生且轻量。 使用 SwiftUI，由事件驱动，不含 Electron，也不收集遥测数据。免费且开源（MIT）。

为什么不直接用 Android Studio？ Studio 的设备 UI 快捷操作已支持一键切换深色模式、字体大小、 应用语言和 TalkBack（API 33+）。Studio 开启时可使用这些功能。Oh My Android 额外提供一个始终可见的面板， 适用于模拟器和手机，即使 Studio 关闭也能使用；还提供快捷操作不支持的切换项（粗体文本、 伪区域设置、布局边界、显示点击、动画），并可测量任何应用的 dp，而 Studio 的 布局检查器需要应用可调试。与 Studio、scrcpy 和 mobile-mcp 的比较：docs/COMPARISON.md。

🤖 正在使用 Claude Code、Codex 或 Cursor？ 此应用内置 MCP 服务（18 个工具），让你的 Agent 可以 以 dp 为单位截取模拟器画面、点击，以及切换深色模式或 RTL。开始设置 →

控制面板	布局检查器 + TalkBack 审查

功能 · adb 速查表 · 布局检查器 · AI Agent（MCP） · 故障排除 · 常见问题 · 参与贡献 · 网站

执行破坏性操作（清除数据、卸载、重置权限）前会先询问。

更新和要求

除了 Homebrew，你也可以从最新版本下载 zip 文件，解压后将 Oh My Android.app 移至 Applications。此应用已由 Apple 签名并公证。

**更新：**有新版本时，菜单栏图标上会显示一个圆点。点击菜单中的 更新至 …，查看更新内容，然后一键安装。应用绝不会未经询问就自行更新。应用每天检查一次；可在 设置 → 更新 中关闭。也可以使用 brew upgrade --cask oh-my-android。

**要求：**macOS 26 Tahoe 或更高版本、Apple 芯片，以及来自 Android Studio 的 Android SDK（或 brew install --cask android-commandlinetools）。应用会自动查找 SDK。如果你的 SDK 位于不常见的文件夹中，可在 设置 → Android SDK 中选择。

不用再输入 adb 命令

每个图标都能替代你原本需要输入或查找的命令：

布局检查器

冻结屏幕，像在 Figma 中一样测量。支持 Jetpack Compose 和传统 Views。

• 将鼠标悬停在任意元素上，即可查看其 dp 尺寸。点击一个元素，再悬停在另一个元素上，即可查看两者之间的距离 （同级元素之间的间距，以及父元素内部的内边距）。
• 8 dp 网格、取色器（十六进制值，按 ⇧⌘C 复制）和估算的 sp 字号。
• 设计稿叠加层：将 Figma PNG 导出文件拖到窗口中，选择 1× / 2× / 3× 或适合宽度，设置 不透明度或使用差值混合，并用方向键微调位置。逐像素比较设计稿和实现效果。

无障碍审计

在布局检查器中按 ⇧⌘A。每个屏幕阅读器焦点停留点都会按近似的 TalkBack 顺序标上编号，并显示 TalkBack 播报的内容以及问题列表：未标注的按钮、没有内容描述的图像，以及小于 48 × 48 dp 的触控目标。

数据检查器

浏览任意可调试应用的 SharedPreferences（键、类型、值）和 SQLite 数据库（表、前 500 行）， 并进行搜索。它使用 adb shell run-as，与 Android Studio 使用的访问方式相同，因此发布构建仍保持封闭。此工具为只读，不会更改设备上的任何内容。

AI Agent（MCP）

Oh My Android 内置了一个 MCP 服务，因此你的 AI 编码 Agent 可以查看并操控模拟器：截屏、读取以 dp 为单位的 UI 树、点击和输入文字、切换深色模式或 RTL、读取 logcat 和应用数据库。Agent 可以构建界面、运行应用、查看结果，并自行修复问题。

这些按钮使用 Homebrew 路径 /opt/homebrew/bin/ohmyandroid-mcp。如果通过 zip 安装，请使用下方菜单栏中的设置方式。

**一步完成设置：**菜单栏图标 → AI Agents → Set Up…，选择你的 Agent，然后点击 Copy（或 Add to Cursor / Add to VS Code）。也可以手动设置：

claude mcp add --scope user oh-my-android -- ohmyandroid-mcp   # Claude Code
codex mcp add oh-my-android -- ohmyandroid-mcp                 # Codex CLI
gemini mcp add --scope user oh-my-android ohmyandroid-mcp      # Gemini CLI

{ "mcpServers": { "oh-my-android": { "command": "/Applications/Oh My Android.app/Contents/MacOS/ohmyandroid-mcp" } } }

此 JSON 可用于 Cursor、Claude Desktop、Windsurf、Gemini CLI 和其他 Agent（VS Code 使用 "servers"）。 Homebrew 会将 ohmyandroid-mcp 添加到你的 PATH。如果通过 zip 安装，请使用上方的完整路径。

其他添加方式：

• Claude Code 插件： /plugin marketplace add ateymoori/oh-my-android，然后运行 /plugin install oh-my-android@oh-my-android
• **Claude Desktop 扩展：**从最新版本打开 oh-my-android-<version>.mcpb
• **MCP Registry：**登记为 io.github.ateymoori/oh-my-android

**由你掌控：**菜单栏图标 → AI Agents → Off、Read only 或 Full control。服务会在每次调用时检查权限，因此更改会立即生效。可能导致数据丢失的工具会标记为破坏性操作，Agent 会先征求你的同意。

现成的提示词：accessibility_review、ui_matrix（深色模式、大字体、RTL、伪区域设置）和 debug_crash。

试着这样询问你的 Agent：

• “截取模拟器屏幕，并检查此界面在深色模式下的效果。”
• “打开应用，进入设置，在深色模式、字体缩放 2 和阿拉伯语下检查界面。修复出现的问题。”
• “点击保存时应用会崩溃。重现问题、读取崩溃信息并修复。”
• “检查登录界面的 TalkBack 无障碍支持，并在代码中修复问题。”

**专为模型打造：**所有位置都以 dp 为单位，与布局代码一致。输出是精简文本：UI 树比原始 uiautomator XML 小约 10 倍，全部 18 个工具定义总共约占 3k 个 token。此服务通过 stdio 支持 MCP 2026-07-28 及更早版本（2024-11-05 至 2025-11-25），无需依赖，也不需要网络。

隐私与安全

• 🔒 无分析、无遥测、无需账户。 应用自身唯一的网络请求是检查更新：每天一次，从此仓库的 GitHub releases 读取一份小型动态。不会发送任何关于你或设备的信息。可在 Settings → Updates 中关闭。
• 只有在你选择安装时，更新（Sparkle）才会安装；且更新必须使用此项目的 EdDSA 密钥和相同的 Developer ID 签名。
• 只与自己的 Android SDK 中的 adb 通信。你输入的文本在传到设备前会进行 shell 引号转义。
• 重新加载和退出应用时，Data Inspector 中的数据库副本都会被删除。
• MCP 服务仅在 AI Agent 启动时运行，且只具有你允许的访问权限。它读取的内容（屏幕、UI、日志、应用数据）会发送给你的 Agent，再由 Agent 发送给其模型提供商。
• 使用 Developer ID 签名，启用强化运行时，并经 Apple 公证。

发现漏洞？请参阅 SECURITY.md。

故障排除

• 找不到 adb： 在 Settings → Android SDK 中选择你的 SDK，或设置 ANDROID_HOME。
• Agent 提示没有设备： 启动模拟器或连接手机，然后让 Agent 运行 list_devices。
• Agent 无法启动 ohmyandroid-mcp（zip 安装）： 只有 Homebrew 会将其添加到 PATH。请使用完整路径 /Applications/Oh My Android.app/Contents/MacOS/ohmyandroid-mcp。
• Homebrew 提示 tap 不受信任： Homebrew 6 及更高版本会要求你信任第三方 tap。完整命令 brew install --cask ateymoori/tap/oh-my-android 只会信任此 cask。若要使用短名称，请先运行 brew trust --cask ateymoori/tap/oh-my-android。
• Agent 提示“Access is Off”： 菜单栏图标 → AI Agents → Read only 或 Full control。

常见问题

brew install xcodegen
git clone https://github.com/ateymoori/oh-my-android.git && cd oh-my-android
xcodegen generate
open OhMyAndroid.xcodeproj

需要 Xcode 26。本地构建使用临时签名，因此无需 Apple Developer 账户。

Sources/
  App/        entry point, AppDelegate (host actions), Settings, assets
  Core/       no UI, no feature knowledge
    Shell/    ShellRunning: non-blocking Process runner, stopped on timeout or cancellation
    Android/  AndroidSDK, ADBClient, DeviceTracker (adb track-devices), UI hierarchy, app data
    SQLite/, Imaging/
  Features/   one small type per capability, registered in FeatureCatalog (Foundation only)
  MCP/        ohmyandroid-mcp: stdio MCP server built on Core and Features, shipped inside the app
  State/      AppModel (composition root), DeviceStore, FeatureStore, inspector stores
  Windows/    FloatingPanel, emulator window docking, tool windows
  UI/         SwiftUI; FeatureCell renders any feature from its protocol

路线图

• 对比模式：并排显示两台设备、镜像输入、像素差异对比
• 在面板窗口中嵌入模拟器屏幕
• 在数据检查器中支持 DataStore（.preferences_pb）
• MCP：启动和停止模拟器、录制屏幕

有想法？提交功能请求。 添加功能只需编写一个小型 Swift 结构体：请参阅 CONTRIBUTING.md。

⭐ 如果 Oh My Android 为你节省了时间，请为此仓库点星。
星标能帮助其他 Android 开发者发现它，也能表明值得开发新功能。
如需接收每个新版本的通知，请点击 Watch → Custom → Releases。

许可证

MIT © 2026 Royan AB。

Android 是 Google LLC 的商标。Oh My Android 与 Google 无关联，也未获其认可。 Android 机器人是根据 Creative Commons 3.0 Attribution License 中所述条款，复制或修改自 Google 创作并分享的作品。

由瑞典 🇸🇪 的 Royan AB 制作
Oh My Android 网站 · royan.se