Oh My Android

Oh My Android

ダークモード、大きなフォント、RTL、TalkBack で Android アプリをテストできます。それぞれワンクリックで切り替えられ、adb コマンドは不要です。
Mac 用の無料のネイティブ ADB GUI です。Android Emulator の隣にドッキングできます。実機でも使用できます。

_{ダークモード、フォントサイズ、アラビア語の RTL、SMS と着信。それぞれワンクリックで操作できます。}

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

_{または、署名・公証済みの zip をリリースからダウンロードできます · macOS 26 Tahoe 以降 · Apple シリコン · すでにお使いの Android SDK を使用します（詳細） · ⭐ Android 開発者にもっと見つけてもらえるよう、スターをお願いします}

• 🎛️ 約 50 種類のテスト操作をいつでも表示。 ダークモード、フォントと表示サイズ、RTL や疑似ロケールを含む言語とロケール、TalkBack、太字、レイアウト境界、タップ表示、アニメーションのオフ、ネットワーク速度、GPS、着信と SMS。各アイコンには、デバイスの実際の状態が表示されます。
• 📐 あらゆるアプリで使える、dp 単位の Layout Inspector。 ビューにカーソルを合わせると、Compose と Views のどちらでも、そのサイズと周囲の間隔を dp 単位で確認できます。Figma のエクスポートを重ねて、デザインと実装を比較できます。⇧⌘A を押すと、TalkBack の停止位置に番号を付け、ラベルの欠落や 48 dp 未満のタッチターゲットを検出します。
• 🗄️ adb を使わずにデバッグビルドを操作。 SharedPreferences と SQLite の読み取り、データの消去、ディープリンクの起動、APK のドラッグ＆ドロップによるインストール、権限のリセットができます。
• 🪶 ネイティブで軽量。 SwiftUI、イベント駆動型、Electron なし、テレメトリーなし。無料のオープンソース（MIT）です。

Android Studio だけではだめですか？ Studio のデバイス UI ショートカットでも、ダークモード、フォントサイズ、 アプリの言語、TalkBack（API 33 以降）をワンクリックで切り替えられます。Studio を開いているときは、そちらをお使いください。Oh My Android では、Studio を閉じた状態でもエミュレーターとスマートフォンの両方で使える、常時表示のパネルを追加します。 Studio のショートカットにはない切り替え機能（太字、疑似ロケール、レイアウト境界、タップ表示、アニメーション）や、Studio の Layout Inspector ではデバッグ可能なアプリが必要な、あらゆるアプリでの dp 測定が利用できます。Studio、scrcpy、mobile-mcp との比較：docs/COMPARISON.md。

🤖 Claude Code、Codex、または Cursor をお使いですか？ アプリには MCP サーバー（18 個のツール）が付属しており、エージェントから エミュレーターの画面を dp 単位でキャプチャしたり、タップしたり、ダークモードや RTL を切り替えたりできます。セットアップ →

コントロールパネル	Layout Inspector ＋ TalkBack 監査

機能 · adb チートシート · Layout Inspector · AI エージェント（MCP） · トラブルシューティング · FAQ · コントリビュート · ウェブサイト

破壊的な操作（データの消去、アンインストール、権限のリセット）を実行する前に確認が求められます。

アップデートと要件

Homebrew のほか、最新リリースから zip をダウンロードし、 解凍して、Oh My Android.app を「アプリケーション」に移動できます。アプリは Apple によって署名および公証されています。

アップデート： 新しいバージョンが公開されると、メニューバーアイコンにドットが表示されます。メニューの Update to … をクリックして、新機能を確認し、ワンクリックでインストールします。確認なしにアプリがアップデートされることはありません。確認は 1 日に 1 回行われます。無効にするには、Settings → Updates を選択してください。brew upgrade --cask oh-my-android も使用できます。

要件： macOS 26 Tahoe 以降、Apple シリコン、および Android Studio の Android SDK（または brew install --cask android-commandlinetools）。 アプリは SDK を自動的に検出します。SDK が標準とは異なるフォルダーにある場合は、Settings → Android SDK で選択してください。

adb コマンドはもう不要

各アイコンから、これまで入力したり検索したりしていたコマンドを実行できます。

レイアウトインスペクター

画面を固定して、Figma のように寸法を測定できます。Jetpack Compose と従来の Views に対応しています。

• 任意の要素にカーソルを合わせると、dp 単位のサイズを確認できます。要素をクリックしてから別の要素にカーソルを合わせると、その間の距離（兄弟要素間の隙間、親要素内のパディング）を確認できます。
• 8 dp グリッド、カラーピッカー（16 進数、⇧⌘C でコピー）、推定テキストサイズ（sp）に対応しています。
• デザインオーバーレイ：Figma の PNG エクスポートをウィンドウにドロップし、1×／2×／3×または幅に合わせるを選択して、不透明度を設定するか差分ブレンドを使用し、矢印キーで位置を微調整できます。デザインと実装をピクセル単位で比較できます。

アクセシビリティ監査

レイアウトインスペクターで ⇧⌘A を押します。スクリーンリーダーの各読み上げ位置に、おおよその TalkBack の読み上げ順を示す番号と、TalkBack が読み上げる内容、問題の一覧が表示されます。問題には、ラベルのないボタン、コンテンツ説明のない画像、48 × 48 dp 未満のタッチターゲットが含まれます。

データインスペクター

