發佈適用於Google Play發行版的Android應用程式

發行項
07/18/2024

將 Android 應用程式散發給使用者最常見的方法是透過 Google Play。第一次將應用程式提交至Google Play時，它必須透過Google Play控制台提交。後續版本的應用程式可以透過Visual Studio提交。在這兩種情況下，都需要Google Play開發人員帳戶。提交至Google Play的應用程式需要Google的核准。

若要散發 .NET 多平臺應用程式 UI （.NET MAUI） Android 應用程式，您必須先使用密鑰存放區中的金鑰進行簽署，才能上傳至 Google Play。金鑰存放區是做為憑證和私鑰存放庫的二進位檔。

Google Play 需要您將應用程式提交為 Android 應用程式套件組合 （AAB）。 Google Play 會使用您的應用程式套件組合來產生並針對每個裝置設定提供優化的 Android 套件（APK），因此只會下載特定裝置所需的程式代碼和資源來執行您的應用程式。如需 Android 應用程式套件組合的詳細資訊，請參閱關於 developer.android.com 上的 Android 應用程式套件組合。

透過Google Play 散發 .NET MAUI Android 應用程式的程式如下所示：

建立Google Play開發人員帳戶。如需詳細資訊，請參閱建立Google Play開發人員帳戶。
在Google Play 控制台中建立您的應用程式。如需詳細資訊，請參閱在 Google Play 控制台中建立您的應用程式。
在Google Play 控制台中設定您的應用程式。如需詳細資訊，請參閱在 Google Play 控制台中設定您的應用程式。
請確定您的應用程式使用正確的套件格式。如需詳細資訊，請參閱確定正確的套件格式。
在 Visual Studio 中建置並簽署您的應用程式，然後透過 Google Play 控制台加以散發。如需詳細資訊，請參閱透過Google Play控制台散發您的應用程式。

然後，您應用程式的後續版本可以透過 Visual Studio 發佈。如需詳細資訊，請參閱透過Visual Studio散發您的應用程式。

建立Google Play開發人員帳戶

若要在Google Play上發佈 Android 應用程式，您必須建立 Google Play 開發人員帳戶：

使用Google帳戶註冊 Google Play開發人員帳戶。
輸入開發人員身分識別的相關信息。
在註冊程序期間，您必須檢閱並接受 Google Play開發人員發佈合約。
支付一次性 $25 註冊費用。
依照驗證電子郵件中的指示來確認您的身分識別。

重要

您必須先完成身分識別驗證，才能透過Google Play發佈應用程式。此外，新的個人帳戶持有者必須確認他們有權存取真正的 Android 裝置。如需詳細資訊，請參閱 support.google.com 上新開發人員帳戶的裝置驗證需求。

建立 Google Play 開發人員帳戶之後，您就可以開始將應用程式發佈至 Google Play 的程式。

如需詳細資訊，請參閱在 support.google.com 註冊 Google Play 開發人員帳戶。

在Google Play 控制台中建立您的應用程式

建立 Google Play 開發人員帳戶之後，您必須在 Google Play 控制台中建立應用程式：

登入您的 Google Play開發人員帳戶。
在 Google Play 控制台的 [ 所有應用程式 ] 索引標籤上，選取 [ 建立應用程式 ] 按鈕：
在 [ 建立應用程式] 頁面中，輸入您的應用程式詳細數據，然後選取 [ 建立應用程式 ] 按鈕：

如需在Google Play控制台中建立應用程式的詳細資訊，請參閱在 support.google.com 上建立和設定您的應用程式。

在Google Play 控制台中設定您的應用程式

建立應用程式之後，您應該設定它。您的應用程式儀錶板將引導您完成所有最重要的步驟。

若要開始設定您的應用程式，請選取 左側功能表中的 [儀錶板 ]。在頁面頂端的應用程式詳細數據下，您會發現與應用程式設定和發行相關的不同類別和工作。您必須先完成必要工作，才能在 Google Play 上啟動您的應用程式。當您完成工作時，您會看到綠色刻度標記和刪除線文字。區段頂端的進度列也會更新。如需詳細資訊，請參閱在應用程式儀錶板上設定應用程式 support.google.com 。

確定正確的套件格式

