جشن ارتقا اندروید برای به روز رسانی های سیستم عامل

مهمانی ارتقا، یک جریان اکتشافی است که ویژگی‌های جدید را برای کاربران اندروید، هر زمان که یک به‌روزرسانی بزرگ سیستم عامل دریافت می‌کنند، برجسته می‌کند.

یک به‌روزرسانی بزرگ سیستم عامل اندروید می‌تواند برای کاربران شما یک تجربه ناامیدکننده باشد. جریان مهمانی ارتقاء، تعامل کاربر را افزایش می‌دهد و به کاربران کمک می‌کند تا نحوه کار با سیستم عامل تازه به‌روزرسانی شده خود را درک کنند.

پس از ارتقا به آخرین نسخه سیستم عامل، کاربران یک اعلان فوری دریافت می‌کنند که به آنها در مورد سیستم عامل جدید خوشامد می‌گوید و یک جریان کارت با ویژگی‌های جدید را به نمایش می‌گذارد.

تولیدکنندگان دستگاه می‌توانند با ارسال فرم « درخواست فعال‌سازی مهمانی ارتقاء اندروید» ، مهمانی ارتقاء را برای دستگاه‌های دارای سیستم عامل اندروید خود فعال کنند.

تجربه مهمانی ارتقا را سفارشی کنید

شما می‌توانید تجربه‌ی مهمانی ارتقا را به روش‌های زیر سفارشی کنید:

• ویژگی‌های نامرتبط را حذف کنید.
• زبان را در بلوک‌های متنی به‌روزرسانی کنید.
• انیمیشن‌ها، رنگ‌ها و فونت‌ها را متناسب با برند خود تغییر دهید.

برای سفارشی‌سازی جریان، دستورالعمل‌های موجود در راهنمای سبک مهمانی ارتقا را مرور کنید و اطلاعات سفارشی‌سازی خود را در پاسخ فرم وارد کنید.

راهنمای سبک دعوت ارتقا

از این راهنمای سبک برای تغییر ظاهر دعوتنامه ارتقاء متناسب با برند خود (صفحه نمایش، رنگ، فونت) استفاده کنید. اکیداً توصیه می‌کنیم اندازه‌ها و ساختار را نزدیک به طرح اصلی نگه دارید.

جریان دعوت به ارتقاء شامل سه جزء زیر است:

• صفحه نمایش مقدمه
• صفحه نمایش ویژگی
• صفحه نمایش بیرونی

یک انیمیشن در هر صفحه به توضیح هر ویژگی کمک می‌کند.

صفحه نمایش مقدمه

صفحه مقدمه شامل یک انیمیشن کوتاه است که به کاربر خوشامد می‌گوید و او را تشویق می‌کند تا روند نمایش داده شده در صفحه مقدمه را آغاز کند.

طرح بندی

انیمیشن دستگاه همیشه شامل موارد زیر است:

• زمینه سفید و اشکال رنگارنگ
• قاب دستگاه
• محتوای رابط کاربری

استایل

اگر تصمیم دارید سبک‌بندی Material You را تطبیق دهید، می‌توانید از رنگ‌ها و شکل‌های پیش‌فرض نشان داده شده در مثال استفاده کنید.

اگر از رنگ برند خودتان استفاده می‌کنید، مطمئن شوید که با پس‌زمینه رابط کاربری به خوبی هماهنگ باشد.

حرکت

گزینه ۱: با یک ساعت در صفحه اصلی

1. اعداد وارد صفحه نمایش می‌شوند.
2. اعداد در حالی که اندازه‌شان کوچک می‌شود به مرکز حرکت می‌کنند. قاب تلفن همراه ظاهر می‌شود.
3. اندازه گوشی کوچک می‌شود. شکل‌ها شروع به ورود به صفحه نمایش می‌کنند.
4. انیمیشن کامل شد. شکل‌ها به آرامی حرکت می‌کنند.

گزینه ۲: عدم نمایش ساعت در صفحه اصلی

