Integrowanie promptów w aplikacji

Z tego przewodnika dowiesz się, jak zintegrować w aplikacji prośby o instalację, używając języka Kotlin lub Java.

Konfigurowanie środowiska programistycznego

Biblioteka próśb o instalację w aplikacji w Google Play jest częścią podstawowych bibliotek Google Play. Aby używać biblioteki, dodaj tę zależność Gradle:

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

Wyświetlanie prompta instalacji na różnych urządzeniach

Określ najlepszy moment w ścieżce użytkownika, w którym można poprosić go o zainstalowanie aplikacji na innym urządzeniu (np. gdy przesyła film z telefonu na telewizor). Gdy aplikacja osiągnie jeden z tych punktów, wykonaj te czynności:

  1. Utwórz CrossDevicePromptInstallationRequest.
  2. Użyj CrossDevicePromptManager, aby utworzyć zadanie żądania, które akceptuje żądanie jako parametr.
  3. Użyj obiektu CrossDevicePromptInfo z funkcją launchPromptFlow(), aby wyświetlić użytkownikowi prompt.

Jeśli podczas uzyskiwania CrossDevicePromptInfo lub wyświetlania promptu wystąpi błąd, zostanie zgłoszony wyjątek.

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

Aby sprawdzić implementację, zapoznaj się z artykułem Testowanie promptów do instalacji w aplikacji.