ディスク上に新しいAndroidビルドが待っています。ブラウザ版は問題ありません。ただし、実機にインストールしたい場合は、内部テストアップロードやAndroid Studioのインデックス作成後ではありません。実際に必要なのは今すぐです。
その時は ADB Capacitorは、実際の電話と組み立て済みAPKの間の最短のパスになる。CapacitorまたはIonicと一緒に働いている場合、このコマンドは便利なコマンドから正常なフィードバックループの一部になります。nativeプラグイン、パーミッション、スプラッシュの動作、ディープリンク、ウェブビューの奇妙さ、ブラウザが知らないすべてのものを検証する方法です。
目次
- ADBインストールは、テストするための最も直接的なパスなので何故?
- ADBインストールに必要な環境を用意する
- ADBインストールAPKワークフローの核心
- ADBインストールフラグをマスターすることで、ワークフローを高速化する
- インストールの一般的な失敗をトラブルシューティング
- Capacitor 開発者向けの完全な例
ADB インストールは、テストに最も直接的なパスです
Android アプリを長く作成するうちに、Play Store を主なテストパスとして扱うことがなくなります。ルーチン イテレーションでは、特に許可ダイアログ、プラグイン ブリッジの問題、あるいは一台のデバイスでしか表示されないレイアウトのバグのチェックには、遅すぎます。
ADB Android 1.0 から 2008 年、そして、デバイスにAPKを直接展開する標準的な方法は、まだそのままです。2024年には、Androidのグローバルシェアは70％を超えました。 これは、幅広いデバイスをカバーするために働くモバイルチームにとって、このワークフローの重要性を理由としていることを示しています。公式のAndroid Debug Bridgeドキュメントで言及されているように。 実用的な開発の価値は簡単です:.
ストアのフリクションを回避します:
- レビューのキューなし、テストトラックの遅延なし。 実際のビルドをテストします:
- デバッグ、リリース候補、またはワンオフブランチビルド。 即時フィードバックを受け取ります:
- インストール、起動、ログの検査、繰り返し。 実用的なルール:
__CAPGO_KEEP_0__ このAPKは物理的なAndroidデバイスで動作するかどうかという質問に答える場合、通常は最初の答えになります。
adb installこれは、__CAPGO_KEEP_0__ と Ionic の場合に特に重要です。
This matters even more in Capacitor and Ionic work. A browser run tells you whether your web layer renders. It doesn’t tell you whether Android permission handling works, whether a plugin initializes cleanly, or whether your app updates over an existing install without breaking stored data.
コマンド自体は小さくて簡単です。
adb install path/to/app.apk
コマンドの有用性は、シンタックスではなくコントロールにあるのです。 直接インストール、既存のアプリに上書きインストール、古いビルドをテスト、パッケージレベルのエラーを診断することができます。 そのため、「ADBインストールAPK」というフレーズは、実際のチームワークフローで長く続きます。
ADB環境のセットアップ
ADBの問題の多くは、インストールの問題ではなくセットアップの問題です。 adb機械はデバイスを見つけることができません、デバイスは認証されていません、OEMは追加のスイッチを追加しました
マシンにプラットフォームツールをインストールする
Android Studioを完全にインストールする必要はありません。ADBを実行するには。 SDK プラットフォーム ツール、あなたのターミナルがその場所を知っている必要があります。
Windows、macOS、Linuxのいずれにおいても、最も綺麗なセットアップは同じです。
- Googleからプラットフォーム ツールをダウンロードしてください。 アーカイブを解凍して、安定した場所に保存してください。
- フォルダをPATHに追加してください。 すると、任意のターミナルウィンドウでも
- が動作するようになります。 __CAPGO_KEEP_0__ マシンを初期設定からセットアップする場合、
adbこの
If you’re setting up a Capacitor machine from scratch, this Android用アプリのCapacitor設定ガイド より広いツールチェーンの便利な相棒です。
ターミナルを使用して、コマンドが利用可能であることを確認します。
adb version
「コマンドが見つかりません」という文字列が返されない場合は、問題ありません。
いくつかのプラットフォーム固有の慣習が役立ちます。
- Windows: Platform Toolsを変更されないパスに配置し、そのフォルダを環境変数に追加してください。
- macOS: シェルプロファイルにフォルダパスを追加してください。
.zshrc. - Linux: シェル設定ファイルに同じパスを追加し、シェルを再読み込みしてください。
デバイス上の設定を有効にします
デバイス側も同等に重要です。重要な前提条件は、USBデバッグを有効にすることです。 __CAPGO_KEEP_0__ デバイスオプション を通して、 7回タップすることで有効化できます。Xiaomiデバイスの場合、MIUIを搭載している場合、ADBセットアップの参考資料に記載されているように USB経由でのインストールも有効化する必要があります。 これで、短いチェックリストが残ります。.
デバイスオプションを有効化する:
- USBデバッグを有効化する: tap Build Number 7回 seven times.
- USBデバッグを有効にする: ADBが必要な設定です。
- OEMの追加機能を監視する: Xiaomiはクラシックの例です。
- 信頼性の高いケーブルで接続する: 充電専用ケーブルは時間を浪費します。
電話の画面の表示もケーブルと同じくらい重要です。 ‘USBデバッグを許可する?’ を見逃すと、コンピューターはデバイスを認識するかもしれませんが、ADBはまだ許可されません。
最初に接続すると、Androidはコンピューターを信頼するかどうかを尋ねます。許可すると、開発用マシンである場合は常に許可するようにします。そうしないと、後続のワークフローが失敗し、実際はもっと単純なものですが、謎めいたように見えます。
Core Adb Install Apk ワークフロー
設定が完了したら、インストールパスは短くなります。よくある間違いは、次のコマンドが成功する可能性があるかどうかを判断するためのチェックをスキップすることです。
デバイスを確認してください
最初に実行してください:
adb devices
接続されたシリアル番号と健常なデバイス状態を確認したいです。デバイスが未承認として表示される場合は、そこで停止し、承認を修正してからインストールを試みること。
デバッグ、QA、リリース候補出力を管理しているチームにとって、どのようなビルドをプッシュしているか明確にすることも役立ちます。この モバイルアプリビルドタイプ は、同名のAPKが大量に保存されているフォルダの場合、参考になるものです。
インストールコマンドを実行してください
基本的なコマンドは簡単です:
adb install path/to/your-app.apk
パスがスペースを含む場合は、シェルで引用符で囲みます。APKが同じフォルダ内にある場合は、コマンドがさらに短くなるでしょう:
adb install app-debug.apk
正常な実行では、ストリーミングインストールメッセージと成功メッセージがターミナルに表示されます。そのような出力が得られるのは、パッケージマネージャーがAPKを受け入れてインストールを完了したことを確認するためです。
実行の流れを確認したい場合は、以下のガイドを参照してください:
ストリーミングインストールは、手動プッシュとPmインストールに勝る理由があります
内部では、 adb install にAPKをプッシュし、 /data/local/tmpを呼び出し、 pm installを削除します。ストリーミングされたワークフローは、 “Performing Streamed Install” followed by の実装詳細は、のセットアップリファレンスでまとめられています。
これは重要な点です。古い2ステップの習慣である adb push を実行し、
- を呼び出す必要がなくなりました。 ストリーミング インストールには、以下の利点があります。
- デバイスの汚れを減らす: 自動で一時的なアーティファクトをクリーンアップします。
- 誤ってファイルをプッシュしてインストールする機会を減らす: 一つのファイルをプッシュして、別のファイルをインストールするのを避けます。
使えるものなら使う:
adb installマニュアルのプッシュとシェルインストールはエッジケースに役立ちますが、通常のアプリケーションテストのデフォルトパスではありません。
ADB インストール APK ワークフローでは、次のループが中心です:
デバイスを検証、インストールを実行、成功を確認、アプリケーションを起動、ビルドの次に繰り返します。
ADB インストール フラグのマスター
ADB インストール フラグの基本コマンドは、APK を電話に取得します。フラグは、プロセスが実際の開発に適合するか、開発者に戦い続けるかを決定します。
| ADB インストール フラグの共通利用例とその使用方法 | フラグ名:フラグの説明 | 一般的な使用例 |
|---|---|---|
-r |
既存アプリを再インストールして、可能な限りアプリデータを保持する | 毎日デバッグビルドを繰り返す |
-d |
バージョンを下げることを許可する | ロールバックシナリオや古いビルドをテストする |
-g |
インストール時点で実行時許可を付与する | カメラ、ストレージ、位置情報などの機能のテストを高速化する |
通常の開発では最も重要なフラグは -r.
なければ、既にインストールされているパッケージを更新することが多々あるが、Androidは新しいAPKを競合するインストール試行として扱い、置き換えとして扱わないため、更新が失敗することが多い。そのため、多くの開発者は adb install -r app-debug.apk デフォルトの筋肉の記憶として
どのフラグが日常開発で重要か
-r は、常に使用するフラグです。テスト用のアプリをCapacitorで構築し、1時間に何度もビルドする場合、毎回アプリをアンインストールするのは遅く、有用なローカル状態を消去することになる。再インストールすると、開発を継続できます。
-d 状況によって異なるが、必要な時には本当に必要です。レグレッションテスト、ロールバックドリル、または古いビルドがレガシーデータベースを開くかどうかを確認するのに役立ちます。
-g 品質の向上の旗です。アプリが早期にパーミッションに触れる場合、自動許可はデバイスセットアップの繰り返しタップを削減します。正しいパーミッションテストを置き換えるものではありませんが、インストールと起動を迅速に進める必要がある時は便利です。
いくつかの組み合わせはよく見られます。
adb install -r app-debug.apk
adb install -r -g app-debug.apk
adb install -r -d older-build.apk
すべての旗にはトレードオフがあります。便利さは実際のユーザー条件を隠す可能性があります。自動許可を毎回行うと、実行時パーミッションのエッジケースを逃す可能性があります。古いデータを上書きする場合は、初回起動の問題を逃す可能性があります。
経験豊富なチームでは、習慣を分割することが一般的です。
- 高速ループビルド: 使用する
-r、時々-g. - クリーンステートチェック: アンインストールしてから新しいインストールを行う。
- ロールバックテスト: 使用する
-dバージョン移動がテスト対象の場合のみ。
Capacitor開発のコマンドライン側のより広範なリフレッシュを望む場合は、このCapacitorと__CAPGO_KEEP_1__のコマンドと修正のガイドが適しています。 common Capacitor CLI commands and fixes インストールの一般的なトラブルシューティング
ADBは信頼できるので、繰り返し失敗は特定の問題に指し示すことが多い。インストールエラーをランダムなものとして扱うのではなく、トラブルシューティングする必要がある。
Android Debug Bridge (ADB)のインストールエラーと開発者向けの解決策のトラブルシューティングチェックリスト。
症状:
未承認
adb devices原因:電話がコンピューターを信頼していない、またはプロンプトがキャンセルされた。unauthorized
次の順序で修正する。
__CAPGO_KEEP_0__
- デバイスを再接続し、ロック画面を閉じてください。 電話でRSA認証のプロンプトを探してください。
- プロンプトを承認してください。 開発用マシンで常に許可するオプションを選択することをお勧めします。
- まだ回復しない場合、ADBサーバーを再起動してください。端末は問題を技術的なものに装い、実際の解決策は電話自体にあります。
- パッケージがすでに存在する場合
adb kill-server
adb start-server
症状:
これは、replaceフラグを使用せずにすでに存在するパッケージにインストールしようとしていることを意味します。この一般的な罠は、この
ADBインストールの失敗に関するStack Overflowの議論でドキュメントされています。
INSTALL_FAILED_ALREADY_EXISTS
__CAPGO_KEEP_0__ __CAPGO_KEEP_0__.
最速の修正方法は:
adb install -r app-debug.apk
アップグレードの代わりにクリーンインストールが必要な場合は、まずアンインストールしてください:
adb uninstall your.package.name
再インストールパスを使用して、定期的な反復を実行します。アンインストールは、ローカルアプリの状態をクリアしたい場合や、初回起動の動作を検証したい場合にのみ使用してください。
署名と古いパッケージ状態が衝突する場合
APKファイルそのものではなく、パッケージに関するAndroidの記憶が原因の失敗もあります。
よく見られる2つのパターンがあります:
- 署名不一致: インストール済みのアプリが、APKをインストールしようとしているキーと異なる署名で署名されていた場合。
- パッケージ状態の重複: アンインストールしてもパッケージの残骸が残り、次のインストールをブロックすることがあります。
特に2番目のパターンは、成功したアンインストールの後に生じる可能性があり、非常に悩ましいです。新しいAndroidバージョンでは、古いアンインストールの動作が、 INSTALL_FAILED_DUPLICATE_PACKAGEパッケージ状態を残し、
実践的な診断フローは次のようになります：
- 最初にパッケージの正当性を確認してください： パッケージ名が想定どおりであることを確認してください。
- 次に、署名の一貫性を確認してください。 デバッグ署名とリリース署名のバージョンは互いに置き換えられません。
- 次に、インストール済みのパッケージを削除してください。 通常のアンインストールパスを使用してください。
- エラーが続きます。 それを古いパッケージ状態として扱ってください。ADBのランダムなエラーではありません。
デバッグAPKが通常の開発ツール以外で配布されている場合、もう一つの問題があります。 ADB経由で同じビルドをインストールすると、メッセージングやメールから手動でサイドロードしたときに失敗することがあります。その挙動は、Androidのデバッグ署名アプリのコンテキスト認証に関するこのガイドで説明されているように、Androidのデバッグ署名アプリのコンテキスト認証と関連しています。
Field note: ADBを介してインストールされるが、手動でタップしてインストールしない場合、APKが破損しているのではなく、署名コンテキストとインストールパスを確認してください。
For Capacitor projects that keep throwing build and deploy issues across native and web layers, this troubleshooting guide for resolving Android build errors in Capacitor は、常に近くに保管しておく価値があります。
A Complete Example for Capacitor Developers
In a Capacitor project, the terminal loop is usually short. You sync native files, build the Android app, and push the resulting APK to a connected device without opening Android Studio unless you need native debugging.
例えば、次のようになります:
npx cap sync android
通常のAndroidビルドステップからデバッグAPKをビルドし、置き換えを有効にした状態でインストールしてください:
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
このワークフローは、フィードバックループを短く保つため、多くのチームが依存しています。CapacitorJSアプリケーションでは、差分アップデートを配信するチームが多いからです。 CapacitorJSアプリケーションでは、差分アップデートを配信するチームが多いからです。 CapacitorJSアプリケーションでは、差分アップデートを配信するチームが多いからです。 adb install は特に重要です。IBMの研究では、 Androidベースのモバイルチームの 78%がPlay StoreのサブミッションよりもリアルタイムのJavaScriptとCSS修正のために この.
ADBベースのAPKインストールをカバーするビデオリファレンス Capacitor CLI installation guide プロジェクト側のセットアップをまだ行っている場合、この
Capacitor __CAPGO_KEEP_1__ インストールガイド Capgo チームが__CAPGO_KEEP_0__を使用し、JavaScript、CSS、設定、資産の修正をアプリストアのレビューの待たずに配信したい場合、
