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 de Solicitações de Instalação no App do Google Play 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 solicitar que o usuário o instale em outro dispositivo (por exemplo, quando ele transmitir um vídeo do smartphone para uma TV). Quando o app atingir um desses pontos, siga estas etapas:

  1. Crie um CrossDevicePromptInstallationRequest.
  2. Use 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 a solicitação ao usuário.

Se ocorrer um erro ao receber o CrossDevicePromptInfo ou ao mostrar a solicitação, 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.