若要發佈適用於Google Play發行版的 .NET MAUI Android 應用程式，您的應用程式套件格式為AAB，這是發行組建的預設套件格式。若要確認應用程式的套件格式已正確設定：

在 Visual Studio 方案總管以滑鼠右鍵按兩下 .NET MAUI 應用程式專案，然後選取 [屬性]。然後，流覽至 [Android > 選項] 索引標籤，並確定 [發行] 字段的值設定為配套：

發佈

透過Google Play主控台發布您的應用程式

第一次將 AAB 提交至 Google Play 時，必須透過 Google Play 控制台手動上傳。這可讓Google Play將所有未來套件組合上的金鑰簽章與用於第一個應用程式版本的原始密鑰相符。若要透過Google Play控制台上傳應用程式，必須先在Visual Studio中建置並登入該應用程式。

若要在 Visual Studio 中建置並簽署您的應用程式：

在 Visual Studio 工具列中，使用 [ 偵錯目標 ] 下拉式清單選取 [Android 模擬器]，然後選取 您選擇的模擬器 ：
在 Visual Studio 工具列中，使用 [ 解決方案組態 ] 下拉式清單，從偵錯組態變更為發行組態：
在 方案總管 中，以滑鼠右鍵按兩下 .NET MAUI 應用程式項目，然後選取[發佈...] ：

封 存管理員 隨即開啟，Visual Studio 會開始封存您的應用程式套件組合：
在封存管理員中，一旦封存順利完成，請確定已選取您的封存，然後選取 [散發 ...] 按鈕，開始散發應用程式的程式：

[ 散發 - 選取通道 ] 對話框隨即出現。

在 [ 散發 - 選取通道 ] 對話框中，選取 [ 臨機操作 ] 按鈕：
在 [ 散發 - 簽署身分 識別] 對話框中，選取 + 按鈕以建立新的簽署身分識別：

[ 建立 Android 金鑰存放區 ] 對話框隨即出現。

注意

或者，選取 [匯入] 按鈕，即可使用現有的簽署身分識別。
在 [ 建立 Android 金鑰存放區 ] 對話框中，輸入建立稱為 密鑰存放區的新簽署身分識別所需的資訊，然後選取 [ 建立 ] 按鈕：
- 別名。輸入金鑰的識別名稱。
- 密碼：建立並確認金鑰的安全密碼。
- 有效性。設定金鑰的有效時間長度，以年份為單位。
- 完整名稱、組織單位、組織、城市或地區、州或省，以及國家/地區代碼。此資訊不會顯示在您的應用程式中，但包含在您的憑證中。
新的密鑰存放區，其中包含新的憑證，將會儲存至 C：\Users{Username}\AppData\Local\Xamarin\Mono for Android\Keystore{Alias}{Alias}.keystore。

重要

金鑰存放區和密碼不會儲存至您的 Visual Studio 解決方案。因此，請確定您備份此數據。如果您遺失它，您將無法使用相同的簽署身分識別來簽署您的應用程式。
在 [ 散發 - 簽署身 分識別] 對話框中，選取新建立的簽署身分識別，然後選取 [ 另存新檔 ] 按鈕：

封 存管理員 會顯示發佈程式。
在 [ 另存新檔 ] 對話框中，確認套件的位置和檔名正確，然後選取 [ 儲存 ] 按鈕。
在 [ 簽署密碼 ] 對話框中，輸入您的簽署身分識別密碼，然後選取 [ 確定] 按鈕：
在 [封存管理員] 中，選取發佈程式完成後的 [開啟散發] 按鈕：

Visual Studio 會開啟包含已發佈應用程式的資料夾。

然後，您可以透過Google Play主控台將已發布的應用程式發行至Google Play。若要這樣做，您必須先在Google Play控制台中建立發行。發行是一或多個應用程式版本的組合，您將準備以啟動應用程式，或推出更新。您可以在下列追蹤上建立發行：

內部測試。您最多可以選擇 100 名測試人員可以使用內部測試版本。
封閉式測試。關閉的測試版本可供您選擇的有限測試人員使用，這些測試人員可以測試應用程式的發行前版本，並提交意見反應。
開啟測試。 Google Play 上的測試人員可以使用開放式測試版本。用戶可以從您的市集清單加入測試。
生產。生產版本可供所選國家/地區的所有Google Play使用者使用。

