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 dei prompt di installazione in-app di Play fa parte delle librerie Google Play Core. 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")
    ...
}

Mostrare 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 a una TV). Quando la tua app raggiunge uno di questi punti, esegui i seguenti 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.