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

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

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

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

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

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

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

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

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

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

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

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

  • מסך הפתיחה
  • מסך התכונות
  • מסך הסיום
איור 1. שלושת סוגי המסכים בתהליך ההזמנה לשדרוג

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

מסך הפתיחה

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

פריסה
איור 2. פריסת קווים למסך הפתיחה של ההזמנה לשדרוג

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

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

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

איור 3. ערכת הצבעים שמוגדרת כברירת מחדל בתהליך ההזמנה לשדרוג.

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

תנועה

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

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

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

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

מסך התכונות

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

פריסה
איור 8. פריסת קווים של מסכי התכונה 'הזמנה לשדרוג'.

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

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

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

מסך הסיום

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

פריסה
איור 9. פריסה של קווים כלליים למסך הסיום של ההזמנה לשדרוג.

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

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

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

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

הפעלת הצד לשדרוג באמצעות ה-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.