検索機能を使って、デバッグ可能な任意のアプリの SharedPreferences（キー、型、値）と SQLite データベース（テーブル、先頭 500 行）を参照できます。Android Studio と同じアクセス方法である adb shell run-as を使用するため、リリースビルドのデータは保護されます。読み取り専用なので、デバイス上のデータは変更されません。

AI エージェント（MCP）

Oh My Android には MCP サーバーが含まれているため、AI コーディングエージェントがエミュレーターを確認して操作できます。スクリーンショットの撮影、dp 単位の UI ツリーの読み取り、タップやテキストの入力、ダークモードや RTL への切り替え、logcat やアプリのデータベースの読み取りが可能です。エージェントは画面を構築して実行し、結果を確認して、自分で修正できます。

ボタンでは Homebrew のパス /opt/homebrew/bin/ohmyandroid-mcp を使用します。zip でインストールした場合は、以下のメニューバーから設定してください。

ワンステップで設定： メニューバーのアイコン → AI Agents → Set Up… からエージェントを選び、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、その他のエージェントで使用できます（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 を選択します。サーバーは呼び出しのたびに設定を確認するため、変更はすぐに反映されます。データを失う可能性のあるツールには破壊的操作のマークが付いているため、エージェントは実行前に確認を求めます。

すぐに使えるプロンプト：accessibility_review、ui_matrix（ダークモード、大きなフォント、RTL、疑似ロケール）、debug_crash。

エージェントに試しに頼んでみましょう：

• 「エミュレーターのスクリーンショットを撮って、この画面をダークモードで確認してください。」
• 「アプリを開いて設定に移動し、ダークモード、フォントスケール 2、アラビア語で確認してください。問題があれば修正してください。」
• 「保存をタップするとアプリがクラッシュします。再現して、クラッシュの内容を読み取り、修正してください。」
• 「ログイン画面の TalkBack 対応状況を監査し、コードの問題を修正してください。」

モデル向けに設計されています： すべての位置は、レイアウトコードと同じ dp 単位です。出力はコンパクトなテキストで、UI ツリーは生の uiautomator XML の約 10 分の 1 のサイズです。また、18 個すべてのツール定義を合わせても約 3k トークンです。サーバーは stdio 経由で MCP 2026-07-28 とそれ以前のバージョン（2024-11-05 から 2025-11-25）をサポートし、依存関係がなく、ネットワーク接続も不要です。

プライバシーとセキュリティ

• 🔒 アナリティクスなし、テレメトリーなし、アカウント不要です。 独自に行う唯一のネットワークリクエストはアップデート確認です。1 日に 1 回、このリポジトリの GitHub リリースから小さなフィードを読み込みます。あなたやデバイスに関する情報は一切送信しません。Settings → Updates で無効にできます。
• アップデート（Sparkle）は、ユーザーが選択した場合にのみインストールされます。また、このプロジェクトの EdDSA キーおよび同じ Developer ID で署名されている場合に限ります。
• 接続先は、ユーザー自身の Android SDK にある adb のみです。入力したテキストは、デバイスに送信される前にシェル用にエスケープされます。
• Data Inspector から作成したデータベースのコピーは、再読み込み時とアプリ終了時に削除されます。
• MCP サーバーは AI エージェントが起動した場合にのみ実行され、許可したアクセス範囲内でのみ動作します。読み取った情報（画面、UI、ログ、アプリデータ）はエージェントに送られ、そこからエージェントのモデルプロバイダーに送信されます。
• Developer ID で署名され、ハードニングされたランタイムを使用し、Apple の公証を受けています。

脆弱性を発見しましたか？SECURITY.md をご覧ください。

トラブルシューティング

• adb が見つからない場合： Settings → Android SDK で SDK を選択するか、ANDROID_HOME を設定してください。
• エージェントにデバイスがないと言われる場合： エミュレーターを起動するか、スマートフォンを接続してから、エージェントに list_devices の実行を依頼してください。
• エージェントが ohmyandroid-mcp を起動できない場合（zip インストール）： PATH に追加されるのは Homebrew のみです。フルパス /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 を実行してください。
• エージェントに「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

ロードマップ

• 比較モード：2台のデバイスを横並びに表示し、入力をミラーリングして、ピクセル差分を表示
• パネルウィンドウ内にエミュレーター画面を埋め込み
• Data InspectorでのDataStore（.preferences_pb）サポート
• MCP：エミュレーターの起動と停止、画面の録画

アイデアをお持ちですか？機能リクエストを送信してください。 機能の追加は小さなSwift構造体1つでできます。CONTRIBUTING.mdをご覧ください。

⭐ Oh My Androidが時間の節約に役立ったら、このリポジトリにスターを付けてください。
スターを付けると、ほかのAndroid開発者がこのツールを見つけやすくなり、新機能の開発を後押しできます。
新しいバージョンごとに通知を受け取るには、Watch → Custom → Releasesをクリックしてください。

ライセンス

MIT © 2026 Royan AB。

AndroidはGoogle LLCの商標です。Oh My AndroidはGoogleと提携しておらず、Googleから承認も受けていません。 Androidロボットは、Googleが作成して共有した作品を複製または改変したものであり、Creative Commons 3.0 Attribution Licenseに記載された条件に従って使用しています。

🇸🇪 Royan ABがスウェーデンで制作
Oh My Androidのウェブサイト · royan.se