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 multi-appareil

Déterminez le meilleur moment du parcours utilisateur dans votre application pour inviter l'utilisateur à installer votre application 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 élément CrossDevicePromptInstallationRequest.
  2. Utilisez CrossDevicePromptManager pour créer une tâche de requête 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.