Notas da versão do SDK
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Aviso:o Google Play Instant não estará mais disponível. A partir de dezembro de 2025,
os apps instantâneos não poderão ser publicados no Google Play, e todas as
APIs Instant do Google Play Services
vão deixar de funcionar. Os usuários não vão mais receber apps instantâneos do Google Play usando nenhum
mecanismo.
Estamos fazendo essa mudança com base no feedback dos desenvolvedores e nos nossos investimentos contínuos para melhorar o ecossistema desde a introdução do Google Play Instant.
Para continuar otimizando o crescimento de usuários, recomendamos que os desenvolvedores encaminhem as pessoas para
o app ou jogo normal usando links diretos
para redirecionar a jornadas ou recursos específicos quando relevante.
SDK de desenvolvimento do Google Play Instant v1.9.0 (05-09-2019)
Esta versão do SDK de desenvolvimento do Google Play Instant inclui as seguintes
mudanças.
Mudanças
- A CLI de apps instantâneos agora será executada corretamente quando invocada por um link simbólico.
- Na versão anterior do SDK, a inicialização de um app com minSdkVersion < 24
e assinado apenas com o esquema v2 sempre causava um erro. Essa
mudança corrige o comando
ia run
e o comando de execução do Android Studio. Portanto, só ocorrerá um erro se a versão da API do dispositivo conectado for muito antiga e não oferecer compatibilidade com assinaturas v2.
SDK de desenvolvimento do Google Play Instant v1.8.0 (05-08-2019)
Esta versão do SDK de desenvolvimento do Google Play Instant inclui as seguintes
mudanças.
Mudanças
- O comando
ia run
da CLI de apps instantâneos pode implantar apps instantâneos assinados apenas com o esquema v2.
- O comando
ia run -u [url]
da CLI de apps instantâneos agora funciona sem implantar um artefato.
SDK de desenvolvimento do Google Play Instant v1.7.0 (29-03-2019)
Esta versão do SDK de desenvolvimento do Google Play Instant inclui as alterações e os novos recursos descritos a seguir.
Novos recursos
- A CLI de apps instantâneos agora pode coletar métricas de uso com seu consentimento, permitindo que a equipe de desenvolvedores do Google entenda melhor quais recursos você considera úteis e melhore as limitações de nossas ferramentas.
- O comando
ia check
agora aceita a verificação de incompatibilidades comuns do caminho de atualização em uma versão instalável do mesmo app. Você pode fornecer o APK do app instalável usando a opção -i
.
Mudanças
- O comando
ia run
da CLI de apps instantâneos não requer mais uma Conta do Google ativa no dispositivo para iniciar apps instantâneos no modo de desenvolvedor.
SDK de desenvolvimento do Google Play Instant v1.6.0 (05-11-2018)
Esta versão do SDK de desenvolvimento do Google Play Instant inclui as alterações e os novos recursos descritos a seguir.
Novos recursos
- O comando
ia check
da CLI de apps instantâneos agora oferece suporte à verificação de tamanho nos arquivos do conjunto APK (.apks
) gerados a partir de bundletool
.
Mudanças
- Em dispositivos com Android 8.0 (API de nível 26) ou versões posteriores, a execução de um app instantâneo cuja chave de assinatura não corresponda à chave de nenhum app iniciado anteriormente no dispositivo não causa mais uma falha no Android Studio ou na CLI.
- A limitação de tamanho de apps instantâneos mudou de 4 MB para 10 MB.
Um app com mais de 4 MB agora recebe um
WARNING
, em vez de um ERROR
. Um
app com mais de 10 MB continua recebendo um ERROR
.
SDK de desenvolvimento do Google Play Instant v1.5.0 (27-09-2018)
Esta versão do SDK de desenvolvimento do Google Play Instant inclui as alterações e os novos recursos descritos a seguir.
Novos recursos
- Os comandos
ia run
e ia check
da CLI de apps instantâneos agora são compatíveis com a operação em arquivos de um conjunto de APKs (.apks) gerados por bundletool
.
- O comando
ia check
da CLI de apps instantâneos agora funciona com uma lista de APKs.
- O comando
ia check
da CLI de apps instantâneos garante que os nomes de APKs divididos sejam exclusivos em um arquivo ZIP específico.
Mudanças
- Ao provisionar um dispositivo com o Android 7.1.1 (API de nível 25) ou versões anteriores, a CLI só emite um aviso se não consegue detectar um check-in realizado no Google Play Services. Quando encontrava essa situação anteriormente, a CLI emitia um erro e não tentava iniciar o app instantâneo.
- O comando
ia run
da CLI de apps instantâneos agora inicializa APKs gerados por bundletool
ou APKs criados usando aapt2
. Anteriormente, a operação run
parecia expirar quando alguns desses APKs eram inicializados.
- A sinalização
--no-setup
foi suspensa para ia run
e agora não tem nenhum efeito.
- Versões mais antigas do Google Play Services são atualizadas adequadamente para o Instant Apps, que precisa ser desinstalado antes da instalação de uma nova versão.
SDK de desenvolvimento do Google Play Instant v1.4.0 (28-08-2018)
Essa versão do SDK de desenvolvimento do Google Play Instant (anteriormente SDK de desenvolvimento do Instant Apps) inclui as alterações e os novos recursos descritos a seguir.
Novos recursos
- O comando
ia check
da CLI de apps instantâneos agora é compatível com a validação de tamanho em apps instantâneos que usam APKs de configuração.
- A CLI agora é compatível com a execução de apps instantâneos em imagens do emulador de chaves de teste com uma versão recente do Google Play Services instalada.
- Compatibilidade aprimorada para a ajuda específica de comando com
ia help <command>
.
- Inclusão de detalhamento de tamanho a erros de tamanho
ia check
.
Mudanças
- O SDK foi renomeado de "SDK de desenvolvimento do Instant Apps Android" para "SDK de desenvolvimento do Google Play Instant".
- A CLI não gera mais uma
NullPointerException
ao tentar verificar um app
sem atividade na tela de início.
- A CLI e o Android Studio agora detectam dispositivos não compatíveis com o Android 8.0 (API de nível 26). Anteriormente, esses dispositivos não iniciavam o app.
- O script do wrapper Bash
ia
agora funciona corretamente quando invocado em um pipeline
em que $TERM
não esteja definido. O script assume uma largura de 80 colunas.
- O comando
ia check
agora avisa sobre apps instantâneos cuja versão minSdkVersion
esteja definida como 20
ou anterior. Ao oferecer compatibilidade com essas versões mais antigas do SDK no seu build, o tamanho do binário pode aumentar sem nenhum benefício para os apps instantâneos.
- A CLI agora detecta quando sua versão do Google Play Services é muito antiga para
executar apps instantâneos e solicita uma atualização do dispositivo.
- Os apps instantâneos iniciados no Android 8.0 (API de nível 26) e versões anteriores por meio da CLI ou do Android Studio agora recebem automaticamente a permissão
android.permission.INSTANT_APP_FOREGROUND_SERVICE
.
SDK de desenvolvimento do Instant Apps Android v1.3.0 (04-06-2018)
Esta versão do SDK de desenvolvimento do Instant Apps Android
inclui as mudanças e os novos recursos descritos a seguir.
Novos recursos
- O Android Studio 3.2 agora usa uma biblioteca adicionada no SDK 1.3 para executar apps instantâneos.
Isso unifica a lógica entre o
ia
e o Studio e permite executar apps instantâneos sem URLs no Android Studio.
SDK de desenvolvimento do Instant Apps Android v1.2.0 (07-05-2018)
Esta versão do SDK de desenvolvimento do Instant Apps Android
inclui as mudanças e os novos recursos descritos a seguir.
Novos recursos
- A nova interface de linha de comando do Instant Apps,
ia
, permite iniciar apps instantâneos no seu dispositivo de desenvolvimento e procurar localmente por erros comuns.
- Agora você pode criar e iniciar apps instantâneos sem um ponto de entrada de URL.
Mudanças
- A versão do Google Play Services para o Instant Apps que acompanha o SDK agora pode ser atualizada automaticamente na Play Store. Nas versões anteriores, esse pacote era bloqueado para a versão que acompanhava o SDK.
- Nomes de host que contêm caracteres curinga, como
"*.example.com"
, agora são totalmente compatíveis com o modo de desenvolvedor.
- Os desenvolvedores agora podem simular downloads de apps limitados no Android Lollipop,
Marshmallow e Nougat configurando a propriedade
debug.aia.throttle_download_ms
do sistema, conforme mostrado no exemplo a seguir:
$ adb shell setprop debug.aia.throttle_download_ms 5000
SDK de desenvolvimento do Instant Apps Android v1.1.0
Esta versão do SDK de desenvolvimento do Instant Apps Android inclui as alterações e os novos recursos descritos a seguir.
Novos recursos
- Transferência de dados do Instant App para o app instalado.
- Nos dispositivos com Android 8.0 (API de nível 26) e versões mais recentes, o sistema executa automaticamente essa transferência durante a instalação do app. Nos dispositivos com Android 7.1 (API de nível 25) e versões anteriores, você pode transferir seus dados de armazenamento do Instant App para seus apps instalados chamando
getInstantAppData()
no app instalado.
- Você pode diminuir o tamanho do seu APK usando a nova compatibilidade com APKs específicos do dispositivo. Para mais informações sobre como configurar a versão de APKs de configuração, consulte Configurar sua versão para APKs de configuração.
Mudanças
- Emulador.
- Emuladores que executam a Play Store e o Google Play Services mais recente precisam testar o Instant Apps daqui em diante. Para mais informações sobre como configurar seu emulador, consulte Executar seu app instantâneo.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# SDK release notes\n\n**Warning:** Google Play Instant will no longer be available. Starting December 2025,\nInstant Apps cannot be published through Google Play, and all\n[Google Play services Instant APIs](https://developers.google.com/android/reference/com/google/android/gms/instantapps/package-summary)\nwill no longer work. Users will no longer be served Instant Apps by Play using any\nmechanism.\n\nWe're making this change based on developer feedback and our continuous investments\nto improve the ecosystem since the introduction of Google Play Instant.\n\nTo continue optimizing for user growth, we encourage developers to refer users to\ntheir regular app or game, using [deeplinks](https://support.google.com/googleplay/android-developer/answer/12463044)\nto redirect them to specific journeys or features when relevant.\n\nGoogle Play Instant Development SDK v1.9.0 (2019-09-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nchanges.\n\n### Changes\n\n- The instant apps CLI will now run properly when invoked through a symbolic link.\n- In the previous version of the SDK, launching an app with minSdkVersion \\\u003c 24 and signed only with the v2 signature scheme would always cause an error. This change fixes both `ia run` and Android Studio's run command so that an error will only occur if the connected device's API version is too old to support v2 signatures.\n\nGoogle Play Instant Development SDK v1.8.0 (2019-08-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nchanges.\n\n### Changes\n\n- The instant apps CLI `ia run` command can deploy instant apps that are only signed using a v2 signature scheme.\n- The instant apps CLI `ia run -u [url]` command now works without deploying an artifact.\n\nGoogle Play Instant Development SDK v1.7.0 (2019-03-29)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI can now collect usage metrics with your consent, allowing Google's developer team to better understand what features you find useful and improve shortcomings in our tooling.\n- The `ia check` command now supports checking against an installable build of the same app for common upgrade path incompatibilities. You can provide the installable app APK using the `-i` option.\n\n### Changes\n\n- The instant apps CLI `ia run` command no longer requires an active Google account on the device to launch instant apps in development mode.\n\nGoogle Play Instant Development SDK v1.6.0 (2018-11-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI `ia check` command now supports size checking on APK set files (`.apks`) generated from [`bundletool`](/studio/command-line/bundletool#generate_apks).\n\n### Changes\n\n- On devices running Android 8.0 (API level 26) or higher, running an instant app whose signing key doesn't match the key from any previously-launched app on the device no longer causes a crash in Android Studio or the CLI.\n- Changed the size limitation of instant apps from 4 MB to 10 MB. An app larger than 4 MB now receives a `WARNING` instead of an `ERROR`. An app larger than 10 MB continues to receive an `ERROR`.\n\nGoogle Play Instant Development SDK v1.5.0 (2018-09-27)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI `ia run` and `ia check` commands now support operating on APK set (.apks) files generated by [`bundletool`](/studio/command-line/bundletool#generate_apks).\n- The instant apps CLI `ia check` command now works with a list of APKs.\n- The instant apps CLI `ia check` command ensures that names of split APKs are unique within a given ZIP file.\n\n### Changes\n\n- When provisioning a device running Android 7.1.1 (API level 25) or lower, the CLI issues a warning only if it fails to detect a successful Google Play services check-in. When encountering this situation previously, the CLI would throw an error and not attempt to launch the instant app.\n- The instant apps CLI `ia run` can now successfully launch APKs generated by `bundletool` or APKs built using `aapt2`. Previously, the `run` operation might have appeared to time out when launching some of these APKs.\n- The `--no-setup` flag has been deprecated for `ia run` and now has no effect.\n- Properly updates older versions of Google Play services for Instant Apps, which need to be uninstalled first before installing a new version.\n\nGoogle Play Instant Development SDK v1.4.0 (2018-08-28)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK (formerly Instant Apps\nDevelopment SDK) contains the following new features and changes.\n\n### New features\n\n- The instant apps CLI `ia check` command now supports size validation on instant apps using configuration APKs.\n- The CLI now supports running instant apps on test-keys emulator images with a recent version of Google Play services installed.\n- Improved support for command-specific help with `ia help \u003ccommand\u003e`.\n- Added size breakdown to `ia check` size errors.\n\n### Changes\n\n- The SDK has been renamed from \"Android Instant Apps Development SDK\" to \"Google Play Instant Development SDK\".\n- The CLI no longer throws a `NullPointerException` when trying to check an app with no launcher activity.\n- The CLI and Android Studio now detect unsupported devices running Android 8.0 (API level 26). Previously, these devices wouldn't launch the app.\n- The `ia` Bash wrapper script now works correctly when invoked in a pipeline where `$TERM` isn't set. The script assumes a width of 80 columns.\n- The `ia check` command now warns about instant apps whose `minSdkVersion` version is set to `20` or lower. By supporting these older SDK versions in your build, your binary's size might increase with no benefit for your instant apps.\n- The CLI now detects when your version of Google Play services is too old to run instant apps and prompts for an update on the device.\n- Instant apps launched on Android 8.0 (API level 26) and higher through the CLI or Android Studio now automatically have the `android.permission.INSTANT_APP_FOREGROUND_SERVICE` permission granted.\n\nAndroid Instant Apps Development SDK v1.3.0 (2018-06-04)\n--------------------------------------------------------\n\nThis release of the Android Instant Apps Development SDK\ncontains the following new features and changes.\n\n### New features\n\n- Android Studio 3.2 now uses a library added in SDK 1.3 to run instant apps. This unifies the logic between `ia` and Studio and allows you to run instant apps without URLs from Android Studio.\n\nAndroid Instant Apps Development SDK v1.2.0 (2018-05-07)\n--------------------------------------------------------\n\nThis release of the Android Instant Apps Development SDK\ncontains the following new features and changes.\n\n### New features\n\n- The new Instant Apps Command Line Interface, `ia`, allows you to launch instant apps on your development device and check them locally for common errors.\n- You can now build and launch instant apps [without a URL entry\n point](/topic/google-play-instant/getting-started/convert-to-instant-app#enable-try-now).\n\n### Changes\n\n- The version of Google Play Services for Instant Apps that's bundled with the SDK can now auto-update itself using the Play Store. In previous releases, that package was locked to the version bundled with the SDK.\n- Hostnames containing wildcard characters, such as `\"*.example.com\"`, are now fully supported in development mode.\n- Developers can now simulate throttled app downloads in Android Lollipop, Marshmallow, and Nougat by setting the `debug.aia.throttle_download_ms` system property, as shown in the following example: \n\n ```\n $ adb shell setprop debug.aia.throttle_download_ms 5000\n ```\n\nAndroid Instant Apps Development SDK v1.1.0\n-------------------------------------------\n\nThis release of the Android Instant Apps Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- Transfer of data from Instant App to installed app.\n - On devices running Android 8.0 (API level 26) and above, the system automatically performs this transfer on app installation. On devices running Android 7.1 (API level 25) and lower, you can transfer your Instant App's storage data to your installed app by calling [`getInstantAppData()`](https://developers.google.com/android/reference/com/google/android/gms/instantapps/InstantAppsClient.html#getInstantAppData()) in your installed app.\n- You can decrease the size of your APK by using the new support for device-specific APKs. For information on setting up your build for configuration APKs, see [Set up your build for configuration APKs](/topic/google-play-instant/guides/config-splits).\n\n### Changes\n\n- Emulator.\n - Emulators running Play Store and the latest Google Play Services are required to test Instant Apps moving forward. For information about how to set up your emulator, see [Run your instant\n app](/topic/google-play-instant/getting-started/first-instant-app#run)."]]