توضّح هذه الصفحة كيفية دمج مطوّري التطبيقات ميزة التثبيت المضمّن، وهي ميزة اختبارية جديدة في Google Play تعرض تفاصيل منتجات تطبيقات Google Play في واجهة نصف ورقة. تتيح ميزة "التثبيت المضمّن" للمستخدمين تجربة عملية تثبيت سلسة للتطبيقات بدون مغادرة سياق التطبيق. ويمكن لمطوّري التطبيقات دمج ميزة "التثبيت المضمّن" واختبارها للتطبيقات التي يتم توزيعها أو تحديثها على Play.
المتطلبات
لكي تظهر واجهة "نصف الشاشة" في أحد التطبيقات، يجب استيفاء الشروط التالية:
- يجب أن يكون الحد الأدنى لإصدار Google Play هو 40.4.
- يجب أن يكون المستوى لواجهة برمجة التطبيقات في Android هو 23 أو أعلى.
طلب عمليات التثبيت المضمّنة من تطبيق
لاستدعاء نصف لوحة التثبيت المضمّنة من تطبيق، أنشئ مثيلًا لفئة
Intent
التي تفتح عنوان URL لرابط لصفحة في التطبيق. استخدِم نموذج الرمز البرمجي التالي (Kotlin أو Java) كدليل إرشادي.
Kotlin
val intent = Intent(Intent.ACTION_VIEW) val referrer = "<Your referrer string>" val id = "<Package name of the app that is to be installed>" val callerId = "<Package name of your app>" intent.setPackage("com.android.vending") val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id" intent.data = Uri.parse(deepLinkUrl) intent.putExtra("overlay", true) intent.putExtra("callerId", "$callerId") val packageManager = context.getPackageManager() if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, 0) } else { // Fallback to deep linking to full Play Store. }
Java
Intent intent = new Intent(Intent.ACTION_VIEW); String referrer = "<Your referrer string>"; String id = "<Package name of the app that is to be installed>"; String callerId = "<package name of your app>"; String csl_id = "<Custom store listing id>"; intent.setPackage("com.android.vending"); String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id; intent.setData(Uri.parse(deepLinkUrl)); intent.putExtra("overlay", true); intent.putExtra("callerId", callerId); PackageManager packageManager = context.getPackageManager(); if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, 0); } else { // Fallback to deep linking to full Play Store. }
مَعلمات واجهة برمجة التطبيقات للتثبيت المضمّن
الحقل | الوصف | مطلوب |
---|---|---|
referrer |
سلسلة تتبُّع المُحيل اختيارية | لا |
id |
اسم الحزمة للتطبيق المطلوب تثبيته | نعم |
overlay |
اضبط القيمة على true إذا تم طلب نصف لوحة مضمّنة. إذا كانت القيمة هي
false ، سيؤدي الإجراء إلى إنشاء روابط لصفحات في التطبيق تؤدي إلى Google Play. |
نعم |
callerId |
اسم حزمة تطبيق المتصل | نعم |
listing |
مَعلمة اختيارية لتحديد الاستهداف لبطاقة بيانات متجر مخصّصة | لا |
إذا لم تعرض عملية تثبيت التطبيق واجهة النصف صف تثبيت التطبيق المضمّن في Google Play، يتم بدلاً من ذلك عرض رابط مباشر (رابط لصفحة معيّنة) يؤدي إلى بطاقة بيانات التطبيق على Google Play.