Upgrade Party to proces, w którym użytkownicy Androida mogą odkrywać nowe funkcje po każdej aktualizacji systemu.
Duża aktualizacja systemu operacyjnego Androida może nie przynieść oczekiwanych rezultatów. Proces Upgrade Party zwiększa zaangażowanie użytkowników i pomaga im zrozumieć, jak poruszać się po nowo odświeżonym systemie operacyjnym.
Po przejściu na najnowszą wersję systemu operacyjnego użytkownicy otrzymują powiadomienie push z powitaniem i prezentacją nowej wersji systemu operacyjnego z nowymi funkcjami.
Producenci urządzeń mogą włączyć Upgrade Party na urządzeniach z Androidem, przesyłając formularz prośby o włączenie Upgrade Party na Androidzie.
Dostosowywanie funkcji Upgrade Party
Możesz dostosować działanie funkcji Upgrade Party na te sposoby:
- Usuń nieistotne funkcje.
- Zaktualizuj język w blokach tekstowych.
- Zmień animacje, kolory i czcionki, aby pasowały do Twojej marki.
Aby dostosować proces, zapoznaj się z wytycznymi w przewodniku stylów Upgrade Party i podaj informacje o dostosowaniu w odpowiedzi na formularz.
Przewodnik dotyczący stylu zaproszenia do uaktualnienia
Za pomocą tego przewodnika możesz zmodyfikować wygląd zaproszenia do przejścia na wersję premium, aby pasował do Twojej marki (ekrany, kolory, czcionki). Zdecydowanie zalecamy, aby rozmiary i strukturę pozostawić zbliżone do pierwotnego projektu.
Proces zaproszenia do skorzystania z ulepszonej wersji zawiera 3 elementy:
- Ekran wprowadzający
- Ekran funkcji
- Ekran zakończenia
Animacja na każdym ekranie pomaga wyjaśnić działanie poszczególnych funkcji.
Ekran wprowadzający
Ekran powitalny zawiera krótką animację, która wita użytkownika i zachęca do rozpoczęcia procesu widocznego na tym ekranie.
Układ

Animacja urządzenia zawsze zawiera:
- Białe tło i kolorowe kształty
- Ramka urządzenia
- Treść interfejsu
Stylizacja
Jeśli zdecydujesz się na stylizację Material You, możesz użyć domyślnych kolorów i kształtów pokazanych w przykładzie.

Jeśli używasz własnego koloru marki, upewnij się, że pasuje on do tła interfejsu.
Ruch
Opcja 1. Z zegarem na ekranie głównym
- Na ekranie pojawiają się liczby.
- Liczby przesuwają się do środka, zmniejszając przy tym swoją wielkość. Pojawi się ramka telefonu komórkowego.
- Rozmiar telefonu się zmniejsza. Kształty zaczynają pojawiać się na ekranie.
- Animacja została zakończona. Kształty poruszają się delikatnie.
![]() |
![]() |
Opcja 2. Brak zegara na ekranie głównym
- Telefon komórkowy wchodzi w ramy ekranu.
- Telefon przesuwa się do środka, zwiększając przy tym swój rozmiar. Kształty zaczynają pojawiać się na ekranie.
- Telefon osiąga maksymalny rozmiar, a kształty nadal się poruszają.
![]() |
![]() |
Ekran funkcji
Każdy ekran funkcji prezentuje funkcję w nowym systemie operacyjnym.
Układ

Animacja urządzenia zawsze zawiera:
- Kolorowe tło
- Ramka urządzenia
- Treść interfejsu
Stylizacja
- Wybierz kolor tła, który dobrze pasuje do treści interfejsu i ogólnego wyglądu.
- W ekranach ustaw rozmiary czcionek, które są łatwe do odczytania. W razie potrzeby ustaw większe rozmiary czcionek.
Ruch
Nagraj animację przepływu w przypadku każdej funkcji, w tym interakcji dotykowych. Wyeksportuj nagrania jako pliki Lottie.
Ekran zakończenia
Ekran outro kończy proces. Wskazuje użytkownikom, że przeszli przez wszystkie ekrany.
Układ

