MacからAPKをインストールしてAndroidをデバッグする — ターミナルあり・なし両対応

「MacからAPKをインストール」という言葉の裏には、まったく異なる2つの作業が隠れています。しかも多くの記事は、そのうち片方にしか答えていません。このページでは両方に答えたうえで、そのあと実際につまずくポイント — logcatの読み方と、そもそもmacOSにスマホを認識させること — も扱います。以下の手順はすべて素の adb コマンドだけで実行できます。GUIが本当に手間を減らしてくれる場面では、それが何をしてくれて何をしてくれないのかをはっきり書きます。2026年8月更新。

まず確認: アプリを動かしたいのはMac上ですか、それともスマホ上ですか?

このキーワードの検索結果はちょうど半分に割れていて、上位に出てくる記事はそのどちらか一方しか扱っていません。「BlueStacks / NoxPlayer / LDPlayerを入れましょう」と答えている記事は、前者 — macOS自体でAndroidのソフトを動かすこと — に答えています。それにはエミュレーターが必要で、Apple Siliconで現実的な選択肢はAndroid Studio付属のエミュレーター（無料、arm64のシステムイメージ）か、Google Play Games on PC系の製品であって、昔のx86エミュレーターではありません。

一方、机の上にスマホやタブレットがあり、ダウンロードフォルダに .apk ファイルがあるという状況なら、エミュレーターは一切不要です。必要なのはADB（Android Debug Bridge）とケーブルだけ。このページの残りは、その話です。

1. Mac自体でアプリを動かしたい → エミュレーターを使ってください。以下の内容は当てはまりません。
2. Macにつないだ実機のAndroidデバイスにアプリを入れたい → このまま読み進めてください。

ステップ0: USBデバッグを有効にする（ここはスマホ側の作業）

このスイッチを代わりに入れてくれるMacアプリは存在しません。Androidは意図的に、端末側で手動で有効化することを求めており、最初の接続はスマホの画面で承認する必要があります。そうでないと主張するツールがあれば、それは間違いです。

Windowsと違い、macOSではUSBドライバは不要です。端末が表示されないときの原因は、ほぼ確実に充電専用ケーブル、USBハブ、または承認していない認証ダイアログのいずれかです。

1. 設定 → デバイス情報 → ビルド番号を7回タップします。
2. 設定に戻り、システム → 開発者向けオプション → USBデバッグをオンにします。
3. データ転送に対応したケーブルで、ハブを経由せず直接スマホをMacに接続します。
4. スマホ側で「USBデバッグを許可しますか?」を承認し、「このパソコンからのUSBデバッグを常に許可する」にチェックを入れます。

ターミナルを使う方法: adb install

これが昔からの定番の方法で、最終的にGUIを使うことになるとしても知っておく価値があります。Homebrewでインストールされるのは、Googleが配布しているものと同じplatform-toolsのバイナリです。

よくある失敗を率直にまとめます。INSTALL_FAILED_UPDATE_INCOMPATIBLE は、同じパッケージ名のアプリが別の鍵で署名された状態ですでにインストールされている、という意味です。先にアンインストールしてください。INSTALL_FAILED_VERSION_DOWNGRADE は -d を付ければ解決します。「adb: no devices/emulators found」は、上記の認証ステップが完了していないということです。

1. brew install --cask android-platform-tools
2. adb devices — シリアル番号が unauthorized や offline ではなく device と表示されている必要があります。
3. adb install -r ~/Downloads/app.apk（-r は既存のアプリに上書き再インストールし、データを保持します）。
4. Success が出るか確認します。INSTALL_FAILED_ で始まる行が本当のエラーメッセージです。

ターミナルを使わない方法: APKをウインドウにドラッグする

普段からターミナルに張り付いているわけでないなら、Homebrewでのインストール、PATHの編集、cd platform-tools の繰り返しは余計な手間でしかありません。Super ADB Managerは adb とscrcpyサーバーをアプリ内に同梱しているので、別途インストールするものも、個別に更新し続けるものもありません。

無料で、アカウント登録は不要、広告もなく、テレメトリは既定でオフです。アプリはAppleによる署名と公証を受けているため、ダウンロードサイトで配られている未署名のツールのように「右クリック→開く」の回避策を強いられることなく、普通に起動できます。

1. DMGをダウンロードし、アプリをアプリケーションフォルダにドラッグして開きます。
2. スマホを接続し、USBデバッグの確認ダイアログを承認します（上記と同じ）。
3. デバイスを選び、アプリタブを開いて、APKをインストールを押すか、.apk をそのままウインドウにドロップします。
4. 同じタブにはインストール済みパッケージの一覧が表示され、アプリの起動、APKのMacへの取り出し、データ消去、アンインストールができます。

分割APK: base.apk と設定ファイル群

APKMirrorからApp Bundle形式でダウンロードしたものや、SAIで書き出したものは、複数のファイルとして届きます — base.apk に加えて split_config.arm64_v8a.apk、split_config.xxhdpi.apk、言語ごとのsplitなどです。base.apk だけをインストールすると、起動時にクラッシュするか、リソースが表示されないアプリになります。

すべてのパートは同じビルド・同じ署名のものである必要があり、バージョンを混ぜると失敗します。.xapk や .apks のコンテナを持っている場合は、どちらもZIPアーカイブなので先に展開し、取り出したパートをまとめてインストールしてください。

