Integrare i prompt di installazione in-app

Questa guida descrive come integrare i prompt di installazione in-app nella tua app utilizzando Kotlin o Java.

Configurazione dell'ambiente di sviluppo

La libreria Play In-App Install Prompts fa parte delle librerie di base Google Play. Per utilizzare la libreria, includi la seguente dipendenza Gradle:

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

Mostra il prompt di installazione cross-device

Determina il momento migliore nel flusso della tua app per chiedere all'utente di installare la tua app su un altro dispositivo (ad esempio, quando trasmette un video dallo smartphone alla TV). Quando la tua app raggiunge uno di questi punti, segui questi passaggi:

  1. Crea un CrossDevicePromptInstallationRequest.
  2. Utilizza CrossDevicePromptManager per creare un'attività di richiesta che accetti la richiesta come parametro.
  3. Utilizza l'oggetto CrossDevicePromptInfo risultante con launchPromptFlow() per mostrare il prompt all'utente.

Se si verifica un errore durante l'ottenimento di CrossDevicePromptInfo o la visualizzazione del prompt, viene generata un'eccezione.

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

Per verificare l'implementazione, consulta Testare i prompt di installazione in-app.