使用 Play 應用程式簽署功能

整個程序的運作流程如下：

1. 簽署您的應用程式套件，然後上傳至 Play 管理中心。
2. Google 會從您的應用程式套件中產生最佳化 APK，並以應用程式簽署金鑰進行簽署。
3. Google 會使用 apksigner 在應用程式資訊清單中加入兩個戳記 (com.android.stamp.source 和 com.android.smtp.type)，然後使用應用程式簽署金鑰簽署 APK。apksigner 加入的戳記可以追蹤 APK 簽署者的身分。
4. Google 將已簽署的 APK 發布給使用者。

當您使用 Google 產生的金鑰，Google 會自動產生 4096 位元的加密高強度 RSA 金鑰。如果您選擇自行上傳應用程式簽署金鑰，則必須使用 2048 位元以上的 RSA 金鑰。

步驟 1：設定 Play 應用程式簽署功能

1. 開啟 Play 管理中心，然後前往「Play 應用程式簽署」頁面 (依序點選「

   測試及發布

   」>「設定」>「應用程式簽署」)。
   • 提示：您也可以透過「應用程式完整性」頁面 (依序點選「

     測試及發布

     」>「應用程式完整性」) 存取這個頁面，其中包含完整性和簽署服務，有助於確保使用者在應用程式和遊戲中獲得您希望提供的體驗。
2. 如果您尚未接受《Play 應用程式簽署服務條款》，請詳閱條款內容並選取「接受」。

步驟 2：將原始金鑰的副本傳送給 Google 並建立上傳金鑰

1. 找出您的原始應用程式簽署金鑰。
2. 開啟 Play 管理中心，然後前往「Play 應用程式簽署」頁面 (依序點選「

   測試及發布

   」>「設定」>「應用程式簽署」)。
3. 選取最適合您發布流程的匯出及上傳選項，然後上傳您現有的應用程式簽署金鑰。

步驟 3：建立上傳金鑰 (建議選用此步驟)

1. 建立上傳金鑰，然後將憑證上傳至 Google Play。
   • 您也可以繼續將應用程式簽署金鑰當做上傳金鑰使用。
2. 複製您應用程式簽署憑證的指紋 (MD5、SHA-1 及 SHA-256)。
   • 為了進行測試，您可能需要使用此憑證的指紋向 API 供應商註冊上傳金鑰的憑證，以及註冊應用程式簽署金鑰。

步驟 4：使用上傳金鑰簽署後續的應用程式更新

發布應用程式更新時，請務必使用上傳金鑰簽署更新檔。

• 如果您先前未產生新的上傳金鑰：繼續使用原始應用程式簽署金鑰簽署應用程式套件，然後將應用程式套件上傳至 Google Play。如果遺失原始應用程式簽署金鑰，可以產生新的上傳金鑰，再向 Google 註冊該金鑰，以便繼續更新應用程式。
• 如果您已產生新的上傳金鑰：使用新的上傳金鑰簽署應用程式套件，然後將應用程式套件上傳至 Google Play。Google 會使用上傳金鑰驗證您的身分。如果您遺失了上傳金鑰，請與支援團隊聯絡以重設金鑰。

如果您無法提供現有金鑰，就可能需要選擇升級應用程式簽署金鑰以進行註冊。但在執行作業前，請注意下列事項：

• 這種做法需要雙重發布。
• 您必須在每個版本中上傳應用程式套件和舊版金鑰簽署的 APK。對於搭載 Android R* (API 級別 30) 以上版本的裝置，Google Play 會利用您的應用程式套件產生使用新版金鑰簽署的 APK。您的舊版 APK 則會用於較舊的 Android 版本 (API 級別 29 以下)。

*如果您的應用程式使用了 sharedUserId，建議您針對搭載 Android T (API 級別 33) 以上版本的裝置，提供採用升級金鑰的安裝檔和更新檔。如要進行這項設定，請在應用程式套件配置中設定正確的 SDK 版本下限。

步驟 1：上傳新版金鑰並產生及上傳輪替證明

為了讓新版金鑰取得 Android 裝置信任，請務必從存放區上傳新的簽署金鑰，然後產生並上傳輪替證明：

1. 開啟 Play 管理中心，然後前往「Play 應用程式簽署」頁面 (依序點選「

   測試及發布

   」>「設定」>「應用程式簽署」)。
   • 提示：您也可以透過「應用程式完整性」頁面 (依序點選「

     測試及發布

     」>「應用程式完整性」) 存取這個頁面，其中包含完整性和簽署服務，有助於確保使用者在應用程式和遊戲中獲得您希望提供的體驗。
2. 點選「應用程式簽署」分頁標籤。
3. 按一下「顯示進階選項」，然後選取「使用新的應用程式簽署金鑰 (需要兩個發布中的版本)」。
4. 選擇使用與開發人員帳戶中的其他應用程式相同的應用程式簽署金鑰，或是從 Android Studio、Java KeyStore 或其他存放區上傳新的應用程式簽署金鑰。
5. 按照畫面上的指示下載並執行 PEPK 工具。
6. ZIP 檔案準備就緒後，請按一下「上傳事先產生的 ZIP 檔案」，然後將 ZIP 檔案上傳至 Play 管理中心。
7. 在「5. 透過上傳輪替證明，允許在 Android 裝置上信任新的金鑰」旁邊，按一下「顯示操作說明」。
8. 下載 APKSigner 並執行以下指令，產生輪替證明：
   • $ apksigner rotate --out /path/to/new/file --old-signer --ks old-signer-jks --set-rollback true --new-signer --ks new-signer-jks --set-rollback true