1. تلفن همراه وارد صفحه نمایش می‌شود.
2. گوشی در حالی که اندازه‌اش افزایش می‌یابد به مرکز حرکت می‌کند. شکل‌ها شروع به ورود به صفحه می‌کنند.
3. گوشی به حداکثر اندازه خود می‌رسد و شکل‌ها همچنان در حال حرکت هستند.

صفحه نمایش ویژگی

هر صفحه ویژگی، یک ویژگی در سیستم عامل جدید را برجسته می‌کند.

طرح بندی

انیمیشن دستگاه همیشه شامل موارد زیر است:

• پس زمینه رنگارنگ
• قاب دستگاه
• محتوای رابط کاربری

استایل

• یک رنگ پس‌زمینه انتخاب کنید که با محتوای رابط کاربری و ظاهر کلی آن به خوبی هماهنگ باشد.
• در داخل صفحات نمایش، اندازه فونت‌ها را طوری تنظیم کنید که به راحتی قابل خواندن باشند. در صورت نیاز، اندازه فونت‌ها را بزرگتر تنظیم کنید.

حرکت

یک انیمیشن از جریان هر ویژگی، شامل تعاملات لمسی، ضبط کنید. فایل‌های ضبط شده را به صورت فایل‌های Lottie صادر کنید.

صفحه نمایش بیرونی

صفحه‌ی پایانی، جریان را کامل می‌کند. این صفحه به کاربران نشان می‌دهد که تمام صفحات را پشت سر گذاشته‌اند.

طرح بندی

انیمیشن دستگاه همیشه شامل موارد زیر است:

• نیم دایره روی پس‌زمینه (به‌علاوه اشکال متحرک)
• قاب دستگاه
• محتوای رابط کاربری

استایل

• یک رنگ پس‌زمینه انتخاب کنید که با محتوای رابط کاربری و ظاهر کلی آن به خوبی هماهنگ باشد.
• از شکل نیم دایره استفاده کنید.

حرکت

جریان انیمیشن استاندارد صفحه نمایش بیرونی را دنبال کنید:

1. تلفن همراه کمی بالاتر می‌رود.
2. یک دایره در پس زمینه ظاهر می شود.
3. شکل‌هایی از پشت تلفن همراه بالا می‌آیند.
4. شکل‌ها مانند کاغذ رنگی از پس‌زمینه به بیرون پرتاب می‌شوند.

با استفاده از SDK، بخش ارتقا را فعال کنید

به طور پیش‌فرض، سیستم عامل اندروید به محض ارتقا، یک اعلان فوری برای کاربران ارسال می‌کند که جریان کارت را با جدیدترین ویژگی‌ها نمایش می‌دهد. اگر ترجیح می‌دهید جریان را از طریق اعلان فوری خودتان یا یک برنامه فعال کنید، از SDK اندروید استفاده کنید.

پیش‌نیازها

مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می‌کند:

• minSdkVersion از ۱۴ یا بالاتر
• compileSdkVersion ۲۸ یا بالاتر

برنامه خود را پیکربندی کنید

1. کتابخانه را از فایل زیپ ارائه شده استخراج کرده و در مخزن خود قرار دهید.

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 را در معرض نمایش قرار می‌دهد.

مهمانی ارتقاء واجد شرایط است

Task<Boolean> isEligibleForUpgradeParty();

یک شیء Task را برمی‌گرداند که به صورت غیرهمزمان بررسی می‌کند که آیا کاربر واجد شرایط برای Upgrade Party است یا خیر. مقدار بولی حاصل نشان می‌دهد که آیا کاربر واجد شرایط است یا خیر.

فراخوان ارتقاءحزب

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. در دستگاه اندروید آزمایشی، به تنظیمات > گوگل > اشکال‌زدایی ارتقاء گروه بروید.
2. گزینه «گزارش ارتقا» و سپس «باز کردن مهمانی ارتقا» را انتخاب کنید. با این کار، جریان مربوطه، بر اساس نسخه سیستم عامل دستگاه، آغاز می‌شود. به عنوان مثال، مهمانی ارتقا به اندروید ۱۲ روی دستگاهی که سیستم عامل اندروید ۱۲ را اجرا می‌کند، اجرا می‌شود.