На этой странице описывается, как разработчики приложений могут интегрировать встроенную установку — новую функцию тестирования для Google Play, которая отображает подробную информацию о продукте Google Play в виде небольшого окна. Встроенная установка позволяет пользователям пройти беспрепятственный процесс установки приложения, не покидая его контекст. Разработчики приложений могут интегрировать и тестировать функцию встроенной установки для приложений, распространяемых или обновляемых через Play.
Требования
Чтобы в приложении отображался интерфейс в виде половины листа:
- Минимальная версия Google Play должна быть 40.4 .
- Уровень API Android должен быть 24 или выше .
Выполнение встроенных установок из приложения
Чтобы вызвать встроенную функцию установки приложения, создайте экземпляр класса Intent , который открывает URL-адрес прямой ссылки. Используйте следующий пример кода (Kotlin или Java) в качестве ориентира.
Котлин
val intent = Intent(Intent.ACTION_VIEW) val referrer = "<Your referrer string>" val id = "<Package name of the app that is to be installed>" val callerId = "<Package name of your app>" intent.setPackage("com.android.vending") val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id" intent.data = Uri.parse(deepLinkUrl) intent.putExtra("overlay", true) intent.putExtra("callerId", "$callerId") val packageManager = context.getPackageManager() if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, 0) } else { // Fallback to deep linking to full Play Store. }
Java
Intent intent = new Intent(Intent.ACTION_VIEW); String referrer = "<Your referrer string>"; String id = "<Package name of the app that is to be installed>"; String callerId = "<package name of your app>"; String csl_id = "<Custom store listing id>"; intent.setPackage("com.android.vending"); String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id; intent.setData(Uri.parse(deepLinkUrl)); intent.putExtra("overlay", true); intent.putExtra("callerId", callerId); PackageManager packageManager = context.getPackageManager(); if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, 0); } else { // Fallback to deep linking to full Play Store. }
Параметры API для встроенной установки
| Поле | Описание | Необходимый |
|---|---|---|
referrer | Необязательная строка отслеживания источника перехода . | Нет |
id | Название пакета приложения для установки | Да |
overlay | Установите значение true , если запрашивается встроенный полуэкран; если false , намерение создает прямую ссылку на Google Play. | Да |
callerId | Название пакета вызывающего приложения | Да |
listing | Необязательный параметр для указания целевого объекта для пользовательского списка товаров в магазине. | Нет |
Если в процессе установки приложения не отображается встроенный интерфейс установки из Google Play, вместо него показывается прямая (глубокая) ссылка на страницу приложения в Google Play.