Android App Publishing Guide for Flutter (2026年版)

本指南提供了一個全面、逐步的流程，協助開發者準備並將 Flutter 應用程式發佈到 Google Play Store。內容涵蓋產生簽名的發佈版本、在 Google Play Console 中建立和設定應用程式，以及管理發佈流程。

1. 發佈前檢查清單

在開始技術步驟之前，請收集所有必要的資產和資訊。

必要項目

Google Play 開發者帳戶：你需要一個有效的帳戶。註冊費用為一次性 25 美元。
已完成的 Flutter App：你的 App 應該已經測試完畢並準備好發佈。
高解析度 App Icon：
- 格式：512x512 像素，32-bit PNG (含 alpha 通道)。
主圖 (Feature Graphic)：
- 格式：1024x500 像素，JPG 或 24-bit PNG (無 alpha)。這會顯示在您的商店列表頂部。
螢幕截圖：
- 格式：JPG 或 24-bit PNG (無 alpha)。
- 您必須提供至少 2 張手機截圖。如果您的 App 支援平板電腦 (7 吋和 10 吋) 和 Wear OS，也可以新增相關截圖。
App 名稱：最多 30 個字元。
簡短說明：最多 80 個字元。快速、吸引人的摘要。
完整說明：最多 4000 個字元。詳細說明您的 App 功能和優點。
隱私權政策網址：您的 App 隱私權政策的公開網址。這是必填項目。
測試帳戶 (如適用)：如果您的 App 需要登入，您必須提供一組測試用的帳號密碼供審核團隊使用。

2. 為 Flutter 產生簽名的發佈版本

Google Play 要求所有應用程式都必須經過數位簽名。您將產生一個「上傳金鑰 (upload key)」，用來簽署您的 App Bundle。Google 隨後會使用此金鑰驗證您的身分，並使用最佳化的部署金鑰重新簽署您的 App。

步驟 1：建立上傳 Keystore

您只需要為您的 App 做這件事一次。

開啟終端機 (Terminal)。
執行以下指令。請將 <keystore-name> 和 <alias-name> 替換為與您自己的名稱 (例如 my-release-key 和 my_app_alias)。
Terminal window
```
keytool -genkey -v -keystore <keystore-name>.jks -keyalg RSA -keysize 2048 -validity 10000 -alias <alias-name>
```
工具會提示您建立 keystore 的密碼以及金鑰的密碼。它也會詢問您的組織詳細資料。

⚠️ 重要警告

備份您的 keystore 檔案 (.jks) 並安全地儲存您的密碼！ 如果您遺失上傳金鑰，您將永遠無法再更新您的 App。請將其儲存在安全的地方，例如密碼管理器和安全的雲端硬碟。

步驟 2：在 Flutter 專案中設定簽名

將您剛剛建立的 .jks 檔案移至 Flutter 專案的 android/app 目錄中。
建立一個名為 android/key.properties 的新檔案。切勿將此檔案提交到公開的版本控制系統。 請立即將其加入您的 .gitignore 檔案。
將以下內容新增至 android/key.properties，並將佔位符替換為上一步驟中的密碼、別名和檔案名稱。
```
storePassword=你的keystore密碼
keyPassword=你的金鑰密碼
keyAlias=你的別名
storeFile=../app/<keystore-name>.jks
```

步驟 3：在 Gradle 中引用 Keystore

開啟 android/app/build.gradle。

在檔案頂部，android { ... } 區塊之前，新增以下程式碼片段。這會載入 key.properties 檔案。

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

在 android { ... } 區塊內，找到 buildTypes 區段，並在它上方新增一個 signingConfigs 區塊。這會告訴 Gradle 如何簽署您的發佈版本。

...
signingConfigs {
    release {
        keyAlias keystoreProperties['keyAlias']
        keyPassword keystoreProperties['keyPassword']
        storeFile file(keystoreProperties['storeFile'])
        storePassword keystoreProperties['storePassword']
    }
}

buildTypes {
    release {
        // 您需要加入以下這行
        signingConfig signingConfigs.release
        ...
    }
}
...

步驟 4：建置 Android App Bundle (.aab)

現在您已準備好建置發佈檔案。Google Play 強烈建議使用 Android App Bundle (.aab) 格式，因為它能讓使用者下載體積更小與最佳化的檔案。

在終端機中，於 Flutter 專案的根目錄執行：
Terminal window
```
flutter build appbundle
```
建置完成後，您會在以下路徑找到已簽名的 App Bundle： build/app/outputs/bundle/release/app-release.aab

3. 在 Google Play Console 建立應用程式

