In-App-Installationsaufforderungen einbinden

In diesem Leitfaden wird beschrieben, wie Sie In-App-Installationsaufforderungen in Ihre App einbinden. Sie können dazu entweder Kotlin oder Java verwenden.

Entwicklungsumgebung einrichten

Die Play In-App Install Prompts Library ist Teil der Google Play Core Bibliotheken. Wenn Sie die Bibliothek verwenden möchten, fügen Sie die folgende Gradle-Abhängigkeit hinzu:

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

Installationsaufforderung für die geräteübergreifende Installation anzeigen

Bestimmen Sie den besten Zeitpunkt im Ablauf Ihrer App, um den Nutzer aufzufordern, Ihre App auf einem anderen Gerät zu installieren. Das kann beispielsweise der Fall sein, wenn er ein Video von seinem Smartphone auf einen Fernseher überträgt. Wenn Ihre App einen dieser Punkte erreicht, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine CrossDevicePromptInstallationRequest.
  2. Verwenden Sie CrossDevicePromptManager, um eine Aufgabenanfrage zu erstellen, die die Anfrage als Parameter akzeptiert.
  3. Verwenden Sie das resultierende CrossDevicePromptInfo-Objekt mit launchPromptFlow(), um dem Nutzer die Aufforderung anzuzeigen.

Wenn beim Abrufen von CrossDevicePromptInfo oder beim Anzeigen der Aufforderung ein Fehler auftritt, wird eine Ausnahme ausgelöst.

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

Informationen zum Überprüfen Ihrer Implementierung finden Sie unter In-App-Installationsaufforderungen testen.