OS 업데이트용 Android 업그레이드 파티

업그레이드 파티는 Android 사용자에게 주요 OS 업그레이드가 제공될 때마다 새로운 기능을 강조 표시하는 검색 흐름입니다.

사용자는 Android 운영체제의 주요 업그레이드에 큰 관심이 없을 수 있습니다. 업그레이드 파티 흐름은 사용자 참여도를 높이고 사용자가 새롭게 단장된 OS를 어떻게 탐색해야 하는지 파악하는 데 도움을 줍니다.

최신 OS 버전으로 업그레이드하면 새로운 OS의 환영 메시지 및 새로운 기능이 포함된 카드 흐름을 보여주는 푸시 알림이 전송됩니다.

Android OS에서 업그레이드 파티를 사용 설정하려면 Android 업그레이드 파티 활성화 요청 양식을 사용하여 등록하세요.

업그레이드 파티 환경 맞춤설정

다음과 같은 방법으로 업그레이드 파티 환경을 맞춤설정할 수 있습니다.

• 관련 없는 기능을 삭제합니다.
• 텍스트 블록의 표현을 업데이트합니다.
• 브랜드에 맞게 애니메이션, 색상, 글꼴을 수정합니다.

흐름을 맞춤설정하려면 업그레이드 파티 스타일 가이드의 가이드라인을 검토하고 Android 업그레이드 파티 활성화 요청 양식에 맞춤설정 정보를 제공하세요.

SDK를 사용해 업그레이드 파티 트리거

기본적으로 Android OS는 업그레이드되는 즉시 사용자에게 최신 기능이 포함된 카드 흐름이 있는 푸시 알림을 전송합니다. 자체 푸시 알림 또는 앱에서 흐름을 트리거하려면 Android SDK를 사용하세요.

기본 요건

앱의 빌드 파일이 다음 값을 사용하는지 확인합니다.

• minSdkVersion 14 이상
• compileSdkVersion 28 이상

앱 구성

1. 제공된 Zip 파일에서 라이브러리를 추출하고 저장소에 저장합니다.

2. 모듈의 앱 수준 Gradle 파일(일반적으로 app/build.gradle)에 Google Growth SDK의 종속 항목을 추가합니다.

    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 기능을 노출합니다.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

사용자가 업그레이드 파티 대상인지 비동기적으로 확인하는 Task 객체를 반환합니다. 결과로 도출되는 불리언 값은 사용자가 자격요건을 충족하는지 나타냅니다.

InvokeUpgradeParty

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 OS를 업그레이드할 때 표시되는 업그레이드 파티 흐름을 테스트합니다.

1. 테스트용 Android 기기에서 설정 > Google > 업그레이드 파티 디버그로 이동합니다.
2. 업그레이드 보고를 선택한 후 업그레이드 파티 열기를 선택합니다. 그러면 기기 OS 버전에 따라 관련 흐름이 시작됩니다. 예를 들어 Android 12 업그레이드 파티는 Android 12 OS를 실행하는 기기에서 재생됩니다.