Android Upgrade Party untuk update OS

Upgrade Party adalah alur penemuan yang menyoroti fitur baru untuk pengguna Android setiap kali mereka menerima upgrade OS utama.

Upgrade sistem operasi Android utama dapat menjadi pengalaman yang mengecewakan bagi pengguna Anda. Alur Upgrade Party meningkatkan engagement pengguna dan membantu pengguna memahami cara menavigasi OS yang baru diupdate.

Setelah mengupgrade ke versi OS terbaru, pengguna akan menerima notifikasi push yang menyambut mereka ke OS baru dan menampilkan alur kartu dengan fitur baru.

Untuk mengaktifkan Upgrade Party untuk OS Android Anda, daftar menggunakan formulir Permintaan untuk mengaktifkan Upgrade Party Android.

Menyesuaikan pengalaman Upgrade Pihak

Anda dapat menyesuaikan pengalaman Upgrade Party dengan cara berikut:

• Hapus fitur yang tidak relevan.
• Perbarui bahasa di blok teks.
• Ubah animasi, warna, dan font agar sesuai dengan brand Anda.

Untuk menyesuaikan alur, tinjau panduan dalam Panduan Gaya Upgrade Party dan sertakan informasi penyesuaian Anda dalam formulir Permintaan untuk mengaktifkan Upgrade Party Android.

Panduan Gaya Undangan Upgrade

Gunakan panduan gaya ini untuk memodifikasi tampilan Undangan Upgrade agar sesuai dengan merek Anda (layar, warna, font). Sebaiknya pertahankan ukuran dan struktur agar tetap mendekati desain asli.

Alur Undangan Upgrade menampilkan tiga komponen berikut:

• Layar pengantar
• Layar fitur
• Layar outro

Animasi pada setiap layar membantu menjelaskan setiap fitur.

Layar pengantar

Layar intro berisi animasi pendek yang menyambut pengguna dan mendorong mereka untuk memulai alur yang ditampilkan di layar intro.

Tata Letak

Animasi perangkat selalu terdiri dari:

• Latar belakang putih dan bentuk warna-warni
• Bingkai perangkat
• Konten UI

Penataan gaya

Jika memilih untuk menyesuaikan gaya visual Material You, Anda dapat menggunakan warna dan bentuk default yang ditampilkan dalam contoh.

Jika Anda menggunakan warna merek sendiri, pastikan warna tersebut berfungsi dengan baik dengan latar belakang UI.

Gerakan

Opsi 1: Dengan jam di layar utama

1. Angka masuk ke layar.
2. Angka akan berpindah ke tengah dengan ukuran yang lebih kecil. Bingkai ponsel akan muncul.
3. Ukuran ponsel berkurang. Bentuk mulai masuk ke layar.
4. Animasi selesai. Bentuk terus bergerak perlahan.

Opsi 2: Tidak ada jam di layar utama

1. Ponsel masuk ke layar.
2. Ponsel bergerak ke tengah dan ukurannya bertambah. Bentuk mulai memasuki layar.
3. Ponsel mencapai ukuran maksimum dan bentuknya terus bergerak.

Layar fitur

Setiap layar fitur menyoroti fitur di OS baru.

Tata Letak

Animasi perangkat selalu terdiri dari:

• Latar belakang berwarna-warni
• Bingkai perangkat
• Konten UI

Penataan gaya

• Pilih warna latar belakang yang cocok dengan konten UI dan dengan tampilan umum.
• Di dalam layar, tetapkan ukuran font yang mudah dibaca. Jika perlu, tetapkan ukuran font yang lebih besar.

Gerakan

Rekam animasi alur setiap fitur, termasuk interaksi sentuh. Ekspor rekaman sebagai file Lottie.

Layar outro

Layar outro melengkapi alur. Hal ini menunjukkan kepada pengguna bahwa mereka telah membuka semua layar.

Tata Letak

Animasi perangkat selalu terdiri dari:

• Setengah lingkaran di latar belakang (plus bentuk animasi)
• Bingkai perangkat
• Konten UI

Penataan gaya

• Pilih warna latar belakang yang cocok dengan konten UI dan tampilan umum.
• Gunakan bentuk setengah lingkaran.

Gerakan

Ikuti alur animasi layar outro standar:

1. Ponsel bergerak sedikit ke atas.
2. Lingkaran akan muncul di latar belakang.
3. Bentuk muncul dari belakang ponsel.
4. Bentuk-bentuk terbang keluar dari latar belakang seperti konfeti.

Memicu Upgrade Party dengan SDK

Secara default, Android OS mengirimkan notifikasi push kepada pengguna yang menampilkan alur kartu dengan fitur terbaru segera setelah mereka mengupgrade. Jika Anda memilih untuk memicu alur dari notifikasi push Anda sendiri atau aplikasi, gunakan Android SDK.

Prasyarat

Pastikan bahwa file build aplikasi Anda menggunakan nilai berikut:

• minSdkVersion 14 atau yang lebih tinggi
• compileSdkVersion dari 28 atau yang lebih tinggi

Mengonfigurasi aplikasi Anda

1. Ekstrak library dari file Zip yang disediakan, lalu tempatkan di repositori Anda.

2. Tambahkan dependensi untuk Google Growth SDK ke file Gradle level aplikasi modul Anda, biasanya app/build.gradle:

    dependencies {
        implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
    }
   

3. Sertakan library berikut sebagai dependensi:

   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
   

Menggunakan API

1. Untuk melakukan inisialisasi klien, gunakan class UpgradeParty dan tetapkan parameter activity.

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

UpgradePartyClient yang dihasilkan mengekspos fungsi API.

isValidForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Menampilkan objek Task yang memverifikasi secara asinkron apakah pengguna memenuhi syarat untuk Upgrade Party. Nilai boolean yang dihasilkan menunjukkan apakah pengguna memenuhi syarat atau tidak.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

Memanggil Upgrade Party Activity. Objek Task yang dihasilkan menunjukkan apakah terjadi error saat memulai aktivitas.

Error

Kedua metode API dapat gagal dengan pengecualian jenis com.google.android.gms.common.api.ApiException. Dalam kasus tersebut, pemanggil diharapkan untuk mencoba lagi nanti.

Kode status umum yang diharapkan meliputi:

• INTERNAL_ERROR: Mewakili error dalam alur logika yang mendasarinya.
• TIMEOUT: Ditampilkan saat permintaan tidak dapat ditangani secara tepat waktu.
• API_NOT_CONNECTED: Berarti API tidak tersedia (misalnya, modul UpgradeParty belum siap).
• DEVELOPER_ERROR: Ditampilkan saat paket panggilan tidak diizinkan untuk mengakses class UpgradeParty.

Contoh SDK

Lihat contoh aplikasi berikut yang memanggil 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);
             }
           });
   }

Menguji alur Upgrade Party

Ikuti langkah-langkah berikut untuk menguji alur Upgrade Party yang dilihat pengguna saat mengupgrade OS Android:

1. Di perangkat Android pengujian, buka Setelan > Google > Upgrade Party debug.
2. Pilih Laporkan Upgrade, lalu Buka Upgrade Pihak. Tindakan ini akan memulai alur yang relevan, berdasarkan versi OS perangkat. Misalnya, Android 12 Upgrade Party bermain di perangkat yang menjalankan Android 12 OS.