Upgrade Party — это процесс обнаружения новых функций для пользователей Android всякий раз, когда они получают серьезное обновление ОС.
Крупное обновление операционной системы Android может разочаровать ваших пользователей. Процедура Upgrade Party повышает вовлеченность пользователей и помогает им понять, как работать с недавно обновленной ОС.
После обновления до последней версии ОС пользователи получают push-уведомление, приветствующее их переход на новую ОС и демонстрирующее поток карточек с новыми функциями.
Чтобы включить Upgrade Party для вашей ОС Android, зарегистрируйтесь, используя форму «Запрос на активацию Android Upgrade Party» .
Настройте игру Upgrade Party
Вы можете настроить Upgrade Party следующими способами:
- Удалите ненужные функции.
- Обновите язык в текстовых блоках.
- Измените анимацию, цвета и шрифты в соответствии с вашим брендом.
Чтобы настроить процесс, ознакомьтесь с рекомендациями в Руководстве по стилю Upgrade Party и укажите информацию о настройке в форме запроса на активацию Android Upgrade Party .
Руководство по стилю приглашения на обновление
Используйте это руководство по стилю, чтобы изменить внешний вид приглашения на обновление в соответствии с вашим брендом (экраны, цвета, шрифты). Мы настоятельно рекомендуем сохранять размеры и структуру близкими к оригинальному дизайну.
Процесс приглашения на обновление состоит из следующих трех компонентов:
- Вступительный экран
- Экран функций
- Заключительный экран
Анимация на каждом экране помогает объяснить каждую функцию.
Вступительный экран
Вступительный экран содержит короткую анимацию, которая приветствует пользователя и побуждает его начать процесс, показанный на вступительном экране.
Макет
Анимация устройства всегда состоит из:
- Белый фон и красочные формы
- Рамка устройства
- контент пользовательского интерфейса
Стиль
Если вы решите адаптировать стиль Material You , вы можете использовать цвета и формы по умолчанию, показанные в примере.
Если вы используете собственный фирменный цвет, убедитесь, что он хорошо сочетается с фоном пользовательского интерфейса.
Движение
Вариант 1. С часами на главном экране.
- Числа выходят на экран.
- Числа перемещаются к центру, уменьшаясь в размере. Появится рамка мобильного телефона.
- Телефон уменьшается в размерах. Фигуры начинают появляться на экране.
- Анимация завершена. Фигуры продолжают плавно двигаться.
 |  |
Вариант 2. На главном экране нет часов.
- На экране появляется мобильный телефон.
- Телефон перемещается в центр, увеличиваясь в размерах. Фигуры начинают появляться на экране.
- Телефон достигает максимального размера, а фигуры продолжают двигаться.
 |  |
Экран функций
На каждом экране функций выделена функция новой ОС.
Макет
Анимация устройства всегда состоит из:
- Красочный фон
- Рамка устройства
- контент пользовательского интерфейса
Стиль
- Выберите цвет фона, который хорошо сочетается с содержимым пользовательского интерфейса и с общим внешним видом.
- Внутри экранов установите размеры шрифтов, которые легко читаются. При необходимости установите больший размер шрифта.
Движение
Запишите анимацию работы каждой функции, включая сенсорное взаимодействие. Экспортируйте записи как файлы Lottie .
Заключительный экран
Заключительный экран завершает поток. Это указывает пользователям, что они прошли все экраны.
Макет
Анимация устройства всегда состоит из:
- Полукруг на заднем плане (плюс анимированные фигуры)
- Рамка устройства
- контент пользовательского интерфейса
Стиль
- Выберите цвет фона, который хорошо сочетается с содержимым пользовательского интерфейса и с общим внешним видом.
- Используйте форму полукруга.
Движение
Следуйте стандартной последовательности анимации заставки:
- Мобильный телефон немного приподнимается.
- На заднем плане появится круг.
- Фигуры появляются из-за мобильного телефона.
- Фигуры вылетают из фона, как конфетти.
 |  |
Запустите вечеринку по обновлению с помощью SDK
По умолчанию ОС Android отправляет пользователям push-уведомление, демонстрирующее поток карточек с новейшими функциями, как только они обновятся. Если вы предпочитаете запускать поток из собственного push-уведомления или приложения, используйте Android SDK.
Предварительные условия
Убедитесь, что в файле сборки вашего приложения используются следующие значения:
-
minSdkVersion14 или выше -
compileSdkVersion28 или выше
Настройте свое приложение
- Извлеките библиотеку из предоставленного 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.
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:
- На тестовом устройстве Android выберите «Настройки» > «Google» > «Отладка Upgrade Party» .
- Выберите «Отчет об обновлении» , а затем «Открыть обновление» . При этом запускается соответствующий поток в зависимости от версии ОС устройства. Например, Android 12 Upgrade Party воспроизводится на устройстве под управлением ОС Android 12.