دمج طلبات التثبيت داخل التطبيق

يوضّح هذا الدليل كيفية دمج طلبات التثبيت داخل التطبيق باستخدام Kotlin أو Java.

ملاحظة: يمكن للشركاء المشاركين في برنامج "استخدام المنتج قبل إطلاقه" فقط عرض طلبات التثبيت داخل التطبيق. مزيد من المعلومات حول المشاركة في برنامج استخدام الميزات قبل إطلاقها

إعداد بيئة التطوير

تُعدّ مكتبة "طلبات التثبيت داخل التطبيق على Play" جزءًا من مكتبات Google Play Core. لاستخدام المكتبة، أدرِج تبعية Gradle التالية:

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:crossdeviceprompt:0.0.1-eap01'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:crossdeviceprompt:0.0.1-eap01")
    ...
}

إنشاء CrossDevicePromptManager

‫CrossDevicePromptManager هي الواجهة التي تتيح لتطبيقك طلب المعلومات وبدء عملية عرض طلب التثبيت. أنشئ مثيلاً للحصول عليه:

Kotlin

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest

...

val crossDevicePromptManager: CrossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context)

Java

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory;
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest;

...

CrossDevicePromptManager crossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context);

طلب عنصر CrossDevicePromptInstallationRequest

حدِّد أفضل لحظة في مسار تطبيقك لطلب تثبيت تطبيقك على جهاز آخر من المستخدم (على سبيل المثال، عندما يبث المستخدم فيديو من هاتفه إلى التلفزيون). عندما يصل تطبيقك إلى إحدى هذه النقاط، اتّبِع الخطوات التالية:

1. أنشئ CrossDevicePromptInstallationRequest.
2. استخدِم CrossDevicePromptManager لإنشاء مهمة طلب تقبل الطلب كمَعلمة.

في حال نجاح المهمة، تعرض واجهة برمجة التطبيقات العنصر CrossDevicePromptInfo في دالة معاودة الاتصال الخاصة بالنجاح. بخلاف ذلك، تعرض واجهة برمجة التطبيقات Exception في دالة معاودة الاتصال الخاصة بالخطأ.

Kotlin

val request: CrossDevicePromptInstallationRequest? =
    CrossDevicePromptInstallationRequest.create()
val result: Task<CrossDevicePromptInfo?> =
    crossDevicePromptManager.requestInstallationPromptFlow(request)

result.addOnSuccessListener { crossDevicePromptInfo ->
    // Requested a prompt flow successfully
}

result.addOnFailureListener { e ->
    // Failed to request a prompt flow
}

Java

CrossDevicePromptInstallationRequest request =
    CrossDevicePromptInstallationRequest.create();
Task<CrossDevicePromptInfo> result =
    crossDevicePromptManager.requestInstallationPromptFlow(request);

result.addOnSuccessListener(crossDevicePromptInfo -> {
    // Requested a prompt flow successfully
});

result.addOnFailureListener(e -> {
    // Failed to request a prompt flow
});

ملاحظة مهمة: إذا حدث خطأ أثناء مسار طلب التثبيت داخل التطبيق، لا تُعلم المستخدم بذلك أو تغيّر المسار العادي لتطبيقك. واصِل مسار تطبيقك العادي بعد استدعاء onComplete.

للتحقّق من صحة التنفيذ، اطّلِع على اختبار طلبات التثبيت داخل التطبيق.