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

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

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

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

// In your app's build.gradle.kts file:
...
dependencies {
    implementation("com.google.android.play:crossdeviceprompt:0.0.1")
    ...
}

عرض طلب التثبيت على أجهزة متعددة

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

  1. أنشئ CrossDevicePromptInstallationRequest.
  2. استخدِم CrossDevicePromptManager لإنشاء مهمة طلب تقبل الطلب كمَعلمة.
  3. استخدِم كائن CrossDevicePromptInfo الناتج مع launchPromptFlow() لعرض الطلب على المستخدم.

إذا حدث خطأ أثناء الحصول على CrossDevicePromptInfo أو عرض الطلب، سيتم طرح استثناء.

val crossDevicePromptManager = CrossDevicePromptManagerFactory.create(activity)
val request = CrossDevicePromptInstallationRequest.create()

try {
    val info = crossDevicePromptManager.requestInstallationPromptFlow(request).await()
    crossDevicePromptManager.launchPromptFlow(activity, info).await()
} catch (e: CrossDevicePromptException) {
    Log.e(TAG, "Cross-device prompt failed with error: ${e.errorCode}", e)
}

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