Animacja urządzenia zawsze zawiera:
- Półkole na tle (oraz animowane kształty)
- Ramka urządzenia
- Treść interfejsu
Stylizacja
- Wybierz kolor tła, który dobrze pasuje do treści interfejsu i ogólnego wyglądu.
- Użyj kształtu półkola.
Ruch
Wykonaj standardową animację ekranu końcowego:
- Telefon komórkowy przesuwa się nieco w górę.
- Na tle pojawi się kółko.
- Kształty pojawiają się za telefonem komórkowym.
- Kształty wylatują z tła jak konfetti.
![]() |
![]() |
Uruchomienie funkcji Upgrade Party za pomocą pakietu SDK
Domyślnie system operacyjny Android wysyła użytkownikom powiadomienie push z kartą prezentującą najnowsze funkcje, gdy tylko zaktualizują oni system. Jeśli wolisz uruchamiać proces za pomocą własnego powiadomienia push lub aplikacji, użyj pakietu SDK na Androida.
Wymagania wstępne
Sprawdź, czy w pliku kompilacji Twojej aplikacji znajdują się te wartości:
minSdkVersion
14 lub nowszacompileSdkVersion
28 lub wyższa
Konfigurowanie aplikacji
- Wypakuj bibliotekę z dostarczonego pliku Zip i umieść ją w swoim repozytorium.
Dodaj zależności pakietu SDK Google Growth do pliku Gradle na poziomie aplikacji modułu (zwykle
app/build.gradle
):dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
Jako zależności dodaj te biblioteki:
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
Korzystanie z interfejsu API
Aby zainicjować klienta, użyj klasy
UpgradeParty
i ustaw parametractivity
.import com.google.android.gms.growth.UpgradeParty; UpgradeParty.getClient(activity);
Powstały interfejs UpgradePartyClient
udostępnia funkcje interfejsu API.
isEligibleForUpgradeParty
Task<Boolean> isEligibleForUpgradeParty();
Zwraca obiekt Task
, który asynchronicznie sprawdza, czy użytkownik kwalifikuje się do udziału w Upgrade Party. Wynikowa wartość logiczna wskazuje, czy użytkownik kwalifikuje się do udziału w programie.
invokeUpgradeParty
Task<Void> invokeUpgradeParty();
Wywołuje grupę przejścia na wyższy model Activity
. Wynikowy obiekt Task
wskazuje, czy podczas uruchamiania aktywności wystąpił błąd.
Błędy
Obie metody interfejsu API mogą się nie powieść, z wyjątkiem typu com.google.android.gms.common.api.ApiException
. W takich przypadkach dzwoniący powinien spróbować ponownie później.
Typowe kody stanu:
INTERNAL_ERROR
: oznacza dowolny błąd w przepływie logiki.TIMEOUT
: wyświetlane, gdy nie udało się rozpatrzyć prośby w sposób terminowy.API_NOT_CONNECTED
: oznacza, że interfejs API jest niedostępny (np. modułUpgradeParty
nie jest jeszcze gotowy).DEVELOPER_ERROR
: wyświetlany, gdy pakiet wywołania nie ma dostępu do klasyUpgradeParty
.
Przykład pakietu SDK
Poniżej znajdziesz przykład aplikacji, która wywołuje pakiet 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);
}
});
}
Testowanie procesu ulepszania imprezy
Aby przetestować proces aktualizacji, który użytkownicy widzą podczas aktualizacji systemu operacyjnego Android:
- Na testowym urządzeniu z Androidem otwórz Ustawienia > Google > Debugowanie Upgrade Party.
- Kliknij kolejno Zgłoś uaktualnienie i Otwórz grupę uaktualnienia. W zależności od wersji systemu operacyjnego urządzenia rozpoczyna się odpowiedni proces. Na przykład impreza z aktualizacją na Androida 12 odtwarza się na urządzeniu z Androidem 12.