Esta página descreve como os desenvolvedores de apps podem integrar a instalação inline, um novo recurso de teste do Google Play que apresenta os detalhes do produto do app do Google Play em uma interface de meia página. A instalação inline permite que os usuários tenham uma experiência de instalação do app sem sair do contexto do app. Os desenvolvedores de apps podem integrar e testar o recurso de instalação inline para apps distribuídos ou atualizados no Google Play.
Requisitos
Para que a interface de meia página apareça em um app:
- A versão mínima do Google Play precisa ser a 40.4.
- O nível da API do Android precisa ser 23 ou mais recente.
Invocar instalações inline de um app
Para invocar a metade da página de instalação inline de um app, crie uma instância da classe
Intent
, que abre um URL de link direto. Use o exemplo de código abaixo (Kotlin ou Java) como orientação.
Kotlin
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. }
Parâmetros da API de instalação inline
Campo | Descrição | Obrigatório |
---|---|---|
referrer |
Uma string de rastreamento de referenciador opcional | Não |
id |
O nome do pacote do app a ser instalado | Sim |
overlay |
Definido como true se a meia página inline for solicitada. Se
false , os links diretos da intent vão direcionar ao Google Play. |
Sim |
callerId |
O nome do pacote do app autor da chamada | Sim |
listing |
Um parâmetro opcional para especificar o destino de uma lista de app personalizada | Não |
Se o fluxo de instalação do app não mostrar a interface de meia página de instalação inline do Google Play, um link direto (link direto) para a página "Detalhes do app" do Google Play será mostrado.