9. 按一下「上傳產生的輪替證明檔案」，然後上傳您在步驟 8 中產生的輪替證明。
10. 按一下「儲存」。

• 必須為 2048 位元以上的 RSA 金鑰。

建立上傳金鑰後，請檢查下列位置並進行更新：

• 本機電腦
• 鎖定的內部部署伺服器 (變動式 ACL)
• 雲端代管系統 (變動式 ACL)
• 專屬機密管理服務
• (Git) 存放區

注意：提出金鑰升級要求前，請先瞭解完成升級後可能須進行哪些變更。

• 如果您使用相同的應用程式簽署金鑰來簽署多個應用程式，藉此在應用程式間共用資料或程式碼，就必須將應用程式更新為可同時辨識新舊版應用程式簽署金鑰憑證。在搭載 Android S (API 級別 32) 以下版本的裝置上，為了共用資料或程式碼，Android 平台只會辨識舊版應用程式簽署金鑰憑證。
• 如果您的應用程式使用 API，請先向 API 供應商註冊新舊版應用程式簽署金鑰的憑證，之後再發布更新檔，以確保 API 能繼續運作。如需取得憑證，請前往 Play 管理中心的「Play 應用程式簽署」頁面 (依序點選「

  測試及發布

  」>「設定」>「應用程式簽署」)。 
• 如果您有使用者是透過點對點共用管道安裝更新檔，則他們只能安裝特定更新，這些更新與他們安裝的應用程式版本必須使用相同的簽署金鑰。如果他們因應用程式版本所用的簽署金鑰不同，導致無法更新應用程式，則可選擇解除安裝應用程式並重新安裝，以便取得更新檔。

對於 Android N (API 級別 24) 以上版本的所有安裝檔，每個應用程式每年可以要求升級應用程式簽署金鑰一次。

如果您成功要求升級金鑰，系統就會使用新的金鑰簽署所有安裝檔和應用程式更新檔。在搭載 Android T (API 級別 33) 以上版本的裝置上，Android 平台則會強制使用升級金鑰。在搭載 Android S (API 級別 32) 以下版本的裝置上，Android 平台不會強制使用此升級金鑰，仍會將舊版簽署金鑰視為應用程式的簽署金鑰。這也包括需要應用程式簽署金鑰的所有 Android 平台功能 (例如自訂權限共用功能)。在搭載 Android N (API 級別 24) 至 Android S (API 級別 32) 的裝置上，Google Play 安全防護會檢查應用程式更新是否已透過升級金鑰簽署，除非使用者關閉這項設定。Android 平台不會在搭載 Android S (API 級別 32) 以下版本的裝置上強制使用升級金鑰，因此上述檢查機制會提供額外的驗證措施。

1. 開啟 Play 管理中心，然後前往「Play 應用程式簽署」頁面 (依序點選「

   測試及發布

   」>「設定」>「應用程式簽署」)。
   • 提示：您也可以透過「應用程式完整性」頁面 (依序點選「

     測試及發布

     」>「應用程式完整性」) 存取這個頁面，其中包含完整性和簽署服務，有助於確保使用者在應用程式和遊戲中獲得您希望提供的體驗。
2. 在「升級應用程式簽署金鑰」資訊卡中，選取「要求升級金鑰」。
3. 選取任一選項即可升級應用程式簽署金鑰，用於 Android N 以上版本的所有安裝檔。
4. 讓 Google 產生新的應用程式簽署金鑰 (建議做法) 或上傳一組金鑰。
   • 將應用程式簽署金鑰升級後，如果您使用的上傳金鑰和應用程式簽署金鑰是同一組金鑰，則可繼續將舊版應用程式簽署金鑰當做上傳金鑰使用，也可產生一組新的上傳金鑰。
5. 選取要求升級應用程式簽署金鑰的原因。
6. 如有需要，請向 API 供應商註冊新的應用程式簽署金鑰。

提示：如果您在多個發行管道發行應用程式，並希望為使用者盡量提高應用程式更新的相容性，則應該在每個發行管道升級金鑰。如要與 Google Play 金鑰升級相容，請使用 Android SDK Build Tools (修訂版本 33.0.1 以上) 隨附的 ApkSigner 工具：

$ apksigner sign --in ${INPUT_APK}

--out ${OUTPUT_APK}

--ks ${ORIGINAL_KEYSTORE}

--ks-key-alias ${ORIGINAL_KEY_ALIAS}

--next-signer --ks ${UPGRADED_KEYSTORE}

--ks-key-alias ${UPGRADED_KEY_ALIAS}

--lineage ${LINEAGE}

進一步瞭解應用程式更新的運作方式。