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

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

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

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

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

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

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

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

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

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

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

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

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

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

מסך הפתיחה

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

פריסה

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

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

עיצוב

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

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

נסיעה, תנועה

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

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

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

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

מסך התכונות

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

פריסה

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

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

עיצוב

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

נסיעה, תנועה

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

מסך הסיום

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

פריסה

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

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

עיצוב

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

נסיעה, תנועה

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

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.