Integrowanie promptów w aplikacji

Z tego przewodnika dowiesz się, jak zintegrować w aplikacji prośby o instalację w aplikacji za pomocą 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:

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

Tworzenie obiektu CrossDevicePromptManager

CrossDevicePromptManager to interfejs, który umożliwia aplikacji wysyłanie próśb o informacje i uruchamianie procesu wyświetlania prośby o instalację. Aby go uzyskać, utwórz instancję:

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

Przesyłanie żądania obiektu CrossDevicePromptInstallationRequest

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.

Jeśli zadanie się powiedzie, interfejs API zwróci obiekt CrossDevicePromptInfo w wywołaniu zwrotnym w przypadku powodzenia. W przeciwnym razie interfejs API zwraca wartość Exception w wywołaniu zwrotnym failure.

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

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