APK 和測試群組

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Google Play Developer API 可讓您為應用程式上傳新的 APK 並發布至不同的測試群組。您可以藉此部署 Alpha 版和 Beta 版的應用程式，以供核准的使用者使用。這也可讓您部署階段推出版本，這個版本會自動提供給少數應用程式的使用者。推出階段推出版本後，您可以逐步延長擁有該應用程式版本的使用者人數，直到最終將該版本部署為「實際工作環境」版本為止。

新增及修改 APK

  1. 呼叫 Edits.apks: upload 方法上傳一或多個 APK。

    這個方法會將 APK 上傳至儲存空間的「值區」，以便將 APK 指派給「測試群組」並部署給使用者。(如果修改或捨棄編輯內容，所有上傳到該 APK 的 APK 也會一併遺失)。

  2. 呼叫 Edits.tracks: update，在 &trackt&tracks 上發布 APK。您可以在下列測試群組中發布 APK：

    • 測試測試群組，例如 "alpha" 和 "beta"

      Alpha 和 Beta 版應用程式會指派給您指派給 Alpha 和 Beta 測試的使用者。您可以使用 Google Play 管理中心將使用者指派給這些群組。

    • 內部測試群組："internal"

      應用程式的內部版本會部署至 Google Play 管理中心中設定的內部測試群組。

    • 正式版群組："production"

      「正式版」測試群組中的版本會部署給所有使用者。您可以善用「實際工作環境」測試群組的階段發布功能，先安全地將版本發布給少數的實際工作環境使用者，再隨著信心提升，進而逐漸擴大發布比例。

    簡易模式使用者不應將一個 APK 新增至任一測試群組。使用多個 APK 支援的進階模式使用者，每個測試群組可上傳零、一或多個 APK。

APK 工作流程範例

本節將說明 Traces API 的使用方式。在本範例中，我們假設您想為每個測試群組上傳新版 APK，並指派一些使用者來接收階段推出版本。(實際上，開發人員不可能在同一個作業中執行所有動作；您可改為更新一天的 Beta 版，然後在「正式版」建立分階段版本，依此類推)。

  1. 按照編輯工作流程所述，開啟新的編輯內容
  2. 針對要上傳的每個 APK 呼叫 Edits.apks: upload 方法。在方法的要求主體中傳遞 APK。(這樣會將 APK 放在儲存空間區域中，但不會在測試群組上發布或部署)。這個方法會傳回您上傳的每個 APK 版本代碼；使用此測試群組發布版本時，系統會使用此版本代碼。

  3. 針對要發布 APK 的每個測試群組呼叫 Edits.tracks: update 方法。在要求主體中，傳遞包含要發布的版本的 Edits.tracks 資源。舉例來說，如要發布版本代碼為 88 的 APK，請按照下列步驟操作：

    {
"releases": [{
  "versionCodes": ["88"],
  "status": "completed"
}]
}

    目前使用者仍無法存取 APK。與其他編輯一樣，變更不會立即發布。

  4. 呼叫 Edits: Commit 方法來提交變更。完成上述步驟後，每個測試群組的使用者都會獲得新版 APK 版本。(就像所有編輯內容一樣，變更可能需要幾個小時才會生效)。

階段推出

當您有想要逐步部署的新版 APK 時，可以選擇將其發行為「階段推出」版本。如果您這麼做，Google Play 會自動部署至您指定的應用程式使用者比例。如果「推出」APK 沒有任何問題 (例如當機等)，您可以增加接收該版本的使用者百分比；當您準備就緒時，可以將該 APK 部署為新的正式版。

本節說明您在執行 APK 階段推出作業後，可將 APK 推送至正式版步驟：

  1. 按照編輯工作流程所述來建立編輯內容。

  2. 使用 Edits.apks: upload 方法將新的 APK 上傳至編輯內容。

  3. 使用 Edits.tracks: update 方法在正式版測試群組中，啟動 "inProgress" 階段發布作業。選擇應接收新 APK 的使用者比例。此時，APK 仍可提供給任何使用者使用。 

    {
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.05,
  "status": "inProgress"
}]
}

  4. 呼叫 Edits: 修訂版本來修訂有效編輯內容中的變更內容。在接下來的幾小時內，系統會對使用者推出新的 APK。您選取的使用者百分比會接收新的 APK。

根據階段推出的成效，您可以增加符合推出該應用程式的使用者比例或停止發布版本。

分階段推出使用者增幅

假設您有 5% 的階段推出作業，如上一節所述，本節說明如何在發布當天的案例中增加百分比：

  1. 按照編輯工作流程所述來建立編輯內容。

  2. 使用 Edits.tracks: update 方法，變更正式版測試群組的 "inProgress" 階段版本。增加接收新 APK 的使用者比例： 

    {
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.1,
  "status": "inProgress"
}]
}

  3. 呼叫 Edits: 修訂版本來修訂有效編輯內容中的變更內容。在接下來的幾小時內，系統會對使用者推出新的 APK。您選取的使用者百分比會接收新的 APK。

暫停階段推出作業

假設您有 5% 的進行階段推出作業 (如上一節所述)，本節說明如何在發現問題時暫停階段推出作業：

  1. 按照編輯工作流程所述來建立編輯內容。

  2. 使用 Edits.tracks: update 方法，變更正式版測試群組的 "inProgress" 階段版本。將狀態設為 "halted"。

    {
"releases": [{
  "versionCodes": ["99"],
  "status": "halted"
}]
}

  3. 呼叫 Edits: 修訂版本來修訂有效編輯內容中的變更內容。此版本將不再提供給新使用者。

如果您之後決定恢復暫停的版本，可以將其狀態改回 "inProgress"。

完成階段推出作業

對階段推出作業感到滿意後，如要將版本推出給 100% 的使用者，您可以將發布狀態設為 "completed"：

  1. 按照編輯工作流程所述來建立編輯內容。

  2. 使用 Edits.tracks: update 方法，變更正式版測試群組的 "inProgress" 階段版本。將狀態設為 "halted"。

    {
"releases": [{
  "versionCodes": ["99"],
  "status": "completed"
}]
}

  3. 呼叫 Edits: 修訂版本來修訂有效編輯內容中的變更內容。在接下來的幾小時內，系統會對使用者推出新的 APK。您選取的使用者百分比會接收新的 APK。

草稿版本

草稿版本可讓您自動上傳 APK，並透過 API 建立版本，日後可以透過 Google Play 管理中心部署。如何在測試群組中建立草稿版本：

  1. 按照編輯工作流程所述，開啟新的編輯內容
  2. 針對要上傳的每個 APK 呼叫 Edits.apks: upload 方法。在方法的要求主體中傳遞 APK。這個方法會傳回您上傳的每個 APK 版本代碼；您將版本指派給版本時，將使用這個版本代碼參照該 APK。

  3. 針對要發布的每個測試群組呼叫 Edits.tracks: update 方法。在要求主體中，傳遞包含您要建立的草稿版本的 Edits.tracks 資源。例如：

    {
"releases": [{
  "name": "My draft release",
  "versionCodes": ["88"],
  "status": "draft"
}]
}

  4. 呼叫 Edits: Commit 方法來提交變更。您現在可以透過 Google Play 管理中心或 API 檢查及推出草稿版本。

指定版本資訊

發布新版本的應用程式時，您可以指定版本中的版本資訊，藉此強調使用者的新功能。

方法是在向 Edits.tracks: update 方法提供 Edits.tracks 資源時使用 "releaseNotes" 欄位。 

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}