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

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

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

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

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

התאמה אישית של חוויית השימוש ב-Upgrade Party

אתם יכולים להתאים אישית את חוויית השימוש ב-Upgrade Party בדרכים הבאות:

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

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

מדריך סגנון להזמנות לשדרוג

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

תהליך ההזמנה לשדרוג כולל את שלושת הרכיבים הבאים:

• מסך הפתיחה
• מסך התכונות
• מחוץ למסך

אנימציה בכל מסך עוזרת להסביר את כל תכונה.

מסך הפתיחה

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

פריסה

האנימציה במכשיר כוללת תמיד:

• רקע לבן וצורות צבעוניות
• מסגרת המכשיר
• תוכן ממשק המשתמש

עיצוב

אם בוחרים להתאים את הסגנון ל-Material You, אפשר להשתמש בצבעים ובצורות שמוגדרים כברירת מחדל בדוגמה.

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

תנועה

אפשרות 1: עם שעון במסך הבית

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

אפשרות 2: אין שעון במסך הבית

1. הטלפון הנייד נכנס למסך.
2. הטלפון זז למרכז וגודלו גדל. הצורות מתחילות להיכנס למסך.
3. הטלפון מגיע לגודל המקסימלי והצורות ממשיכות לזוז.

מסך התכונה

בכל מסך תכונות מודגשת תכונה במערכת ההפעלה החדשה.

פריסה

אנימציית המכשיר תמיד מורכבת מהפרטים הבאים:

• רקע צבעוני
• מסגרת המכשיר
• תוכן ממשק המשתמש

עיצוב

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

תנועה

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

מסך Outro

מסך הסיום משלים את התהליך. הוא מציין למשתמשים שהם עברו את כל המסכים.

פריסה

אנימציית המכשיר תמיד מורכבת מהפרטים הבאים:

• חצי עיגול ברקע (וגם צורות מונפשות)
• מסגרת המכשיר
• תוכן ממשק המשתמש

עיצוב

• בוחרים צבע רקע שמתאים לתוכן של ממשק המשתמש ולמראה הכללי.
• משתמשים בצורה של חצי עיגול.

תנועה

פועלים לפי תהליך האנימציה הרגיל של מסך הסיום:

1. הטלפון הנייד זז קצת למעלה.
2. עיגול מופיע ברקע.
3. צורות מופיעות מאחורי הטלפון הנייד.
4. הצורות ממריאות מהרקע כמו קונפטי.

הפעלת הצד לשדרוג באמצעות ה-SDK

כברירת מחדל, מערכת ההפעלה של Android שולחת למשתמשים התראה עם רצף כרטיסים עם התכונות העדכניות ביותר ברגע שהם מבצעים את השדרוג. אם אתם מעדיפים להפעיל את התהליך מהתראת דחיפה משלכם או מאפליקציה, תוכלו להשתמש ב-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);
             }
           });
   }

בדיקת התהליך של Upgrade Party

כדי לבדוק את התהליך של Upgrade Party שמוצג למשתמשים כשהם משדרגים את מערכת ההפעלה Android:

1. במכשיר Android לבדיקה, עוברים אל הגדרות > Google > ניפוי באגים של מסיבת השדרוג.
2. בוחרים באפשרות דיווח על שדרוג ואז באפשרות פתיחת 'שדרוג צדדים'. הפעולה הזאת תתחיל את התהליך הרלוונטי, בהתאם לגרסת מערכת ההפעלה של המכשיר. לדוגמה, אפשר להפעיל את Android 12 Upgrade Party במכשיר עם מערכת ההפעלה Android 12.