あなたは新しいAndroidビルドがディスク上にあり、ブラウザ版は問題ありませんが、実機にインストールしたいと思っています。内部テストアップロード後ではなくて、Android Studioがインデックス作成を終了した後ではなくて、すぐに。
その時は ADB Capacitor
コンテンツの表
- ADB インストールは、実際の電話と組み立て済み APK の間の最短のパスです。__CAPGO_KEEP_0__ または Ionic を使用する場合、このコマンドは便利なコマンドから正常なフィードバックループの一部になります。native プラグイン、パーミッション、スプラッシュの動作、ディープリンク、Web View の奇妙さ、ブラウザが知らないすべてのものを検証する方法です。
- 目次
- マシンにプラットフォーム ツールをインストールする
- インストールコマンドを実行する
- ADBインストールの一般的なエラーのトラブルシューティング
- Capacitor 開発者向けの完全な例
ADBインストールはテストの最も直接的なパスです
Androidアプリを長く開発すると、Playストアを主なテストパスとして扱うのをやめます。ルーチン的な反復では、特に許可ダイアログ、プラグインブリッジの問題、あるいは一台のデバイスでしか表示されないレイアウトのバグをチェックする場合、遅すぎます。
ADB 2008年にAndroid 1.0で導入されています __CAPGO_KEEP_0__, そして、まだデバイスにAPKを直接展開するための標準的な方法です。 2024年には、Androidの世界市場シェアは70%を超えました。, これは、Androidの公式デバッグブリッジドキュメントで指摘されているように、幅広いデバイスをカバーするために作業するモバイルチームにとって、このワークフローが中心的な理由の1つです。 実用的な開発の場合、値は単純です:.
ストアのフリクションを回避します:
- レビューのキューなし、テストトラックの遅延なし。 実際のビルドをテストすることができます:
- デバッグ、リリース候補、または一時的なbranchビルド。 即時フィードバックを受け取ることができます:
- インストール、起動、ログの検査、繰り返し。 実用的なルール:
Practical rule: このAPKは物理Androidデバイスで動作するかどうかという質問は、通常、最初の答えになります。
adb install通常、最初の答えはこの質問 "このAPKは物理Androidデバイスで動作するかどうか" です。
Capacitor と Ionic の場合、ブラウザの実行では、Web層がレンダリングされるかどうかを確認できますが、Androidのパーミッションの処理が正常に動作するか、プラグインが適切に初期化されるか、既存のインストールに上書きしてデータを破壊しないようにアプリがアップデートされるかどうかは確認できません。
コマンド自体は小さくて簡単です。
adb install path/to/app.apk
コマンドの構文自体が重要なのはありません。コントロールが重要です。直接インストール、既存のアプリに上書きインストール、古いビルドをテスト、パッケージレベルのエラーを診断することができます。そうして、"getting started" の段階が終わっても、実際のチームワークフローでこのフレーズ "ADB install APK" が頻繁に出てくるのは、コントロールが重要だからです。 ADB インストール APK ADB の環境を準備する方法
ADB の問題の多くは、インストールの問題ではなく、セットアップの問題です。マシンはデバイスを見つけることができません、デバイスは認証されていません、OEM が追加した 1 つのスイッチが存在します。
Android Debug Bridge の環境を設定するための 7 つのステップのガイド。 adbマシンに Platform Tools をインストールする
Install Platform Tools on Your Machine
Android StudioのフルインストールはADBを実行するために必要ありません。必要なのは SDK Platform Tools、その後、ターミナルがその場所を知る必要があります。
Windows、macOS、Linuxで、最も綺麗な設定は同じです:
- GoogleからPlatform Toolsをダウンロードする アーカイブを展開する
- 安定した場所に フォルダをPATHに追加する
- そのため どのターミナルウィンドウでも
adb__CAPGO_KEEP_0__ マシンを最初から設定する場合、この
If you’re setting up a Capacitor machine from scratch, this Android setup guide for Capacitor apps __CAPGO_KEEP_0__アプリのためのAndroidのセットアップガイド
Androidのセットアップガイドは、より広いツールチェーンの便利な相棒です。
adb version
ターミナルを使用して、コマンドが利用可能であることを確認します。
その結果、バージョンが返された場合は、問題ありません。
- いくつかのプラットフォーム固有の習慣が役立ちます。 Windows:
- Platform Toolsを変更されないパスに配置し、環境変数にそのフォルダを追加します。 macOS:
.zshrc. - シェルプロファイルにフォルダパスを追加します。 Linux:
シェル設定ファイルに同じパスを追加し、シェルを再読み込みします。
デバイス側も同様に重要です。重要な前提条件は、USBデバッグを有効にすることです。 USBデバッグを有効にする デバイスの 開発者オプションを通して 開発者オプションを有効にするにはビルド番号を7回タップする XiaomiのデバイスでMIUIを使用している場合、次の手順も実行する必要があります。USB経由でインストール 、この.
ADBセットアップの参考資料
- dev.to 7回のビルド番号をタップしてください。
- USBデバッグを有効にする: ADBが必要な設定です。
- OEMの追加機能を検出する: Xiaomiはクラシックな例です。
- 信頼性の高いケーブルで接続してください。 充電専用ケーブルは時間を浪費します。
スマートフォンの画面上の指示もケーブルと同じくらい重要です。 ‘USBデバッグを許可する?’と表示されない場合は、コンピューターはデバイスを認識するかもしれませんが、ADBは使用できません。
最初に接続すると、Androidはコンピューターを信頼するかどうか尋ねます。開発用マシンである場合は、許可を永続的にするようにしてください。そうしないと、後続のワークフローが失敗し、実際よりも複雑に見えます。
ADBインストールAPKワークフロー
設定が完了したら、インストールパスは短くなります。よくある間違いは、次のコマンドが成功する可能性があるかどうかを判断するためのチェックをスキップすることです。
デバイスをインストールする前に確認してください
最初に実行してください
adb devices
接続されたシリアル番号と健常なデバイス状態を確認したいです。デバイスが未承認の状態で表示される場合は、そこで停止し、認証を修正してインストールを試みる前に、修正してください。
デバッグ、QA、リリース候補の出力を取り扱うチームにとって、どのようなビルドをプッシュしているか明確にすることも役立ちます。この概要は、フォルダが同名のAPKで満杯の場合に便利な参考資料です。 モバイルアプリビルドの種類 Run the Install Command
基本的なコマンドは簡単です。
パスがスペースを含む場合は、シェルで引用してください。APKが同じフォルダ内にある場合は、コマンドがさらに短くなります。
adb install path/to/your-app.apk
正常な実行では、ストリーミングインストールメッセージとターミナルで成功メッセージが表示されます。そうすると、パッケージマネージャーがAPKを受け入れてインストールを完了したことを確認できます。
adb install app-debug.apk
ここでは、実行の流れを確認したい場合は、以下の手順を参照してください。
ストリーミングインストールは、手動プッシュとPMインストールを上回る利点があります
Why Streamed Install Beats Manual Push and Pm Install
内部では、ファイルのコピーだけを実行しているのではなく、 adb install APKを内部でプッシュし、 /data/local/tmpを呼び出し、 pm installを呼び出し、 一時ファイルを削除します。ストリーミング ワークフローは、 “ストリーミング インストールを実行中” に続き、“成功”
となります。これは、前回のセットアップ リファレンスで概説されている実装詳細に基づいています。 adb push これは重要な点です。古い2ステップの習慣である
- を実行し、 パッケージ マネージャー コマンドを自分で呼び出す必要がありました。ストリーミング インストールは、実際の作業ではいくつかの利点があります:
- デバイスの雑多さを減らす: 一時的なアーティファクトは自動的に削除されます。
- ドリフトの可能性を減らす: ファイルを誤って 1 つだけプッシュし、別のファイルをインストールすることはありません。
もし利用できるなら
adb installそれを使用することをお勧めします。マニュアルプッシュプラスシェルインストールはエッジケース用に便利ですが、通常のアプリケーションテストのデフォルトパスではありません。
ADB インストール APK ワークフローでは、次のループが中心です：デバイスの検証、インストール実行、成功確認、アプリケーション起動、ビルドの次の繰り返し。
ADB インストールフラグのマスター
基本コマンドはAPKを電話に転送します。フラグは、プロセスが実際の開発に適合するか、開発者に戦い続けるかを決定します。
ADB インストールフラグとその使用方法
| フラグ | 説明 | 一般的な使用例 |
|---|---|---|
-r |
既存アプリを再インストールして、アプリデータを保持する | 毎日デバッグビルドの反復 |
-d |
バージョンを下げる | ロールバックシナリオや古いビルドのテスト |
-g |
インストール時点で実行時許可を付与 | カメラ、ストレージ、位置情報などの機能のテストを高速化 |
通常の開発で最も重要なフラグは -r.
なければ、既にインストールされているパッケージを更新することが多く失敗する。Androidは、新しいAPKを競合するインストール試行として扱うのではなく、置き換えとして扱うためである。そのため、多くの開発者は adb install -r app-debug.apk デフォルトの筋肉記憶として
どのフラグが毎日開発で重要か
-r is the one you’ll use constantly. If you’re testing a Capacitor app and rebuilding several times an hour, uninstalling the app on every cycle is slow and wipes useful local state. Reinstall lets you keep moving.
-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__の一般的なコマンドと修正ガイド Capacitor開発のコマンドライン側のより広範なリフレッシュを望む場合は、このCapacitorとCLIの一般的なコマンドと修正ガイド コモンなインストールエラーのトラブルシューティング
ADBは信頼できるので、繰り返しエラーは通常、特定の問題に寄与します。インストールエラーをランダムなものとして扱うのではなく、特定の問題に寄与するものに焦点を当てましょう。エラーは、認証、パッケージの置換、パッケージの特性に関連しています。
Androidデバッグブリッジ（ADB）インストールエラーのトラブルシューティングチェックリストと、開発者向けの解決策
症状:
未承認
adb devices原因:電話がコンピューターを信頼していない、またはプロンプトが閉じられた。unauthorized
修正方法は次のとおりです:
__CAPGO_KEEP_0__開発のコマンドライン側のより広範なリフレッシュを望む場合は、この__CAPGO_KEEP_0__と__CAPGO_KEEP_1__の一般的なコマンドと修正ガイド
- デバイスを再接続する そしてロック画面を閉じる
- 電話でRSA認証のプロンプトを探す 電話で
- プロンプトを承認する「常に許可する」オプションで開発用マシンで
- まだ回復しない場合は、ADBサーバーを再起動する:
adb kill-server
adb start-server
端末が問題を技術的に見せているように思えるかもしれませんが、実際の解決策は電話自体にあります。
パッケージがすでに存在する場合
症状:
INSTALL_FAILED_ALREADY_EXISTS
通常、既存のパッケージに置き換えフラグを使用せずにインストールしようとしていることを意味します。この一般的な誤りは、この ADBインストール失敗に関するStack Overflowの議論.
最速の解決策は:
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上のアプリインストールエラーを解決するためのガイドを参照してください。実際には、QAチームは内部デバッグ配布のためにADBを使用するのではなく、適時な手動サイドロードに頼るのではなく、内部デバッグ配布のためにADBを使用することをお勧めします。
Field note: ADBを介してビルドが成功した場合でも、タップでインストールが失敗した場合、APKが破損しているのではなく、署名コンテキストとインストールパスを確認してください。
Capacitor プロジェクトがネイティブとウェブ層でビルドとデプロイの問題を繰り返す場合、このトラブルシューティングガイドは Capacitor でAndroidビルドエラーを解決するのに役立ちます。 Capacitor の解決 __CAPGO_KEEP_0__ 開発者向けの完全な例
Capacitor プロジェクトでは、ターミナルループは通常短いです。ネイティブファイルを同期し、Androidアプリをビルドし、接続されたデバイスにAPKをプッシュし、Android Studioを開く必要がある場合は除きます。
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.
通常のAndroidビルドステップからデバッグAPKをビルドし、置換を有効にした状態でインストールしてください。
npx cap sync android
これは、フィードバックループを短く保つために、多くのチームが採用しているワークフローです。CapacitorJSアプリケーションでは、差分アップデートを配信するチームがいます。
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
That’s the workflow many teams lean on because it keeps the feedback loop tight. For CapacitorJS apps, where teams ship differential updates, adb install ADBによるAPKのインストールは、特に重要です。IBMの研究では、Androidベースのモバイルチームの78％がリアルタイムのJavaScriptとCSS修正のためにPlayストアの提出よりもそれを好んでいました。 この動画リファレンスは、企業ワークフローにおけるADBベースのAPKのインストールについてのものです。 まだそのワークフローのプロジェクト側を設定中の場合は、この __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ インストールガイド.
は、良い出発点です。 Capacitor CLI installation guide __CAPGO_KEEP_0__は、署名されたライブアップデート、ステージドロールアウト、ロールバック保護、デバイスごとの可視性を提供することで、より速く動作することができます。
If your team uses Capacitor and wants to ship JavaScript, CSS, config, and asset fixes without waiting on app store review, Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
