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

"حفل الترقية" هو مسار اكتشاف يبرز الميزات الجديدة لمستخدمي Android عند تلقّي ترقية رئيسية لنظام التشغيل.

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

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

يمكن لمصنّعي الأجهزة تفعيل "حفل الترقية" لأجهزة نظام التشغيل Android، من خلال إرسال نموذج طلب تفعيل "حفل الترقية" على Android.

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

يمكنك تخصيص تجربة "حفل الترقية" بالطرق التالية:

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

لتخصيص التدفّق، راجِع الإرشادات الواردة في دليل أسلوب "حفل الترقية" وأدرِج معلومات التخصيص في ردّ على نموذج.

دليل أسلوب "دعوة الترقية"

استخدِم دليل الأسلوب هذا لتعديل مظهر "دعوة الترقية" بما يتناسب مع علامتك التجارية (الشاشات والألوان والخطوط). ننصحك بشدة بالحفاظ على الأحجام و البنية قريبة من التصميم الأصلي.

يتضمّن مسار "دعوة الترقية" المكوّنات الثلاثة التالية:

• شاشة البداية
• شاشة الميزات
• شاشة الخاتمة

تساعد صورة متحركة على كل شاشة في شرح كل ميزة.

شاشة البداية

تحتوي شاشة البداية على صورة متحركة قصيرة ترحّب بالمستخدم وتشجّعه على بدء المسار المعروض على شاشة البداية.

التنسيق

تتضمّن الصورة المتحركة للجهاز دائمًا ما يلي:

• خلفية بيضاء وأشكال ملوّنة
• إطار الجهاز
• محتوى واجهة المستخدم

التصميم

إذا اخترت تكييف Material You تصميم، يمكنك استخدام الألوان والأشكال التلقائية الموضّحة في المثال.

إذا كنت تستخدم لون علامتك التجارية، تأكَّد من أنّه يتناسب مع خلفية واجهة المستخدم.

حركة

الخيار 1: استخدام ساعة على الشاشة الرئيسية

1. تظهر الأرقام على الشاشة.
2. تنتقل الأرقام إلى المنتصف مع انخفاض حجمها. يظهر إطار الهاتف الجوّال.
3. يقل حجم الهاتف. تبدأ الأشكال في الظهور على الشاشة.
4. تكتمل الصورة المتحركة. تستمر الأشكال في التحرك بلطف.

الخيار 2: عدم استخدام ساعة على الشاشة الرئيسية

1. يظهر الهاتف الجوّال على الشاشة.
2. ينتقل الهاتف إلى المنتصف مع زيادة حجمه. تبدأ الأشكال في الظهور على الشاشة.
3. يصل الهاتف إلى الحد الأقصى لحجمه وتستمر الأشكال في التحرك.

شاشة الميزات

تبرز كل شاشة ميزة في نظام التشغيل الجديد.

التنسيق

تتضمّن الصورة المتحركة للجهاز دائمًا ما يلي:

• خلفية ملوّنة
• إطار الجهاز
• محتوى واجهة المستخدم

التصميم

• اختَر لون خلفية يتناسب مع محتوى واجهة المستخدم والمظهر العام.
• داخل الشاشات، اضبط أحجام الخطوط التي يمكن قراءتها بسهولة. إذا لزم الأمر، اضبط أحجام خطوط أكبر.

حركة

سجِّل صورة متحركة لمسار كل ميزة، بما في ذلك التفاعلات باللمس. صدِّر التسجيلات كـ ملفات Lottie.

شاشة الخاتمة

تُكمل شاشة الخاتمة المسار. وتشير إلى المستخدمين بأنّهم اطّلعوا على جميع الشاشات.

التنسيق

تتضمّن الصورة المتحركة للجهاز دائمًا ما يلي:

• نصف دائرة في الخلفية (بالإضافة إلى أشكال متحرّكة)
• إطار الجهاز
• محتوى واجهة المستخدم

التصميم

• اختَر لون خلفية يتناسب مع محتوى واجهة المستخدم والمظهر العام.
• استخدِم شكل نصف دائرة.

حركة

اتّبِع مسار الصورة المتحركة القياسي لشاشة الخاتمة:

1. يرتفع الهاتف الجوّال قليلاً.
2. تظهر دائرة في الخلفية.
3. تظهر أشكال من خلف الهاتف الجوّال.
4. تطير الأشكال خارج الخلفية مثل قصاصات الورق الملوّنة.

تفعيل "حفل الترقية" باستخدام حزمة تطوير البرامج (SDK)

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

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

تأكَّد من أنّ ملف إصدار تطبيقك يستخدم القيم التالية:

• 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
   

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

1. لإعداد عميل، استخدِم فئة UpgradeParty واضبط المَعلمة activity.

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

تعرض السمة UpgradePartyClient الناتجة وظائف واجهة برمجة التطبيقات.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

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

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

يستدعي "حفل الترقية" Activity. يشير عنصر Task الناتج إلى ما إذا حدث خطأ عند بدء النشاط.

الأخطاء

يمكن أن تفشل كلتا طريقتَي واجهة برمجة التطبيقات مع استثناء من النوع com.google.android.gms.common.api.ApiException. في هذه الحالات، يُتوقَّع من المتصل إعادة المحاولة في وقت لاحق.

تشمل رموز الحالة الشائعة المتوقَّعة ما يلي:

• INTERNAL_ERROR: يمثّل أي خطأ في مسار المنطق الأساسي.
• TIMEOUT: يظهر عندما لا يمكن معالجة الطلب في الوقت المناسب.
• API_NOT_CONNECTED: يعني أنّ واجهة برمجة التطبيقات غير متاحة (على سبيل المثال، وحدة 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 على جهاز يعمل بنظام التشغيل Android 12.