Impreza uaktualniająca Androida w celu uzyskania aktualizacji systemu operacyjnego

Upgrade Party to proces odkrywania nowych funkcji dla użytkowników Androida za każdym razem, gdy otrzymują ważną aktualizację systemu operacyjnego.

Poważna aktualizacja systemu operacyjnego Android może być rozczarowaniem dla użytkowników. Przebieg Upgrade Party zwiększa zaangażowanie użytkowników i pomaga im zrozumieć, jak poruszać się po nowo odświeżonym systemie operacyjnym.

Po aktualizacji do najnowszej wersji systemu operacyjnego użytkownicy otrzymują powiadomienie push witające ich w nowym systemie operacyjnym i prezentujące przepływ kart z nowymi funkcjami.

Aby włączyć imprezę aktualizacyjną dla swojego systemu operacyjnego Android, zarejestruj się za pomocą formularza wniosku o aktywację imprezy aktualizacyjnej Android .

Dostosuj doświadczenie Upgrade Party

Możesz dostosować doświadczenie Upgrade Party na następujące sposoby:

• Usuń nieistotne funkcje.
• Zaktualizuj język w blokach tekstowych.
• Zmodyfikuj animacje, kolory i czcionki, aby pasowały do ​​Twojej marki.

Aby dostosować przebieg, zapoznaj się ze wskazówkami zawartymi w Przewodniku po stylu imprezy aktualizacyjnej i podaj informacje dotyczące dostosowywania w formularzu Prośby o aktywację Imprezy aktualizacyjnej Androida .

Zorganizuj imprezę aktualizacyjną 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 dokonają aktualizacji. Jeśli wolisz uruchamiać przepływ za pomocą własnego powiadomienia push lub aplikacji, użyj pakietu Android SDK.

Warunki wstępne

Upewnij się, że plik kompilacji aplikacji używa następujących wartości:

• minSdkVersion 14 lub nowszy
• compileSdkVersion 28 lub nowsza

Skonfiguruj swoją aplikację

1. Wyodrębnij bibliotekę z dostarczonego pliku Zip i umieść ją w swoim repozytorium.

2. 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')
    }
   

3. Dołącz następujące biblioteki jako zależności:

   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
   

Skorzystaj z API

1. Aby zainicjować klienta, użyj klasy UpgradeParty i ustaw parametr activity .

    import com.google.android.gms.growth.UpgradeParty;
    UpgradeParty.getClient(activity);
   

Wynikowy UpgradePartyClient udostępnia funkcjonalność API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Zwraca obiekt Task , który asynchronicznie sprawdza, czy użytkownik kwalifikuje się do grupy uaktualniającej. Wynikowa wartość logiczna wskazuje, czy użytkownik jest uprawniony, czy nie.

wywołajUpgradeParty

Task<Void> invokeUpgradeParty();

Wywołuje Activity grupy ulepszeń. Wynikowy obiekt Task wskazuje, czy wystąpił błąd podczas uruchamiania działania.

Błędy

Obie metody API mogą zakończyć się niepowodzeniem z wyjątkiem typu com.google.android.gms.common.api.ApiException . W takich przypadkach oczekuje się, że osoba wywołująca spróbuje ponownie później.

Oczekiwane typowe kody stanu obejmują:

• INTERNAL_ERROR : Reprezentuje dowolny błąd w przepływie podstawowej logiki.
• TIMEOUT : Wyświetlany, gdy żądanie nie mogło zostać obsłużone w odpowiednim czasie.
• API_NOT_CONNECTED : Oznacza, że ​​interfejs API nie jest dostępny (na przykład moduł UpgradeParty nie jest jeszcze gotowy).
• DEVELOPER_ERROR : Wyświetlany, gdy pakiet wywołujący nie ma dostępu do klasy UpgradeParty .

Przykład SDK

Zobacz następujący przykład aplikacji, która wywołuje 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);
             }
           });
   }

Przetestuj przepływ grupy aktualizacyjnej

Wykonaj poniższe kroki, aby przetestować proces aktualizacji, który widzą użytkownicy podczas aktualizacji systemu operacyjnego Android:

1. Na testowym urządzeniu z Androidem wybierz Ustawienia > Google > Debuguj uaktualnienie grupy .
2. Wybierz opcję Zgłoś aktualizację , a następnie Otwórz imprezę aktualizacyjną . Spowoduje to rozpoczęcie odpowiedniego przepływu w zależności od wersji systemu operacyjnego urządzenia. Na przykład impreza z aktualizacją Androida 12 jest odtwarzana na urządzeniu z systemem operacyjnym Android 12.