更新作業系統的 Android 升級版方

「升級派對」是為 Android 使用者介紹新功能的探索流程 執行重大的 OS 升級作業

Android 作業系統的重大升級可能會對使用者造成困擾 對使用者的影響。升級方流程可提升使用者參與度，並協助使用者 並學習如何操作新改版的 OS。

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

如要啟用 Android 作業系統的升級方，請使用 要求啟用 Android 升級版方表單。

自訂升級方體驗

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

• 請移除不相關的功能。
• 更新文字區塊的語言。
• 根據品牌風格修改動畫、顏色和字型。

如要自訂流程，請參閱升級���對樣式指南中的指南 並將您的自訂資訊 要求啟用 Android 升級版方表單。

使用 SDK 觸發升級方

根據預設，Android 作業系統會傳送推播通知給使用者 使用者升級後就會立即體驗最新功能如果希望觸發 來自您自己的推播通知或應用程式流程，請使用 Android SDK。

必要條件

請確認應用程式的版本檔案使用下列的值：

• minSdkVersion/14 以上
• compileSdkVersion/28 以上

設定應用程式

1. 從提供的 ZIP 檔案中擷取程式庫，然後放在存放區中。

2. 將 Google Growth SDK 的依附元件新增至模組的應用程式層級 Gradle 檔案，通常為 app/build.gradle：

    dependencies {
        implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
    }
   

3. 納入下列程式庫做為依附元件：

   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

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

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

產生的 UpgradePartyClient 會公開 API 功能。

���合資格升級方

Task<Boolean> isEligibleForUpgradeParty();

傳回以非同步方式驗證使用者是否符合申請資格的 Task 物件 升級方。產生的布林值會指出使用者 是否符合資格

叫用升級派對

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 作業系統：

1. 在測試的 Android 裝置上前往「設定」>「設定」Google >升級方偵錯。
2. 依序選取「報告升級」和「開啟升級方」。這會啟動 相關流程。例如 Android 12 升級派對會在搭載 Android 12 作業系統的裝置上播放。