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

Upgrade Party یک جریان اکتشافی است که ویژگی های جدید را برای کاربران Android هر زمان که یک ارتقاء سیستم عامل اصلی دریافت می کنند برجسته می کند.

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

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

برای فعال کردن Upgrade Party برای سیستم عامل Android خود، با استفاده از فرم درخواست برای فعال کردن Android Upgrade Party ثبت نام کنید.

تجربه Upgrade Party را سفارشی کنید

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

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

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

حزب ارتقا را با SDK راه اندازی کنید

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

پیش نیازها

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

• 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();

یک Upgrade Party 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 آزمایشی، به Settings > Google > Upgrade Party Debug بروید.
2. Report Upgrade را انتخاب کنید و سپس Upgrade Party را باز کنید . این جریان مربوطه را بر اساس نسخه سیستم عامل دستگاه شروع می کند. به عنوان مثال، Android 12 Upgrade Party روی دستگاهی با سیستم عامل Android 12 پخش می شود.