Upgrade Party to proces, który pozwala użytkownikom Androida 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 oraz nowych funkcji.
Aby włączyć Upgrade Party na Androidzie, zarejestruj się, korzystając z formularza Prośba 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 tekstu.
- 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 formularzu Prośba o aktywowanie Android Upgrade Party.
Poradnik 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 z wprowadzeniem
- Ekran funkcji
- Ekran zakończenia
Animacja na każdym ekranie pomaga wyjaśnić poszczególne funkcje.
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 składa się z tych elementów:
- 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 dobrze komponuje się on z tłem interfejsu.
Ruch
Opcja 1. Z zegarem na ekranie głównym
- Na ekranie pojawiają się liczby.
- Liczby przesuwają się na środek, ale się zmniejszają. Pojawi się ramka telefonu.
- Rozmiar telefonu się zmniejsza. Kształty zaczynają pojawiać się na ekranie.
- Animacja została ukoń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ągnął maksymalny rozmiar, a kształty wciąż się poruszają.
Ekran funkcji
Każdy ekran funkcji prezentuje funkcję w nowym systemie operacyjnym.
Układ
Animacja urządzenia zawsze składa się z tych elementów:
- 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 przypadku ekranów ustaw rozmiary czcionek, które są łatwe do odczytania. W razie potrzeby ustaw większe rozmiary czcionek.
Ruch
Nagraj animację przedstawiającą przebieg każdej z funkcji, w tym interakcje dotykowe. Wyeksportuj nagrania jako pliki Lottie.
Ekran końcowy
Ekran outro kończy proces. Wskazuje użytkownikom, że przeszli przez wszystkie ekrany.
Układ
Animacja urządzenia zawsze składa się z:
- Półkole na tle (oraz animowane kształty)
- Ramka urządzenia
- Treść interfejsu
Styl
- 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.
- 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 przedstawiające przepływ kart z najnowszymi funkcjami, gdy tylko zostaną one zaktualizowane. Jeśli wolisz uruchamiać przepływ z własnego powiadomienia push lub z aplikacji, użyj pakietu SDK do Androida.
Wymagania wstępne
Upewnij się, że plik kompilacji aplikacji zawiera te wartości:
minSdkVersion
14 lub nowsza,compileSdkVersion
z 28 lub nowszej
Konfigurowanie aplikacji
- Wypakuj bibliotekę z dostarczonego pliku Zip i umieść ją w swojej witrynie.
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.
jestKwalifikująca sięGrupaUaktualnienia
Task<Boolean> isEligibleForUpgradeParty();
Zwraca obiekt Task
, który asynchronicznie sprawdza, czy użytkownik kwalifikuje się do udziału w imprezie dotyczącej uaktualnienia. Otrzymana wartość logiczna wskazuje, czy użytkownik spełnia kryteria.
Wywołaj grupę uaktualnienia
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świetlane, gdy pakiet wywołania nie ma dostępu do klasyUpgradeParty
.
Przykład pakietu SDK
Zobacz ten 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 uaktualniania grupy
Aby przetestować proces aktualizacji, który użytkownicy widzą podczas aktualizacji systemu operacyjnego Android, wykonaj te czynności:
- Na testowym urządzeniu z Androidem kliknij Ustawienia > Google > Debugowanie strony uaktualnienia.
- 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 dotycząca uaktualnienia Androida 12 jest odtwarzana na urządzeniu z systemem operacyjnym Android 12.