Intégrer des invites d'installation dans l'application

Ce guide explique comment intégrer des invites d'installation dans votre application à l'aide de Kotlin ou de Java.

Configurer l'environnement de développement

La bibliothèque Play In-App Install Prompts fait partie des bibliothèques Google Play Core. Pour utiliser la bibliothèque, incluez la dépendance Gradle suivante :

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

Afficher l'invite d'installation sur plusieurs appareils

Déterminez le meilleur moment dans le flux de votre application pour inviter l'utilisateur à l'installer sur un autre appareil (par exemple, lorsqu'il diffuse une vidéo de son téléphone sur un téléviseur). Lorsque votre application atteint l'un de ces points, procédez comme suit :

  1. Créez un CrossDevicePromptInstallationRequest.
  2. Utilisez le CrossDevicePromptManager pour créer une tâche de demande qui accepte la requête en tant que paramètre.
  3. Utilisez l'objet CrossDevicePromptInfo obtenu avec launchPromptFlow() pour afficher l'invite à l'utilisateur.

Si une erreur se produit lors de l'obtention de CrossDevicePromptInfo ou de l'affichage de l'invite, une exception est générée.

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

Pour vérifier votre implémentation, consultez Tester les invites d'installation dans l'application.