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.

Nota :solo i partner con accesso in anteprima possono visualizzare i prompt di installazione in-app. Scopri di più sulla partecipazione al programma di accesso in anteprima.

Configura l'ambiente di sviluppo

La libreria dei prompt di installazione in-app di Play fa parte delle librerie di base Google Play. Per utilizzare la libreria, includi la seguente dipendenza Gradle:

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:crossdeviceprompt:0.0.1-eap01'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:crossdeviceprompt:0.0.1-eap01")
    ...
}

Crea CrossDevicePromptManager

CrossDevicePromptManager è l'interfaccia che consente alla tua app di richiedere informazioni e avviare il flusso di richiesta di installazione. Crea un'istanza per ottenerlo:

Kotlin

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest

...

val crossDevicePromptManager: CrossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context)

Java

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory;
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest;

...

CrossDevicePromptManager crossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context);

Richiedi un oggetto CrossDevicePromptInstallationRequest

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.

Se l'attività ha esito positivo, l'API restituisce l'oggetto CrossDevicePromptInfo nel callback di successo. In caso contrario, l'API restituisce un Exception nel callback di errore.

Kotlin

val request: CrossDevicePromptInstallationRequest? =
    CrossDevicePromptInstallationRequest.create()
val result: Task<CrossDevicePromptInfo?> =
    crossDevicePromptManager.requestInstallationPromptFlow(request)

result.addOnSuccessListener { crossDevicePromptInfo ->
    // Requested a prompt flow successfully
}

result.addOnFailureListener { e ->
    // Failed to request a prompt flow
}

Java

CrossDevicePromptInstallationRequest request =
    CrossDevicePromptInstallationRequest.create();
Task<CrossDevicePromptInfo> result =
    crossDevicePromptManager.requestInstallationPromptFlow(request);

result.addOnSuccessListener(crossDevicePromptInfo -> {
    // Requested a prompt flow successfully
});

result.addOnFailureListener(e -> {
    // Failed to request a prompt flow
});

Importante: se si verifica un errore durante il flusso del prompt di installazione in-app, non informare l'utente o modificare il normale flusso dell'app. Continua il normale flusso della tua app dopo la chiamata di onComplete.

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