Integrar comandos de instalação no app

Este guia descreve como integrar solicitações de instalação no app usando Kotlin ou Java.

Configurar o ambiente de desenvolvimento

A biblioteca Play In-App Install Prompts faz parte das bibliotecas Google Play Core. Para usar a biblioteca, inclua a seguinte dependência do Gradle:

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

Mostrar o aviso de instalação em vários dispositivos

Determine o melhor momento no fluxo do app para pedir que o usuário instale o app em outro dispositivo (por exemplo, quando ele transmite um vídeo do smartphone para uma TV). Quando o app atingir um desses pontos, siga estas etapas:

  1. Crie um CrossDevicePromptInstallationRequest.
  2. Use o CrossDevicePromptManager para criar uma tarefa de solicitação que aceite a solicitação como um parâmetro.
  3. Use o objeto CrossDevicePromptInfo resultante com launchPromptFlow() para mostrar o prompt ao usuário.

Se ocorrer um erro ao obter o CrossDevicePromptInfo ou mostrar o aviso, uma exceção será gerada.

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

Para verificar sua implementação, consulte Testar solicitações de instalação no app.