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:

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

Membuat CrossDevicePromptManager

CrossDevicePromptManager adalah antarmuka yang memungkinkan aplikasi Anda meminta informasi dan meluncurkan alur dialog penginstalan. Buat instance untuk mendapatkannya:

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

Meminta objek CrossDevicePromptInstallationRequest

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 momen tersebut, lakukan langkah-langkah berikut:

  1. Buat CrossDevicePromptInstallationRequest.
  2. Gunakan CrossDevicePromptManager untuk membuat tugas permintaan yang menerima permintaan sebagai parameter.

Jika tugas berhasil, API akan menampilkan objek CrossDevicePromptInfo dalam callback keberhasilan. Jika tidak, API akan menampilkan Exception dalam callback kegagalan.

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

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