ブラウザの対応を確認中…
INSTALL_FAILED_* リファレンス
このページが認識する失敗コードと、その意味・対処です。コードは Android 自身の定数で、デスクトップの `adb install` が出すものと同じです。
既にあるものが邪魔している
- INSTALL_FAILED_ALREADY_EXISTS
- このパッケージはすでにインストールされていて、今回のインストールに置き換えの指定がありませんでした。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_UPDATE_INCOMPATIBLE
- 同じパッケージ名のアプリがすでに入っていますが、署名鍵が違うため Android はこれを更新として扱いません。
- 署名証明書をインストール済みのアプリと見比べてください。Android は鍵の違うアプリで上書きすることを許しません。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_VERSION_DOWNGRADE
- APK のバージョンコードがインストール済みのものより低く、ダウングレードは既定で拒否されます。
- 「ダウングレードを許可」（`-d`）を有効にして再試行するか、新しいほうを先に削除します。新しい版が書いたデータは古い版で読めないことがあります。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_DUPLICATE_PACKAGE
- このパッケージ名は端末上の別のパッケージがすでに使っています。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_SHARED_USER_INCOMPATIBLE
- APK が宣言している `sharedUserId` が、その共有ユーザーで動いている既存アプリと衝突しています。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- 署名証明書をインストール済みのアプリと見比べてください。Android は鍵の違うアプリで上書きすることを許しません。
- INSTALL_FAILED_UID_CHANGED
- インストール済みのアプリが持つ Linux UID を変更することになり、既存データが行き場を失います。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_REPLACE_COULDNT_DELETE
- 置き換えのために前のバージョンを削除しようとして失敗しました。
- 端末を再起動してから、もう一度試してください。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
- INSTALL_FAILED_DUPLICATE_PERMISSION
- APK が定義している権限名を、すでに別のアプリが定義しています。
- 同じ content authority または権限名を、すでに別のアプリが押さえています。そのアプリを見つけて削除してから再試行してください。
- INSTALL_FAILED_CONFLICTING_PROVIDER
- APK が宣言している content provider の authority を、すでに別のアプリが持っています。
- 同じ content authority または権限名を、すでに別のアプリが押さえています。そのアプリを見つけて削除してから再試行してください。
- INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE
- インストール済みのアプリは実行時権限を使っており、この APK はインストール時権限モデルの古い Android 向けです。その方向の入れ替えは許されません。
- 先に入っているほうをアンインストールしてから入れ直します。そのアプリのデータは失われます。
APK と端末が噛み合わない
- INSTALL_FAILED_OLDER_SDK
- APK がこの端末より新しい Android を要求しています（`minSdkVersion` が端末の API レベルより上）。
- APK が宣言している SDK の範囲がこの Android バージョンに合っていません。`minSdkVersion` / `targetSdkVersion` を端末のリリースと突き合わせてください。
- INSTALL_FAILED_NEWER_SDK
- APK はこの端末より古い Android 向けに作られており、宣言された最大 SDK がこの端末を除外しています。
- APK が宣言している SDK の範囲がこの Android バージョンに合っていません。`minSdkVersion` / `targetSdkVersion` を端末のリリースと突き合わせてください。
- INSTALL_FAILED_NO_MATCHING_ABIS
- APK にネイティブライブラリは入っていますが、この端末が対応する CPU アーキテクチャ向けのものがありません。
- この APK にはこの端末の CPU 向けのネイティブコードが入っていません。端末の ABI 向けのビルドを入手するか、単体の APK ではなく分割セット全体をインストールしてください。
- コンテナに入っている分割セット全体をインストールしてください。分割 APK は単体ではインストールできません。
- INSTALL_FAILED_CPU_ABI_INCOMPATIBLE
- APK のネイティブコードが端末の CPU アーキテクチャと合いません。
- この APK にはこの端末の CPU 向けのネイティブコードが入っていません。端末の ABI 向けのビルドを入手するか、単体の APK ではなく分割セット全体をインストールしてください。
- INSTALL_FAILED_MISSING_FEATURE
- APK が要求しているハードウェアまたはソフトウェア機能を、この端末は持っていると申告していません。
- APK が宣言している SDK の範囲がこの Android バージョンに合っていません。`minSdkVersion` / `targetSdkVersion` を端末のリリースと突き合わせてください。
- INSTALL_FAILED_MISSING_SPLIT
- これは分割アプリの一部で、依存している他の部分が入っていません。config 分割や機能モジュールは単独では成立しません。
- コンテナに入っている分割セット全体をインストールしてください。分割 APK は単体ではインストールできません。
- INSTALL_FAILED_DEPRECATED_SDK_VERSION
- Android 14 以降は、非常に古い SDK レベルを対象とするアプリのインストールを、署名にかかわらず拒否します。
- APK が宣言している SDK の範囲がこの Android バージョンに合っていません。`minSdkVersion` / `targetSdkVersion` を端末のリリースと突き合わせてください。
ストレージ
- INSTALL_FAILED_INSUFFICIENT_STORAGE
- このアプリを入れるだけの空き容量が端末にありません。
- 端末の空き容量を空けてから再試行します。インストールには APK 本体に加えてコンパイル後のコードの分も必要です。
- INSTALL_FAILED_MEDIA_UNAVAILABLE
- インストール先のストレージがマウントされていないか、インストール中に外れました。
- もう一度試してください。この失敗はたいてい一時的なものです。
- 端末を再起動してから、もう一度試してください。
- INSTALL_FAILED_CONTAINER_ERROR
- アプリのファイルをコピーする入れ物を Android が用意できませんでした。多くは下層のストレージの問題です。
- 端末の空き容量を空けてから再試行します。インストールには APK 本体に加えてコンパイル後のコードの分も必要です。
- もう一度試してください。この失敗はたいてい一時的なものです。
検証・ポリシー・ビルドフラグによる拒否
- INSTALL_FAILED_TEST_ONLY
- APK に `android:testOnly` が付いており、通常のインストールでは拒否されます。
- 「テストビルドを許可」（`-t`）を有効にして再試行します。この APK はデバッグ／テスト用として作られています。
- INSTALL_FAILED_VERIFICATION_FAILURE
- パッケージ検証機構（多くの端末では Play プロテクト）が APK を調べて拒否しました。
- Play プロテクトが APK を検査して拒否しました。「Play プロテクトによるアプリのスキャン」または開発者向けオプションの「USB 経由のアプリを確認」を切ってから再試行します。
- もう一度試してください。この失敗はたいてい一時的なものです。
- INSTALL_FAILED_VERIFICATION_TIMEOUT
- パッケージ検証機構が時間内に応答せず、インストールが取り消されました。
- もう一度試してください。この失敗はたいてい一時的なものです。
- Play プロテクトが APK を検査して拒否しました。「Play プロテクトによるアプリのスキャン」または開発者向けオプションの「USB 経由のアプリを確認」を切ってから再試行します。
- INSTALL_FAILED_USER_RESTRICTED
- デバイスポリシーまたはユーザー制限が、この方法でのアプリインストールを禁止しています。
- 画面のロックを解除し、端末側に出るダイアログに答えてください。端末での確認を必要とするインストールは、放置すると黙ってタイムアウトします。
- 仕事用プロファイル、デバイスオーナー、または保護者による制限がインストールを止めています。設定 → ユーザーを確認するか、端末の管理者に確認してください。
- INSTALL_FAILED_ABORTED
- インストールセッションがコミット前に取り消されました。端末側のダイアログに応答していない、画面がロックされている、別のインストールにセッションを奪われた、などが典型です。
- 画面のロックを解除し、端末側に出るダイアログに答えてください。端末での確認を必要とするインストールは、放置すると黙ってタイムアウトします。
- もう一度試してください。この失敗はたいてい一時的なものです。
APK として読めない
- INSTALL_FAILED_INVALID_APK
- Android が APK を正しいパッケージとして受け付けませんでした。アーカイブの破損、分割セットの不整合、同じ分割の二重書き込みなどです。
- コンテナに入っている分割セット全体をインストールしてください。分割 APK は単体ではインストールできません。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
- INSTALL_FAILED_BAD_SIGNATURE
- APK の署名が検証できませんでした。署名後にファイルが変更されたか、署名ブロックが壊れています。
- 署名証明書をインストール済みのアプリと見比べてください。Android は鍵の違うアプリで上書きすることを許しません。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
- INSTALL_PARSE_FAILED_NOT_APK
- そもそも APK ではありません。インストーラーが APK として読めませんでした。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
- INSTALL_PARSE_FAILED_NO_CERTIFICATES
- APK に有効な署名がありません。未署名の APK や、再パック時に署名ファイルが落ちた APK がここに来ます。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
- 署名証明書をインストール済みのアプリと見比べてください。Android は鍵の違うアプリで上書きすることを許しません。
- INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES
- このセットの APK が同じ鍵で署名されていません。一つのアプリの分割はすべて base と同じ署名である必要があります。
- 署名証明書をインストール済みのアプリと見比べてください。Android は鍵の違うアプリで上書きすることを許しません。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
- INSTALL_PARSE_FAILED_MANIFEST_MALFORMED
- APK の `AndroidManifest.xml` を解析できませんでした。
- ファイルが正しい APK ではないか、壊れた状態で届いています。元の配布元から取り直してください。
インストールセッションやフレームワークの失敗
- INSTALL_FAILED_INTERNAL_ERROR
- パッケージインストーラーが内部エラーを起こし、それ以上の説明はありませんでした。
- もう一度試してください。この失敗はたいてい一時的なものです。
- 端末を再起動してから、もう一度試してください。
- INSTALL_FAILED_DEXOPT
- コピー後のコードのコンパイルに失敗しました。多くは空き容量不足、まれに DEX の破損です。
- 端末の空き容量を空けてから再試行します。インストールには APK 本体に加えてコンパイル後のコードの分も必要です。
- 端末を再起動してから、もう一度試してください。
- もう一度試してください。この失敗はたいてい一時的なものです。