Mengintegrasikan dialog penginstalan dalam aplikasi

Panduan ini menjelaskan cara mengintegrasikan dialog ajakan penginstalan dalam aplikasi di aplikasi Anda menggunakan Kotlin atau Java.

Menyiapkan lingkungan pengembangan

Library Prompts Penginstalan Dalam Aplikasi Play adalah bagian dari library Google Play Core. Untuk menggunakan library, sertakan dependensi Gradle berikut:

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

Menampilkan perintah penginstalan lintas perangkat

Tentukan momen terbaik dalam alur aplikasi Anda untuk meminta pengguna menginstal aplikasi Anda di perangkat lain (misalnya, saat mereka mentransmisikan video dari ponsel ke TV). Saat aplikasi Anda mencapai salah satu titik ini, lakukan langkah-langkah berikut:

  1. Buat CrossDevicePromptInstallationRequest.
  2. Gunakan CrossDevicePromptManager untuk membuat tugas permintaan yang menerima permintaan sebagai parameter.
  3. Gunakan objek CrossDevicePromptInfo yang dihasilkan dengan launchPromptFlow() untuk menampilkan perintah kepada pengguna.

Jika terjadi error saat mendapatkan CrossDevicePromptInfo atau menampilkan dialog, pengecualian akan ditampilkan.

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)
}

Untuk memverifikasi penerapan Anda, lihat Menguji dialog penginstalan dalam aplikasi.