Встроить подсказки при установке приложения.

В этом руководстве описано, как интегрировать подсказки по установке приложения в ваше приложение, используя Kotlin или Java.

Настройте среду разработки.

Библиотека подсказок для установки приложений в Play Store является частью основных библиотек Google Play . Для использования библиотеки добавьте следующую зависимость Gradle:

Классный 

// 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'
    ...
}

Котлин 

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

Создайте объект CrossDevicePromptManager.

CrossDevicePromptManager — это интерфейс, позволяющий вашему приложению запрашивать информацию и запускать процесс запроса на установку. Создайте экземпляр, чтобы получить его:

Котлин 

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

Запросить объект CrossDevicePromptInstallationRequest

Определите наиболее подходящий момент в работе вашего приложения, чтобы предложить пользователю установить его на другое устройство (например, когда он транслирует видео со своего телефона на телевизор). Когда ваше приложение достигнет одной из этих точек, выполните следующие шаги:

  1. Создайте запрос на CrossDevicePromptInstallationRequest .
  2. Используйте CrossDevicePromptManager для создания задачи запроса, которая принимает запрос в качестве параметра.

Если задача выполнена успешно, API возвращает объект CrossDevicePromptInfo в функции обратного вызова при успешном выполнении. В противном случае API возвращает Exception в функции обратного вызова при ошибке.

Котлин 

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

Для проверки правильности реализации см. раздел «Тестирование подсказок при установке приложения» .