מסיבת שדרוג אנדרואיד עבור עדכוני מערכת ההפעלה

Upgrade Party היא זרימת גילוי המדגישה תכונות חדשות עבור משתמשי אנדרואיד בכל פעם שהם מקבלים שדרוג גדול של מערכת ההפעלה.

שדרוג גדול של מערכת ההפעלה אנדרואיד יכול להיות חוויה מרתקת עבור המשתמשים שלך. זרימת מסיבת השדרוג מגבירה את מעורבות המשתמשים ועוזרת למשתמשים להבין כיצד לנווט במערכת ההפעלה החדשה שלהם.

לאחר שדרוג לגרסת מערכת ההפעלה האחרונה, המשתמשים מקבלים הודעת דחיפה המברכת אותם למערכת ההפעלה החדשה ומציגה זרימת כרטיסים עם התכונות החדשות.

כדי להפעיל את מסיבת השדרוג עבור מערכת ההפעלה אנדרואיד שלך, הירשם באמצעות טופס הבקשה להפעלת מסיבת השדרוג של Android .

התאם אישית את חווית מסיבת השדרוג

אתה יכול להתאים אישית את חוויית השדרוג של מסיבת השדרוג בדרכים הבאות:

• הסר תכונות לא רלוונטיות.
• עדכן את השפה בקוביות הטקסט.
• שנה את האנימציות, הצבעים והגופנים כך שיתאימו למותג שלך.

כדי להתאים אישית את הזרימה, עיין בהנחיות במדריך סגנון מסיבת השדרוג וכלול את פרטי ההתאמה האישית שלך בטופס הבקשה להפעלת מסיבת השדרוג של Android .

הפעל את מסיבת השדרוג עם ה-SDK

כברירת מחדל, מערכת ההפעלה אנדרואיד שולחת למשתמשים הודעת דחיפה המציגה זרימת כרטיס עם התכונות העדכניות ביותר ברגע שהם משדרגים. אם אתה מעדיף להפעיל את הזרימה מהתראת דחיפה משלך או מאפליקציה, השתמש ב-Android SDK.

דרישות מוקדמות

ודא שקובץ ה-build של האפליקציה שלך משתמש בערכים הבאים:

• minSdkVersion של 14 ומעלה
• compileSdkVersion של 28 ומעלה

הגדר את האפליקציה שלך

1. חלץ את הספרייה מקובץ ה-Zip שסופק, והנח אותו במאגר שלך.

2. הוסף את התלות של Google Growth SDK לקובץ Gradle ברמת האפליקציה של המודול שלך, בדרך כלל app/build.gradle :

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

3. כלול את הספריות הבאות כתלות:

   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
   

השתמש ב-API

1. כדי לאתחל לקוח, השתמש במחלקה UpgradeParty והגדר את פרמטר activity .

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

UpgradePartyClient שנוצר חושף את פונקציונליות ה-API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

מחזירה אובייקט Task שמאמת באופן אסינכרוני אם המשתמש כשיר למסיבה שדרוג. הערך הבוליאני המתקבל מציין אם המשתמש כשיר או לא.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

מפעיל Activity מסיבת שדרוג . אובייקט Task שנוצר מציין אם אירעה שגיאה בעת התחלת הפעילות.

שגיאות

שתי שיטות ה-API יכולות להיכשל למעט סוג com.google.android.gms.common.api.ApiException . במקרים כאלה, המתקשר צפוי לנסות שוב במועד מאוחר יותר.

קודי סטטוס נפוצים צפויים כוללים:

• INTERNAL_ERROR : מייצג שגיאה כלשהי בזרימת הלוגיקה הבסיסית.
• TIMEOUT : מוצג כאשר לא ניתן היה לטפל בבקשה בזמן.
• API_NOT_CONNECTED : פירוש הדבר שה-API אינו זמין (לדוגמה, מודול UpgradeParty עדיין לא מוכן).
• DEVELOPER_ERROR : מוצג כאשר החבילה המתקשרת אינה מורשית לגשת למחלקה UpgradeParty .

דוגמה של SDK

ראה את הדוגמה הבאה של אפליקציה שמפעילה את ה-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);
             }
           });
   }

בדוק את זרימת מסיבת השדרוג

בצע את השלבים הבאים כדי לבדוק את זרימת מסיבת השדרוג שהמשתמשים שלך רואים כשהם משדרגים את מערכת ההפעלה אנדרואיד:

1. במכשיר ה-Android הנבדק, עבור אל הגדרות > Google > ניפוי באגים של שדרוג מסיבת .
2. בחר דווח על שדרוג ולאחר מכן פתח את מסיבת השדרוג . זה מתחיל את הזרימה הרלוונטית, בהתבסס על גרסת מערכת ההפעלה של המכשיר. לדוגמה, מסיבת השדרוג של אנדרואיד 12 פועלת במכשיר המריץ את מערכת ההפעלה אנדרואיד 12.