本頁面由 Cloud Translation API 翻譯而成。

Android 作業系統更新升級派對

升級派對是一個發現流程，每當 Android 用戶收到主要作業系統升級時，都會向他們強調新功能。

Android 作業系統的重大升級可能會為用戶帶來平淡無奇的體驗。升級方流程提高了使用者參與度，並幫助使用者了解如何導航新更新的作業系統。

升級到最新作業系統版本後，用戶會收到推播通知，歡迎他們使用新作業系統，並展示具有新功能的卡片流程。

若要為您的 Android 作業系統啟用升級方，請使用請求啟動 Android 升級方表格進行註冊。

客製化升級派對體驗

您可以透過以下方式自訂升級派對體驗：

刪除不相關的功能。
更新文字區塊中的語言。
修改動畫、顏色和字體以配合您的品牌。

若要自訂流程，請查看升級方風格指南中的指南，並在要求啟動 Android 升級方表單中包含您的自訂資訊。

升級邀請風格指南

使用此風格指南修改升級邀請外觀以適合您自己的品牌（螢幕、顏色、字體）。我們強烈建議保持尺寸和結構接近原始設計。

升級邀請流程包含以下三個組成部分：

介紹畫面
特色畫面
片尾畫面

每個螢幕上的動畫有助於解釋每個功能。

介紹畫面

介紹畫麵包含一個簡短的動畫，歡迎使用者並鼓勵他們開始介紹螢幕上顯示的流程。

佈局

設備動畫始終包含：

白色背景和彩色形狀
設備框架
為了保持一致性，請在動畫中使用通用裝置框架。
使用者介面內容

造型

如果您選擇調整Material You樣式，則可以使用範例中顯示的預設顏色和形狀。

如果您使用自己的品牌顏色，請確保它與 UI 背景配合良好。

運動

選項 1：在主畫面上顯示時鐘

數字進入螢幕。
數字向中心移動，同時尺寸縮小。出現手機邊框。
手機尺寸變小。形狀開始進入螢幕。
動畫完成。形狀不斷輕輕移動。

選項 2：主螢幕上沒有時鐘

手機進入畫面。
手機向中心移動，同時尺寸增大。形狀開始進入螢幕。
手機達到最大尺寸，形狀不斷移動。

特色畫面

每個功能畫面都會突出顯示新作業系統中的一個功能。

佈局

設備動畫始終包含：

多彩背景
設備框架
使用者介面內容

造型

選擇與 UI 內容和整體外觀相符的背景顏色。
在螢幕內，設定易於辨認的字體大小。如果需要，請設定更大的字體大小。

運動

記錄每個功能流程的動畫，包括觸控互動。將錄音匯出為Lottie 檔。

片尾畫面

結尾畫面完成了流程。它向用戶表明他們已經瀏覽了所有螢幕。

佈局

設備動畫始終包含：

背景上的半圓（加上動畫形狀）
設備框架
使用者介面內容

造型

選擇與 UI 內容和整體外觀相符的背景顏色。
使用半圓形。

運動

遵循標準的片尾螢幕動畫流程：

手機向上移動了一點。
背景出現一個圓圈。
形狀從手機後面出現。
這些形狀像五彩紙屑一樣從背景中飛出。

使用SDK觸發升級方

預設情況下，Android 作業系統會在用戶升級後立即向用戶發送推播通知，展示具有最新功能的卡片流程。如果您希望從自己的推播通知或應用程式觸發流程，請使用 Android SDK。

先決條件

確保您的應用程式的建置檔案使用以下值：

minSdkVersion為 14 或更高
compileSdkVersion為28或更高

配置您的應用程式

從提供的 Zip 檔案中提取庫，並將其放入您的儲存庫中。
將 Google Growth SDK 的依賴項新增至模組的應用程式層級Gradle檔案中，通常為app/build.gradle ：
```
 dependencies {
     implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
 }
```

包含以下程式庫作為依賴項：

com.google.android.gms:play-services-base:18.0.1
com.google.android.gms:play-services-basement:18.0.0
com.google.android.gms:play-services-tasks:18.0.1

使用API

若要初始化客戶端，請使用UpgradeParty類別並設定activity參數。

 import com.google.android.gms.growth.UpgradeParty;
 UpgradeParty.getClient(activity);

產生的UpgradePartyClient公開了 API 功能。

是有資格升級的一方

Task<Boolean> isEligibleForUpgradeParty();

傳回一個Task對象，該對象非同步驗證使用者是否有資格參加升級方。產生的布林值指示使用者是否符合資格。

呼叫UpgradeParty

Task<Void> invokeUpgradeParty();

調用升級方Activity 。產生的Task物件指示啟動活動時是否發生錯誤。

錯誤

這兩種 API 方法都可能會失敗，並出現com.google.android.gms.common.api.ApiException類型的例外。在這種情況下，呼叫者應該稍後重試。

預期的常見狀態代碼包括：

INTERNAL_ERROR ：表示底層邏輯流程中的任何錯誤。
TIMEOUT ：當請求無法及時處理時顯示。
API_NOT_CONNECTED ：表示 API 不可用（例如， UpgradeParty模組尚未準備好）。
DEVELOPER_ERROR ：當不允許呼叫包存取UpgradeParty類別時顯示。

SDK範例

請參閱以下調用 SDK 的應用程式範例：

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;

public class SampleActivity extends Activity {

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   final UpgradePartyClient client = UpgradeParty.getClient(this);

   // Hide the invocation button initially
   View startUpgradePartyButton = findViewById(R.id.__some_button__);
   startUpgradePartyButton.setVisibility(View.GONE);

   // Register an onClick handler to invoke the Upgrade Party Activity
   startUpgradePartyButton
       .setOnClickListener(
           view -> {
             client
                 .invokeUpgradeParty()
                 .addOnCompleteListener(
                     task -> {
                       if (!task.isSuccessful()) {
                         // Do something with error, see task.getException()
                       }
                     });
           });
   }

   // Check if eligible for an Upgrade Party
   client
       .isEligibleForUpgradeParty()
       .addOnCompleteListener(
           task -> {
             if (!task.isSuccessful()) {
               // Do something with error, see task.getException()
             } else {
                  // Show/Hide invocation button, based on the result
                  int visibility =
                        task.getResult() ? View.VISIBLE : View.GONE;
                  startUpgradePartyButton..setVisibility(visibility);
             }
           });
   }

測試升級方流程

請依照以下步驟測試使用者在升級 Android 作業系統時看到的升級方流程：

在測試 Android 裝置上，前往設定 > Google > Upgrade Party debug 。
選擇“報告升級” ，然後選擇“開啟升級方” 。這將根據設備作業系統版本啟動相關流程。例如，Android 12 Upgrade Party 在運行 Android 12 作業系統的裝置上運行。