حفلة ترقية Android للحصول على تحديثات نظام التشغيل

Upgrade Party عبارة عن تدفق اكتشاف يسلط الضوء على الميزات الجديدة لمستخدمي Android عندما يتلقون ترقية رئيسية لنظام التشغيل.

يمكن أن تكون الترقية الرئيسية لنظام التشغيل Android تجربة محبطة للمستخدمين. يزيد تدفق حفلة الترقية من تفاعل المستخدم ويساعد المستخدمين على فهم كيفية التنقل في نظام التشغيل الذي تم تحديثه حديثًا.

بعد الترقية إلى أحدث إصدار من نظام التشغيل، يتلقى المستخدمون إشعارًا فوريًا يرحب بهم في نظام التشغيل الجديد ويعرض تدفق البطاقة مع الميزات الجديدة.

لتمكين Upgrade Party لنظام التشغيل Android الخاص بك، قم بالتسجيل باستخدام نموذج طلب تنشيط Android Upgrade Party .

قم بتخصيص تجربة حفلة الترقية

يمكنك تخصيص تجربة Upgrade Party بالطرق التالية:

• إزالة الميزات غير ذات الصلة.
• قم بتحديث اللغة في الكتل النصية.
• قم بتعديل الرسوم المتحركة والألوان والخطوط لتتناسب مع علامتك التجارية.

لتخصيص التدفق، راجع الإرشادات الموجودة في دليل نمط حفلة الترقية وقم بتضمين معلومات التخصيص الخاصة بك في نموذج طلب تنشيط حفلة ترقية Android .

قم بتشغيل مجموعة الترقية باستخدام SDK

افتراضيًا، يرسل نظام التشغيل Android للمستخدمين إشعارًا بالدفع يعرض تدفق البطاقة بأحدث الميزات بمجرد الترقية. إذا كنت تفضل تشغيل التدفق من إشعار الدفع الخاص بك أو أحد التطبيقات، فاستخدم Android SDK.

المتطلبات الأساسية

تأكد من أن ملف إنشاء تطبيقك يستخدم القيم التالية:

• minSdkVersion الإصدار 14 أو أعلى
• compileSdkVersion 28 أو أعلى

قم بتكوين التطبيق الخاص بك

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
   

استخدم واجهة برمجة التطبيقات

1. لتهيئة العميل، استخدم فئة UpgradeParty وقم بتعيين معلمة activity .

    import com.google.android.gms.growth.UpgradeParty;
    UpgradeParty.getClient(activity);
   

يكشف UpgradePartyClient الناتج عن وظيفة واجهة برمجة التطبيقات (API).

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

إرجاع كائن Task يتحقق بشكل غير متزامن مما إذا كان المستخدم مؤهلاً لحفلة الترقية. تشير القيمة المنطقية الناتجة إلى ما إذا كان المستخدم مؤهلاً أم لا.

استدعاءUpgradeParty

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);
             }
           });
   }

اختبر تدفق حفلة الترقية

اتبع هذه الخطوات لاختبار تدفق حفلة الترقية التي يراها المستخدمون عند قيامهم بترقية نظام التشغيل Android:

1. على جهاز Android التجريبي، انتقل إلى الإعدادات > Google > تصحيح أخطاء الطرف الترقية .
2. حدد تقرير الترقية ثم افتح حفلة الترقية . يؤدي هذا إلى بدء التدفق ذي الصلة، استنادًا إلى إصدار نظام تشغيل الجهاز. على سبيل المثال، يتم تشغيل Android 12 Upgrade Party على جهاز يعمل بنظام التشغيل Android 12.