Upgrade Party عبارة عن تدفق اكتشاف يسلط الضوء على الميزات الجديدة لمستخدمي Android عندما يتلقون ترقية رئيسية لنظام التشغيل.
يمكن أن تكون الترقية الرئيسية لنظام التشغيل Android تجربة محبطة للمستخدمين. يزيد تدفق حفلة الترقية من تفاعل المستخدم ويساعد المستخدمين على فهم كيفية التنقل في نظام التشغيل الذي تم تحديثه حديثًا.
بعد الترقية إلى أحدث إصدار من نظام التشغيل، يتلقى المستخدمون إشعارًا فوريًا يرحب بهم في نظام التشغيل الجديد ويعرض تدفق البطاقة مع الميزات الجديدة.
لتمكين Upgrade Party لنظام التشغيل Android الخاص بك، قم بالتسجيل باستخدام نموذج طلب تنشيط Android Upgrade Party .
قم بتخصيص تجربة حفلة الترقية
يمكنك تخصيص تجربة Upgrade Party بالطرق التالية:
- إزالة الميزات غير ذات الصلة.
- قم بتحديث اللغة في الكتل النصية.
- قم بتعديل الرسوم المتحركة والألوان والخطوط لتتناسب مع علامتك التجارية.
لتخصيص التدفق، راجع الإرشادات الموجودة في دليل نمط حفلة الترقية وقم بتضمين معلومات التخصيص الخاصة بك في نموذج طلب تنشيط حفلة ترقية Android .
ترقية دليل نمط الدعوة
استخدم دليل النمط هذا لتعديل مظهر Upgrade Invite ليناسب علامتك التجارية (الشاشات والألوان والخطوط). نوصي بشدة بالحفاظ على الأحجام والهيكل قريبًا من التصميم الأصلي.
يتميز تدفق دعوة الترقية بالمكونات الثلاثة التالية:
- شاشة مقدمة
- شاشة مميزة
- شاشة خارجية
تساعد الرسوم المتحركة الموجودة على كل شاشة في شرح كل ميزة.
شاشة مقدمة
تحتوي شاشة المقدمة على رسم متحرك قصير يرحب بالمستخدم ويشجعه على بدء التدفق الموضح على شاشة المقدمة.
تَخطِيط
تتكون الرسوم المتحركة للجهاز دائمًا من:
- خلفية بيضاء وأشكال ملونة
- إطار الجهاز
- محتوى واجهة المستخدم
التصميم
إذا اخترت تعديل تصميم Material You ، فيمكنك استخدام الألوان والأشكال الافتراضية الموضحة في المثال.
إذا كنت تستخدم لون علامتك التجارية الخاصة، فتأكد من أنه يعمل بشكل جيد مع خلفية واجهة المستخدم.
حركة
الخيار 1: مع وجود ساعة على الشاشة الرئيسية
- أرقام تدخل الشاشة.
- تنتقل الأرقام إلى المركز بينما يتناقص حجمها. يظهر إطار الهاتف المحمول.
- يقل حجم الهاتف. تبدأ الأشكال في الدخول إلى الشاشة.
- اكتملت الرسوم المتحركة. تستمر الأشكال في التحرك بلطف.
الخيار 2: لا توجد ساعة على الشاشة الرئيسية
- يدخل الهاتف المحمول إلى الشاشة.
- يتحرك الهاتف إلى المركز مع زيادة الحجم. تبدأ الأشكال في الدخول إلى الشاشة.
- يصل الهاتف إلى الحد الأقصى للحجم وتستمر الأشكال في الحركة.
شاشة مميزة
تسلط كل شاشة ميزة الضوء على إحدى الميزات الموجودة في نظام التشغيل الجديد.
تَخطِيط
تتكون الرسوم المتحركة للجهاز دائمًا من:
- خلفية ملونة
- إطار الجهاز
- محتوى واجهة المستخدم
التصميم
- اختر لون خلفية يتناسب بشكل جيد مع محتوى واجهة المستخدم والمظهر العام.
- داخل الشاشات، قم بتعيين أحجام الخطوط التي يمكن قراءتها بسهولة. إذا لزم الأمر، قم بتعيين أحجام خطوط أكبر.
حركة
قم بتسجيل رسم متحرك لتدفق كل ميزة، بما في ذلك تفاعلات اللمس. تصدير التسجيلات كملفات Lottie .
شاشة خارجية
تكمل الشاشة الخارجية التدفق. ويشير للمستخدمين إلى أنهم مروا بجميع الشاشات.
تَخطِيط
تتكون الرسوم المتحركة للجهاز دائمًا من:
- نصف دائرة على الخلفية (بالإضافة إلى الأشكال المتحركة)
- إطار الجهاز
- محتوى واجهة المستخدم
التصميم
- حدد لون الخلفية الذي يتناسب بشكل جيد مع محتوى واجهة المستخدم والمظهر العام.
- استخدم شكل نصف دائرة.
حركة
اتبع تدفق الرسوم المتحركة القياسي للشاشة الخارجية:
- يتحرك الهاتف المحمول للأعلى قليلاً.
- تظهر دائرة في الخلفية.
- الأشكال تأتي من خلف الهاتف المحمول.
- الأشكال تطير من الخلفية مثل قصاصات الورق.
قم بتشغيل مجموعة الترقية باستخدام SDK
افتراضيًا، يرسل نظام التشغيل Android للمستخدمين إشعارًا بالدفع يعرض تدفق البطاقة بأحدث الميزات بمجرد الترقية. إذا كنت تفضل تشغيل التدفق من إشعار الدفع الخاص بك أو أحد التطبيقات، فاستخدم Android SDK.
المتطلبات الأساسية
تأكد من أن ملف إنشاء تطبيقك يستخدم القيم التالية:
-
minSdkVersion
الإصدار 14 أو أعلى -
compileSdkVersion
28 أو أعلى
قم بتكوين التطبيق الخاص بك
- قم باستخراج المكتبة من الملف المضغوط المقدم، ثم ضعه في مستودعك.
أضف تبعيات Google Growth SDK إلى ملف Gradle على مستوى التطبيق الخاص بوحدتك، عادةً
app/build.gradle
:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
قم بتضمين المكتبات التالية كتبعيات:
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
استخدم واجهة برمجة التطبيقات
لتهيئة العميل، استخدم فئة
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:
- على جهاز Android التجريبي، انتقل إلى الإعدادات > Google > تصحيح أخطاء الطرف الترقية .
- حدد تقرير الترقية ثم افتح حفلة الترقية . يؤدي هذا إلى بدء التدفق ذي الصلة، استنادًا إلى إصدار نظام تشغيل الجهاز. على سبيل المثال، يتم تشغيل Android 12 Upgrade Party على جهاز يعمل بنظام التشغيل Android 12.