Android Upgrade Party для обновлений ОС

Upgrade Party — это процесс обнаружения новых функций для пользователей Android всякий раз, когда они получают серьезное обновление ОС.

Крупное обновление операционной системы Android может разочаровать ваших пользователей. Процесс Upgrade Party повышает вовлеченность пользователей и помогает им понять, как работать с недавно обновленной ОС.

После обновления до последней версии ОС пользователи получают push-уведомление, приветствующее их переход на новую ОС и демонстрирующее поток карточек с новыми функциями.

Чтобы включить Upgrade Party для вашей ОС Android, зарегистрируйтесь, используя форму «Запрос на активацию Android Upgrade Party» .

Настройте игру Upgrade Party

Вы можете настроить Upgrade Party следующими способами:

• Удалите ненужные функции.
• Обновите язык в текстовых блоках.
• Измените анимацию, цвета и шрифты в соответствии с вашим брендом.

Чтобы настроить процесс, ознакомьтесь с рекомендациями в Руководстве по стилю Upgrade Party и укажите информацию о настройке в форме запроса на активацию Android Upgrade Party .

Запустите вечеринку по обновлению с помощью SDK

По умолчанию ОС Android отправляет пользователям push-уведомление, демонстрирующее поток карточек с новейшими функциями, как только они обновятся. Если вы предпочитаете запускать поток из собственного push-уведомления или приложения, используйте 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.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Возвращает объект Task , который асинхронно проверяет, имеет ли пользователь право на участие в программе Upgrade Party. Полученное логическое значение указывает, имеет ли пользователь право на участие или нет.

вызвать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);
             }
           });
   }

Протестируйте процесс Upgrade Party

Выполните следующие действия, чтобы протестировать процесс обновления, который видят ваши пользователи при обновлении ОС Android:

1. На тестовом устройстве Android выберите «Настройки» > «Google» > «Отладка Upgrade Party» .
2. Выберите «Отчет об обновлении» , а затем «Открыть обновление» . При этом запускается соответствующий поток в зависимости от версии ОС устройства. Например, Android 12 Upgrade Party воспроизводится на устройстве под управлением ОС Android 12.