1. ターミナル: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. GUI: ファイル選択画面ですべてのパートを一度に選ぶか、まとめてウインドウにドラッグします。アプリが代わりに install-multiple を実行し、インストール中はパート数を表示します。

Android StudioなしでMacでlogcatを読む

adb logcat は単体でも問題なく動きますし、クラッシュをさっと探すだけならコマンドラインで十分なことが多いです。問題は、継続的に読み続ける場合です。生のlogcatは端末上のすべてのプロセスから毎分数千行を吐き出します。

この分野のGUIは選択肢が乏しく、しかもほとんどが古いままです。macOS向けで最もよく知られているlogcatビューアは、10年前のObjective-Cプロジェクトとそのフォーク、Tcl/Tk製のツール、そして比較的新しいターミナル風のRust製ユーティリティが数点、それに有料の商用製品が1つあるくらいです。どれもplatform-toolsは自分でインストールして管理する前提で、多くは未署名です。macOS 13以降では、1行目を目にする前にGatekeeperと格闘することになります。

Super ADB Managerの Logcat タブは、選択中のデバイスからログをライブでストリーミングし、優先度フィルタ（すべて / Info以上 / Warning以上 / Error / Fatal）、クラッシュ・ネットワーク・システム・現在フォアグラウンドのアプリ向けのプリセットフィルタ、フリーテキスト検索、色分け、自動スクロール、クリアを備えています。正直な制約が1つ: この画面はメモリ上に直近2000行だけを保持するため、長時間のセッションを丸ごと残すアーカイブではなく、あくまでライブのデバッグ用ウインドウです。すべてを記録したい場合は adb logcat の出力をファイルにリダイレクトしてください。

1. adb logcat -v time — 読みやすいタイムスタンプ付き。
2. adb logcat *:E — エラーと致命的エラーのみ。
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — 特定のアプリの出力だけ。
4. adb logcat -c — バグを再現する前にバッファをクリア。
5. adb logcat -v time > ~/Desktop/session.log — すべてをファイルに記録。

Macがデバイスを認識しないとき

この問題について、macOSに特化した質の高い最新のトラブルシューティング記事は見当たりません。そこで、実際に解決につながる順に並べたチェックリストを載せておきます。Samsung、Xiaomi、Honorの一部の機種では、ADBが接続する前に、通知パネルでUSBのモードを「充電のみ」から「ファイル転送」に変更する必要もあります。

adb devices にシリアル番号と一緒に unauthorized と表示される場合、スマホは正常に接続できています。足りないのは確認ダイアログだけで、表示されていないか、以前に拒否したままになっているだけです。認証を取り消せば、ダイアログをもう一度出せます。

1. ケーブルを別のものに替える。充電専用のUSB-Cケーブルが、断トツで多い原因です。
2. Macに直接挿す。ハブ、ドック、モニターのポートは経由しない。
3. adb kill-server のあとに adb devices を実行してデーモンを再起動する。
4. 開発者向けオプション → USBデバッグの許可の取り消しを実行し、ケーブルを抜き差しする。
5. system_profiler SPUSBDataType | grep -i -A4 android — ここで何も出てこなければ、ADBではなくハードウェアかケーブルの問題です。

ワイヤレスデバッグとADB非対応デバイス

Android 11以降は、6桁のコードを使ったWi-Fi経由のペア設定に対応しています。USBポートが埋まっているときや、端末がテスト用の治具に組み込まれているときには本当に便利です。スマホに表示されるペア設定用のポートは一時的なもので、接続用のポートとは別物です。両方のマシンが同じサブネットにいる必要があり、クライアント分離が有効な企業向けWi-Fiでは完全に遮断されます。アプリの ワイヤレス パネルはmDNSでネットワークをスキャンし、ペア設定コードの入力を受け付けます。USB接続中なら、ショートカット → ワイヤレスに切り替え で、この引き継ぎをワンクリックで済ませられます。

別の話として、すべてのデバイスがADBを話すわけではありません。Kindleや多くのカメラ・メディアプレーヤーは、ストレージをMTPでしか公開しません。しかもGoogleはAndroid File Transferの提供を終了しているのに、今もウェブのあちこちで勧められ続けています。Super ADB Managerには MTPデバイス セクションがあり、ADBなしでそうしたデバイスのファイルを閲覧・転送できます。注意点: 転送中にデバイスを抜いたり取り出したりするとMTPセッションが切れることがあり、その場合は再接続してやり直します。

動作条件と制約をはっきり書いておきます: バージョン 0.6.0、Apple Silicon専用、macOS 13 Ventura以降、サイズは約 27 MB、公証済み。画面録画はAndroidの screenrecord に依存しているため、HONORとHuaweiの一部の機種では動きません。これはデバイス管理とログのためのツールであって、Android Studioのデバッガーの代わりにはなりません。ブレークポイントも変数の検査もありません。

1. スマホ側: 開発者向けオプション → ワイヤレスデバッグ → ペア設定コードによるデバイスのペア設定。
2. Mac側: adb pair 192.168.1.20:41234 を実行し、6桁のコードを入力します。
3. adb connect 192.168.1.20:5555 で接続すれば、通常どおりADBの作業ができます。
4. または、アプリのワイヤレスパネルを使います: スキャンし、デバイスを選び、コードを入力するだけです。

よくある質問

ほかのガイド