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 dans le parcours de votre application pour inviter l'utilisateur à installer votre application sur un autre appareil (par exemple, lorsqu'il caste une vidéo depuis son téléphone vers 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.