Pesta Peningkatan Android untuk pembaruan OS

Pesta Peningkatan adalah alur penemuan yang menyoroti fitur-fitur baru untuk pengguna Android setiap kali mereka menerima peningkatan OS besar-besaran.

Peningkatan sistem operasi Android secara besar-besaran dapat menjadi pengalaman yang mengecewakan bagi pengguna Anda. Alur Pihak Peningkatan meningkatkan keterlibatan pengguna dan membantu pengguna memahami cara menavigasi OS mereka yang baru disegarkan.

Setelah meningkatkan ke versi OS terbaru, pengguna menerima pemberitahuan push menyambut mereka ke OS baru dan menampilkan alur kartu dengan fitur-fitur baru.

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

Sesuaikan pengalaman Pesta Peningkatan

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 merek Anda.

Untuk menyesuaikan alurnya, tinjau pedoman dalam Panduan Gaya Pesta Peningkatan dan sertakan informasi penyesuaian Anda dalam formulir Permintaan untuk mengaktifkan Pesta Peningkatan Android .

Tingkatkan Panduan Gaya Undangan

Gunakan panduan gaya ini untuk mengubah tampilan Upgrade Invite agar sesuai dengan merek Anda (layar, warna, font). Kami sangat menyarankan untuk menjaga ukuran dan struktur tetap dekat dengan desain aslinya.

Alur Peningkatan Undangan menampilkan tiga komponen berikut:

• Layar pengantar
• Layar fitur
• Layar luar

Animasi di 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 berwarna-warni
• Bingkai perangkat
• konten UI

Penataan gaya

Jika Anda memilih untuk mengadaptasi gaya Material You , Anda dapat menggunakan warna dan bentuk default yang ditunjukkan pada contoh.

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

Gerakan

Opsi 1: Dengan jam di layar beranda

1. Angka masuk ke layar.
2. Angka berpindah ke tengah sambil mengecil ukurannya. Bingkai ponsel muncul.
3. Ukuran ponsel mengecil. Bentuknya mulai memasuki layar.
4. Animasi selesai. Bentuknya terus bergerak dengan lembut.

Opsi 2: Tidak ada jam di layar beranda

1. Ponsel memasuki layar.
2. Ponsel bergerak ke tengah sambil memperbesar ukurannya. Bentuknya 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 sesuai dengan konten UI dan tampilan umum.
• Di dalam layar, atur ukuran font agar mudah dibaca. Jika perlu, atur ukuran font yang lebih besar.

Gerakan

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

Layar luar

Layar outro melengkapi alurnya. Ini menunjukkan kepada pengguna bahwa mereka telah melewati semua layar.

Tata Letak

Animasi perangkat selalu terdiri dari:

• Setengah lingkaran di latar belakang (ditambah bentuk animasi)
• Bingkai perangkat
• konten UI

Penataan gaya

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

Gerakan

Ikuti alur animasi layar outro standar:

1. Ponselnya bergerak naik sedikit.
2. Sebuah lingkaran muncul di latar belakang.
3. Bentuk muncul dari belakang ponsel.
4. Bentuknya terbang keluar dari latar belakang seperti confetti.

Picu Pihak Peningkatan dengan SDK

Secara default, OS Android mengirimkan pemberitahuan push kepada pengguna yang menampilkan alur kartu dengan fitur terbaru segera setelah mereka melakukan upgrade. Jika Anda lebih suka memicu alur dari notifikasi push atau aplikasi Anda sendiri, gunakan Android SDK.

Prasyarat

Pastikan file build aplikasi Anda menggunakan nilai berikut:

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

Konfigurasikan aplikasi Anda

1. Ekstrak perpustakaan dari file Zip yang disediakan, dan letakkan di repositori Anda.

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

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

3. Sertakan perpustakaan 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
   

Gunakan APInya

1. Untuk menginisialisasi klien, gunakan kelas UpgradeParty dan atur parameter activity .

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

UpgradePartyClient yang dihasilkan memperlihatkan fungsionalitas API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Mengembalikan objek Task yang memverifikasi secara asinkron apakah pengguna memenuhi syarat untuk Partai Peningkatan. Nilai boolean yang dihasilkan menunjukkan apakah pengguna memenuhi syarat atau tidak.

panggilUpgradeParty

Task<Void> invokeUpgradeParty();

Memanggil Activity Pihak Peningkatan. Objek Task yang dihasilkan menunjukkan apakah terjadi kesalahan saat memulai aktivitas.

Kesalahan

Kedua metode API bisa gagal dengan pengecualian tipe com.google.android.gms.common.api.ApiException . Dalam kasus seperti ini, penelepon diharapkan untuk mencoba lagi di lain waktu.

Kode status umum yang diharapkan meliputi:

• INTERNAL_ERROR : Mewakili kesalahan apa pun dalam aliran logika yang mendasarinya.
• TIMEOUT : Ditampilkan ketika permintaan tidak dapat ditangani tepat waktu.
• API_NOT_CONNECTED : Berarti API tidak tersedia (misalnya, modul UpgradeParty belum siap).
• DEVELOPER_ERROR : Ditampilkan ketika paket panggilan tidak diperbolehkan mengakses kelas 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);
             }
           });
   }

Uji alur Pesta Peningkatan

Ikuti langkah-langkah berikut untuk menguji alur Pesta Peningkatan yang dilihat pengguna saat mereka meningkatkan versi OS Android:

1. Pada perangkat Android pengujian, buka Pengaturan > Google > Debug Pihak Peningkatan .
2. Pilih Laporan Peningkatan , lalu Buka Pihak Peningkatan . Ini memulai alur yang relevan, berdasarkan versi OS perangkat. Misalnya, Pesta Peningkatan Android 12 diputar di perangkat yang menjalankan OS Android 12.