Android デベロッパー確認の署名鍵を登録する方法

インストール済みアプリを署名する証明書を登録する

利用者が実際にインストールするアーティファクトから始めます。Play アプリ署名では、Google がアプリ署名鍵で配布 APK を署名し、アップロード鍵は送信の認証だけに使います。ウェブ配布や別ストアは別の本番証明書を使う場合があります。

各配布 APK から SHA-256 を抽出し、使われる場所を記録します。慣れたキーストア エイリアスでも、インストール済みアプリを署名していなければ正しい登録値ではありません。

• Play 配信 APK：アプリ署名証明書。
• Play への送信：別用途のアップロード証明書。
• 他チャネル：その本番 APK を調べる。

apksigner verify --print-certs app-release.apk

対象鍵または審査の経路を選ぶ

既存パッケージでは、過去に関連付けられた署名鍵をコンソールが表示する場合があります。利用者に届く版と一致する鍵を選びます。正しい本番鍵が対象外なら、アップロード鍵や debug 鍵を誤選択していないか確認し、公式の申請・審査経路で配布履歴を説明します。

新しいパッケージ名は現行のコンソール手順に従い、パッケージ、証明書、デベロッパー アカウントを一つのリリース記録にまとめます。一覧に出すためだけに代替鍵を作らないでください。

• 鍵エイリアスではなく SHA-256 を比較する。
• 旧版とチャネル専用配布の証拠を残す。
• アプリ更新を継続できる鍵を保全する。

正当な配布鍵をすべて追加する

異なるチャネルや承認済みの署名履歴がある場合、一つのパッケージに複数の正当な署名鍵を持てます。公式の追加鍵手続きから各公開証明書を追加し、フィンガープリントごとにチャネルと担当者を明記します。

コンソールが所有権証明を求めたら、対応する署名鍵でチャレンジを完了します。署名済み APK と adi-registration.properties を使う場合はありますが、秘密鍵そのものをアップロードすることはありません。

• 実際の配布アーティファクトを署名する鍵だけを追加する。
• 秘密鍵は既存の署名システム内に置く。
• コンソールの処理完了を待ってから再照会する。

登録エラーと Play アップロード エラーを分ける

登録不一致はパッケージが別の証明書フィンガープリントで登録済みという意味です。App Bundle が誤った鍵で署名されたという Play の表示は、アップロード鍵または Play アプリ署名の問題です。同じパッケージでも修正箇所が違います。

登録はパッケージと証明書を組み合わせて照会します。AAB の拒否は Play Console の証明書画面とアップロード案内で調べます。失敗層を特定する前に鍵を変えると復旧が難しくなります。

• 登録照会：パッケージ＋公開証明書。
• AAB の拒否：期待されるアップロード証明書。
• Play 配信 ID：アプリ署名証明書。

追加鍵の登録前に分岐を確認

まず公式コンソールで新規 package か既存 package かを確認します。既存 package で `SELECT_KEY_FROM_LIST` が示された場合は、一覧の known key と公開 SHA-256 を実際の配布証明書に照合してください。選んだ公開鍵に対応する秘密鍵で署名した APK が、所有権証明に必要です。

Play App Signing を使うアプリでは、Play 配布用 App signing key と AAB 提出用 upload key のどちらを一覧が求めているか確かめます。別ストアの鍵も混在させず、チャネルごとの APK と証明書を並べてから登録します。

コンソールが justification を要求する場合、単なる鍵の再送では解決しません。パッケージ利用権限を裏付ける事業上の説明を提出し、審査に最大 24 時間かかることをリリース計画に見込みます。

• コンソールで登録済みと表示されても、配布チャネルの本番証明書を別途照合します。
• キーストアや秘密鍵はアップロードせず、APK に含まれた公開証明書だけで照合します。