На этой странице описывается, как разработчики приложений могут интегрировать встроенную установку — новую тестовую функцию Google Play, которая представляет сведения о продуктах приложений Google Play в интерфейсе на пол-листа. Встроенная установка позволяет пользователям осуществлять плавную установку приложения, не выходя из контекста приложения. Разработчики приложений могут интегрировать и протестировать функцию встроенной установки для распространяемых или обновленных приложений Play.
Требования
Чтобы интерфейс половины листа появился в приложении:
- Минимальная версия Google Play должна быть 40.4 .
- Уровень Android API должен быть 23 или выше .
Вызов встроенных установок из приложения
Чтобы вызвать встроенную половину листа установки из приложения, создайте экземпляр класса 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. }
Ява
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.