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

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

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

تُعدّ مكتبة Play In-App Install Prompts جزءًا من مكتبات Google Play الأساسية. لاستخدام المكتبة، يجب تضمين تبعية 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)
}

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