如需在Google Play控制台中建立發行的詳細資訊，請參閱準備並推出 support.google.com 版本。

重要

提交至Google Play的應用程式通常會經歷檢閱程式。如需詳細資訊，請參閱準備您的應用程式以檢閱和在 support.google.com 上發佈您的應用程式。

透過 Visual Studio 散發您的應用程式

AAB 必須已提交至Google Play，並已通過檢閱，才能從Visual Studio散發。如果您嘗試從尚未從 Play Console 上傳的 Visual Studio 散發 AAB，您會收到下列錯誤：

Google Play 要求您手動上傳此應用程式的第一個套件（APK/AAB）。您可以為此使用臨機操作套件。

發生此錯誤時，請透過Google Play控制台手動上傳AAB。接著可以透過Visual Studio發佈應用程式的後續版本。不過，您必須變更每個上傳的應用程式版本代碼，否則會發生下列錯誤：

已上傳版本代碼為（1）的 AAB。

若要解決此錯誤，請使用不同的版本號碼重建應用程式，然後透過Visual Studio重新提交至Google Play。

注意

藉由增加應用程式項目檔中整數屬性的值 ApplicationVersion ，即可更新應用程式的版本號碼。

首先，將應用程式從 Visual Studio 上傳至 Google Play 時，必須先在 Google Play 控制台中設定 API 存取權。

啟用Google API存取

Google Play 開發人員發佈 API 可讓 Visual Studio 將新版本的應用程式上傳至 Google Play。在 Visual Studio 開始進行 API 呼叫之前，您必須在 Google Play 開發人員帳戶中設定 API 存取權。這牽涉到將Google Play開發人員帳戶連結至Google Cloud專案，以及使用OAuth用戶端設定Google Play開發人員發佈API的存取權。

若要開啟 Google API 存取：

登入您的 Google Play開發人員帳戶。
在 Google Play 控制台中，展開 [ 設定 ] 項目，然後選取 [ API 存取]。 然後在 [API 存取] 頁面中，選取 [選擇要連結的專案] 按鈕：

若要使用Google Play開發人員 API，您需要必須連結至Google Play 開發人員帳戶的 Google Cloud 專案。

注意

Google Play 開發人員帳戶只能連結到單一 Google Cloud 專案。因此，如果您從一個 Google Play 開發人員帳戶發佈多個應用程式，他們都必須共用相同的 Google Cloud 專案。
在 [ API 存取 ] 頁面中，選取 [ 建立新的 Google Cloud 專案] 單選按鈕，後面接著 [ 儲存 ] 按鈕：

將會建立新的 Google Cloud 專案，並連結到您的 Google Play 開發人員帳戶。
在 [ API 存取 ] 頁面的 [OAuth 用戶端 ] 區段中，選取 [ 設定 OAuth 同意] 畫面：
在 [ OAuth 同意] 畫面 頁面中，選取必要的使用者輸入單選按鈕，然後選取 [建立] 按鈕：

如需使用者類型的詳細資訊，請參閱 support.google.com 上的用戶類型。
在 [ 編輯應用程式註冊 ] 頁面中，完成標示為必要字段，然後選取 [ 儲存後繼續] 按鈕：
在 [ 編輯應用程式註冊 ] 頁面中，選取 [ 新增或移除範圍 ] 按鈕：
在 [ 更新選取的範圍 ] 飛出視窗中，選取 ./auth/androidpublisher 數據表中的範圍，然後選取 [更新] 按鈕：

注意

您可以選擇性地選取數據表中的其他範圍，因為它們是標準範圍。
在 [ 編輯應用程式註冊 ] 頁面中，選取 [ 認證] 索引標籤：
在 [ 認證] 頁面中，選取 [ + CREATE 認證 ] 按鈕，然後 選取 [OAuth 用戶端標識符 ] 專案：
在 [建立 OAuth 用戶端標識符] 頁面中，選擇 [應用程式類型] 下拉式清單中的 [傳統型應用程式]，在 [名稱] 字段中輸入 Visual Studio，然後選取 [建立] 按鈕：
在 [ OAuth 用戶端建立] 對話框中，選取 [下載 JSON 數據] 按鈕以下載用戶端識別碼和客戶端密碼。稍後將需要此專案。然後按下 [ 確定] 按鈕以關閉對話框。