登入 Google Play Console。
點擊 建立應用程式 (Create app) 按鈕。
填寫初始詳細資料：
- 應用程式名稱：您的 App 名稱。
- 預設語言：商店資訊的主要語言。
- 應用程式或遊戲：選擇「應用程式」。
- 免費或付費：選擇您的 App 是免費還是付費下載。
接受聲明並點擊 建立應用程式。

您將被帶到 App 的資訊主頁 (Dashboard)，這裡提供了剩餘步驟的檢查清單。

4. 填寫商店資訊與應用程式內容

從左側選單中，瀏覽「拓展 (Grow)」和「政策 (Policy)」區段以完成 App 的設定檔。

主要商店資訊

前往 拓展 > 商店發佈 > 主要商店資訊 (Main store listing)。

應用程式名稱、簡短說明、完整說明：填入您準備好的文字。
圖片：
- 上傳您的 App icon (512x512)。
- 上傳您的 主圖 (Feature graphic) (1024x500)。
- 上傳您的 手機螢幕截圖。
- (選用) 新增 YouTube 影片連結並上傳平板電腦截圖。

設定多語言商店資訊 (Localization)

如果您希望 App 在 Play Store 上能根據使用者的語言設定顯示對應的語言（例如：針對中文使用者顯示中文名稱與介紹，針對英語使用者顯示英文）：

在 主要商店資訊 頁面，點擊 管理翻譯 (Manage translations)。
點擊 新增翻譯 (Add translation) 並選擇您要支援的語言（例如：Chinese (Traditional) – zh-TW）。
針對新增的每一種語言，填寫該語言版本的：
- App 名稱
- 簡短說明
- 完整說明
(選用) 您也可以在該語言的分頁下，上傳含有該語言文字的 螢幕截圖 或主圖。
未提供翻譯的語言地區，將會顯示您設定的 預設語言 版本。

前往 拓展 > 商店發佈 > 商店設定 (Store settings)。

應用程式類別：選擇最合適的類別。
聯絡詳細資料：提供電子郵件地址，以及選填的電話號碼和網站。

應用程式內容

這是政策合規性的關鍵部分。在左側選單中前往 政策 > 應用程式內容 (App content)。您必須完成每個子區段。

隱私權政策：輸入您的隱私權政策網址。
廣告：聲明您的 App 是否包含廣告。
應用程式存取權：
- 如果您的 App 完全開放，請選擇「無需特殊存取權即可使用所有功能」。
- 如果您的 App 有登入功能，請選擇「部分或所有功能受到限制」，並提供您準備好的 測試帳戶憑證。
內容分級：點擊「開始填寫問卷」。這會帶您完成 IARC 分級精靈。請如實回答以獲得正確的年齡分級。
目標對象與內容：指定您的 App 的目標年齡層。請小心填寫，因為選擇較年輕的受眾可能會使您的 App 受到更嚴格的審查政策約束。
資料安全性：這是 Google 相當於 Apple 隱私權標籤的功能。
- 您必須聲明您的 App 收集和分享哪些類型的使用者資料 (例如：個人資訊、財務資訊、位置等)。
- 對於每種資料類型，您必須解釋收集的原因 (例如：App 功能、分析)。
- 這份表單非常詳細且為必填。請花時間準確填寫。

5. 上傳並推出版本

最佳做法是在全面發佈到正式版之前，先與一小群人測試您的 App。

從左側選單中，前往 測試 (Testing) > 內部測試 (Internal testing)。這是第一次上傳最安全的地方。
點擊 建立新版本 (Create new release)。
Google Play 應用程式簽署：主控台會顯示關於應用程式簽署的通知。點擊繼續。Google 將管理您的 App 部署金鑰，這更加安全。
App Bundle：點擊上傳並選擇您稍早產生的 app-release.aab 檔案。
版本詳細資料：
- 給版本一個名稱 (例如 1.0.0)。
- 撰寫 版本資訊 (Release notes) 給您的使用者，說明此版本的新功能。
點擊儲存，然後點擊 檢查版本 (Review release)。
如果沒有錯誤，點擊 開始發布至內部測試。

在確認內部測試版本運作正常後，您可以將版本推廣到 正式版 (Production)，或是建立一個新的正式版發佈並上傳相同的 .aab 檔案。流程是相同的：前往 正式版，建立發佈，上傳 bundle，然後推出。

6. 發佈後續

審核時間：App 審核時間從幾小時到幾天不等。
更新：一旦您的 App 上架，您可以遵循相同的流程提交更新：建置一個新的、已簽名且版本號增加 (在 pubspec.yaml 中) 的 .aab 檔案，並在 Play Console 中建立新的發佈。

恭喜！您的 Flutter App 即將在 Google Play Store 上架。