名稱是新的還是現有的 (已有安裝記錄),會影響註冊套件名稱的程序。
步驟 1:輸入套件名稱 (新舊套件名稱皆通用)
- 前往「Android 開發人員驗證」頁面。
- 在「套件名稱」分頁中,選取「註冊套件名稱」。
- 輸入想註冊的套件名稱。
- 取個好記的名稱,以便日後在 Play 管理中心內找到。
- 選取「下一步」繼續操作。
步驟 2:註冊金鑰
下一個步驟取決於要註冊新的或現有套件名稱。
A. 註冊新套件名稱
如果是從未出現在 Android 的新套件名稱,請提供應用程式簽署金鑰組的公用金鑰憑證。
- 選取「新增金鑰」。
- 提供應用程式簽署金鑰組的公用金鑰憑證 (Android 會使用這組簽署金鑰,確認應用程式更新是由您提供)。瞭解如何找出 SHA-256 公用憑證。
- 輸入金鑰,然後點選「新增金鑰」。
B. 註冊現有套件名稱
註冊現有套件名稱時,須證明對已知私密簽署金鑰的擁有權。
- 前往「選取金鑰」。
- 與註冊新名稱時不同,畫面上會列出符合條件的公用憑證指紋,這些金鑰可用於直接註冊。
- 您可以掃視清單,也可以直接搜尋憑證指紋。
- 選取金鑰 (如有列出),然後點選「新增金鑰」。
- 您會回到註冊頁面,並得知已加入金鑰。
金鑰資格條件規則和套件名稱使用申請
為了減少共用套件名稱的情況 (Android 開發人員驗證程序的一環),我們制定了套件名稱資格條件規則,並據此列出符合條件的金鑰。
如果套件名稱由多位開發人員共用,或有多組簽署金鑰,則資格條件如下所示:
|
狀況 |
直接註冊規則 |
其他開發人員適用規則 |
|
多數金鑰持有者 |
占已知安裝總數超過 50% 的金鑰會優先使用。 |
其他開發人員皆須提出申請。 |
|
安裝超過 50 次 |
如果沒有任何金鑰的安裝次數占比超過 50%,則安裝超過 50 次的金鑰皆符合條件。 |
安裝金鑰少於 50 次的開發人員須提出申請。 |
|
安裝少於 50 次 |
如果沒有任何金鑰達到 50 次安裝的門檻,則所有已知金鑰皆採「先申請先使用」原則。 |
一位開發人員註冊,其他人皆須提出申請。 |
如果 SHA-256 指紋憑證不符條件,雖然仍可註冊,但必須先向 Google 提出申請,而且不一定能通過:
- 展開頁面上的其他金鑰清單。
- 確認您瞭解以這種方式要求使用套件名稱,會造成哪些影響。
- 除了證明擁有權 (參閱步驟 3),還必須說明使用該套件名稱的原因 (例如遷移使用者可能會導致無法發行應用程式)。
搶先體驗期間,只能註冊您擁有合格金鑰的應用程式套件名稱;等到 2026 年 3 月正式推出時,就能使用其他金鑰註冊套件。
步驟 3:驗證私密金鑰擁有權 (僅限現有套件)
驗證現有套件名稱時,須使用與您所提供公用金鑰對應的私密金鑰,簽署並上傳 APK。
- 選取「上傳 APK」,開始驗證擁有權。
- 接下來,畫面會顯示套件名稱、所選 SHA-256 公用憑證,以及簽署方式說明。
- 複製程式碼片段,也就是開發人員帳戶專屬 ID。
- 準備 APK:在 IDE 內 (使用套件同名的空白專案,或實際的應用程式),前往應用程式的來源樹狀結構。
- 在 assets 資料夾內建立檔案,名稱須為
adi-registration.properties。 - 開啟檔案,貼上程式碼片段。
- 查看 GitHub 範例專案,確認結構和程式碼片段符合證明擁有權的條件。
- 建構及簽署:建構發布版 APK,並以對應公開憑證指紋的私密金鑰簽署。透過
jarsigner或 GradlesigningConfigs完成的簽章,可做為合法擁有權的證明。備註:使用委派簽署金鑰的應用程式註冊套件名稱如果您註冊的套件名稱屬於應用程式,且私密簽署金鑰已委派給第三方發行平台 (例如 Samsung Galaxy Store),請改為按照下列步驟證明私密金鑰擁有權。- 建構發布版 APK 或 AAB,然後上傳到發行平台。
- 直接從該發行平台下載簽署的最終發布版 APK。
- 將您在步驟 9 下載的已簽署 APK 上傳到 Play 管理中心。
- 上傳:返回 Play 管理中心,選取「上傳」,然後找出並上傳簽署的發布版 APK。Android 會檢查簽章,並於確認無誤後登記擁有權。
步驟 4:追蹤套件名稱註冊狀態
Android 會正式嘗試註冊套件名稱,並將其連結到您通過驗證的 Play 開發人員身分。
完成後,便會收到電子郵件通知。
您可以到「套件」頁面追蹤註冊和金鑰狀態。
新增金鑰
註冊套件名稱後即可新增金鑰。
- 選取「上傳 APK」,開始驗證擁有權。
- 接下來,畫面會顯示套件名稱、所選 SHA-256 公用憑證,以及簽署方式說明。
- 複製程式碼片段,也就是開發人員帳戶專屬 ID。
- 準備 APK:在 IDE 內 (使用套件同名的空白專案,或實際的應用程式),前往應用程式的來源樹狀結構。
- 在 assets 資料夾內建立檔案,名稱須為 adi-registration.properties。
- 開啟檔案,貼上程式碼片段。
- 查看 GitHub 範例專案,確認結構和程式碼片段符合證明擁有權的條件。
- 建構及簽署:建構發布版 APK,並以對應公開憑證指紋的私密金鑰簽署。透過
jarsigner或Gradle signingConfigs完成的簽章,可做為合法擁有權的證明。 - 上傳:返回 Play 管理中心,選取「上傳」,然後找出並上傳簽署的發布版 APK。Android 會檢查簽章,並於確認無誤後登記擁有權。