如需啟用Google API存取Google Play開發人員帳戶的詳細資訊，請參閱開始使用 developers.google.com。如需設定 OAuth 同意畫面的詳細資訊，請參閱在 support.google.com 上設定您的 OAuth 同意畫面。

透過 Visual Studio 上傳您的應用程式

若要在 Visual Studio 中建置並簽署您的應用程式：

在 Visual Studio 工具列中，使用 [ 偵錯目標 ] 下拉式清單選取 [Android 模擬器]，然後選取 您選擇的模擬器 ：
在 Visual Studio 工具列中，使用 [ 解決方案組態 ] 下拉式清單，從偵錯組態變更為發行組態：
在 方案總管 中，以滑鼠右鍵按兩下 .NET MAUI 應用程式項目，然後選取[發佈...] ：

封 存管理員 隨即開啟，Visual Studio 會開始封存您的應用程式套件組合：
在封存管理員中，一旦封存順利完成，請確定已選取您的封存，然後選取 [散發 ...] 按鈕，開始散發應用程式的程式：

[ 散發 - 選取通道 ] 對話框隨即出現。

在 [ 散發 - 選取頻道 ] 對話框中，選取 [ Google Play] 按鈕：
在 [ 散發 - 簽署身 分識別] 對話框中，選取您在建置應用程式以透過Google Play 控制台散發時建立的簽署身分識別，然後選取 [ 繼續] 按鈕：
在 [ 散發 - Google Play 帳戶 ] 對話框中，選取 + 按鈕以新增Google Play 開發人員帳戶詳細數據：
在 [ 註冊 Google API 存取 ] 對話方塊中，輸入描述和您的 OAuth 用戶端識別碼和客戶端密碼，然後按兩下 [ 註冊 ] 按鈕：

注意

帳戶描述可讓您註冊多個 Google Play 開發人員帳戶，並將應用程式上傳至不同的 Google Play 開發人員帳戶。

網頁瀏覽器將會開啟。
在網頁瀏覽器中，登入您的 Google Play 開發人員帳戶。登入之後，可能會顯示一則訊息，告知您 Google 尚未驗證應用程式。如果發生這種情況，請選取 [ 繼續] 按鈕：
在網頁瀏覽器中，選取 [ 繼續 ] 按鈕以授權應用程式：

網頁瀏覽器將會收到驗證碼。

重要

請勿關閉網頁瀏覽器。
在 Visual Studio 的 [ 散發 - Google Play 帳戶 ] 對話框中，選取 [ 繼續]：
在 [ 散發 - Google Play 追蹤] 對話框中，選取要上傳應用程式的追蹤。 Google Play 提供五個曲目來上傳您的應用程式：
- 內部應該用來快速散發您的應用程式，以進行內部測試和品質保證檢查。
- Alpha 應該用來將舊版應用程式上傳至一小群測試人員。
- Beta 應該用於將舊版應用程式上傳至較大的測試人員群組。
- 生產環境應該用於完整散發到Google Play商店。
- 自定義應該用來透過電子郵件位址建立測試人員清單，以測試應用程式發行前版本。
重要

如果您沒有看到自定義曲目，請確定您已在Google Play控制台中建立該曲目的版本。如需詳細資訊，請參閱準備和推出 support.google.com 版本。

選取要上傳應用程式的追蹤，然後選取 [ 上傳] 按鈕：

如需 Google Play 測試的詳細資訊，請參閱在 support.google.com 上設定開啟、關閉或內部測試。
Visual Studio 將會開始將您的應用程式發佈至 Google Play。在 [ 簽署密碼 ] 對話框中，輸入您為簽署身分識別建立的密碼，然後選取 [ 確定 ] 按鈕：

Visual Studio 會簽署您的應用程式套件組合，並將它上傳至 Google Play。

重要

提交至Google Play的應用程式通常會經歷檢閱程式。如需詳細資訊，請參閱準備您的應用程式以檢閱和在 support.google.com 上發佈您的應用程式。