Novos recursos na visualização do Android Studio

Esta página lista os novos recursos introduzidos nas versões de pré-lançamento do Android Studio. As versões de pré-lançamento oferecem acesso antecipado aos recursos e melhorias mais recentes do Android Studio. Você pode fazer o download dessas versões de prévia. Se você encontrar algum problema ao usar uma versão de pré-lançamento do Android Studio, informe-nos. Seus relatórios de bugs ajudam a melhorar o Android Studio.

As versões canário contêm recursos de ponta em desenvolvimento ativo e são testadas de forma leve. Embora seja possível usar builds canário para desenvolvimento, saiba que recursos podem ser adicionados ou alterados. Os candidatos a lançamento (RCs) são a próxima versão do Android Studio e estão quase prontos para lançamento estável. O conjunto de recursos para a próxima versão foi estabilizado. Consulte Nomes das versões do Android Studio para entender a nomenclatura das versões do Android Studio.

Para conferir as novidades mais recentes sobre as versões de prévia do Android Studio, incluindo uma lista de correções importantes em cada versão de prévia, consulte as Atualizações de versão no blog do Android Studio.

Versões atuais do Android Studio

A tabela a seguir lista as versões atuais do Android Studio e os respectivos canais.

Compatibilidade com prévias do Plug-in do Android para Gradle

Cada versão de pré-lançamento do Android Studio é publicada com uma versão correspondente do Plug-in do Android para Gradle (AGP). As versões de pré-lançamento do Studio devem funcionar com qualquer versão estável compatível do AGP. No entanto, se você estiver usando uma versão de pré-lançamento do AGP, use a versão de pré-lançamento correspondente do Studio (por exemplo, Android Studio Chipmunk Canary 7 com AGP 7.2.0-alpha07). As tentativas de usar versões divergentes (por exemplo, Android Studio Chipmunk Beta 1 com AGP 7.2.0-alpha07) vão causar uma falha de sincronização, o que vai resultar em uma solicitação para atualizar para a versão correspondente do AGP.

Para ver um registro detalhado das descontinuações e remoções da API do Plug-in do Android para Gradle, consulte as atualizações da API do Plug-in do Android para Gradle.

Studio Labs

Com o Studio Labs, você pode testar os recursos experimentais de IA mais recentes em uma versão estável do Android Studio. Assim, é possível integrar mais rapidamente nossas ofertas de assistência de IA ao seu fluxo de trabalho de desenvolvimento. Para mais informações, consulte Studio Labs.

Confira a seguir os recursos disponíveis no momento no Studio Labs.

Atualização de recursos do Android Studio Narwhal 3 | 2025.1.3

Confira a seguir os novos recursos da Atualização de recursos 3 do Android Studio Narwhal | 2025.1.3.

Para conferir o que foi corrigido nessa versão do Android Studio, consulte os problemas resolvidos.

Visualizações redimensionáveis do Compose

A visualização do Compose agora oferece suporte ao redimensionamento dinâmico para dar feedback visual instantâneo sobre como a interface se adapta a diferentes tamanhos de tela.

Para usar o recurso, entre no modo Foco na Visualização do Compose mudando a opção de visualização na barra de ferramentas:

Agora, é possível redimensionar a janela de visualização arrastando as bordas:

Ou use a barra de ferramentas de redimensionamento, que aparece depois que a visualização é redimensionada:

Se quiser salvar o novo tamanho como uma nova anotação Preview, use o menu do botão direito do mouse:

O recurso de redimensionamento dinâmico ajuda você a criar interfaces que ficam ótimas em qualquer tamanho de tela.

Configuração de visualização do Android para mostrar arquivos de build em módulos correspondentes

Há uma nova configuração para mostrar arquivos de build no módulo correspondente na visualização do Android. Essa visualização pode ser útil quando você trabalha em projetos com muitos módulos. Para ativar a visualização, abra o menu Opções disponível ao lado da visualização do Android. Em seguida, selecione Appearance > Display Build Files In Module.

Insights relacionados às políticas do Google Play no Android Studio

O Android Studio agora inclui insights e orientações mais detalhadas sobre as políticas do Google Play que podem afetar seu app. Essas informações ajudam você a criar apps mais seguros desde o início, evitando problemas que podem interromper o processo de lançamento e custar mais tempo e recursos para serem corrigidos depois.

A partir do Android Studio Narwhal 3 Feature Drop, é possível conferir os insights relacionados às políticas do Google Play como verificações de lint. Essas verificações de lint vão apresentar as seguintes informações:

• Uma visão geral da política.
• Diretrizes específicas para não cair em armadilhas comuns
• Links para as páginas de políticas do Google Play, onde você encontra a política formal completa e mais informações e recursos úteis.

O objetivo desse recurso é oferecer orientações úteis antes da análise para que você tenha experiências mais tranquilas de envio de apps. Ele não abrange todas as políticas nem fornece decisões finais sobre a análise de apps. Sempre consulte a política completa na Central de políticas para receber orientações. Também estamos trabalhando para aprimorar essa integração. Se você tiver algum feedback, envie uma denúncia.

Para saber se há insights de política do Google Play para seu projeto, acesse Código > Inspecionar insights de política do Google Play…. Os insights vão aparecer na janela de ferramentas "Problemas" e também como avisos do Lint nos arquivos correspondentes.

Testar e desenvolver com backup e restauração de apps

Garantir que o backup e restauração do Android funcione corretamente no seu app é fundamental para manter os usuários engajados com ele depois de mudar para um novo dispositivo ou restaurar da nuvem. No entanto, testar se o backup e a restauração de dados estão funcionando para seu app pode ser difícil.

O Android Studio Narwhal oferece maneiras de gerar um backup do seu app e restaurá-lo em outro dispositivo. Isso pode ser útil para testar se o app se comporta como esperado ao restaurar dados de um dispositivo para outro ou de um backup na nuvem, ou se você quer uma maneira mais rápida de configurar um dispositivo de teste com os dados necessários para desenvolver e depurar o app.

Gerar um backup

Para gerar um arquivo de backup, faça o seguinte:

1. Implantar uma versão de depuração do app em um dispositivo conectado
2. Use uma das seguintes ações para gerar um backup:
   • Na janela Dispositivo em execução, clique na ação Fazer backup dos dados do app na barra de ferramentas.
   • Selecione Run > Backup App Data na barra de menus principal.
   • Na guia Device Explorer > Processes, clique com o botão direito do mouse no processo do app e selecione Backup App Data.
3. Na caixa de diálogo exibida, faça o seguinte:
   • Confirme o ID do aplicativo para o qual você quer gerar um backup.
     • Selecione se você quer gerar um backup Dispositivo para dispositivo, Na nuvem ou Na nuvem (sem criptografia).
   • Confirme o nome e o local do backup que você quer salvar. Por padrão, o backup é salvo no diretório raiz do projeto atual do Android Studio.

     

4. Clique em Ok quando o Android Studio perguntar se pode interromper o app. Para gerar o backup, o Android Studio precisa interromper o processo do app.

É possível ver os backups gerados na janela de ferramentas Project > Android, no nó Backup Files.

Tipos de backup

É possível gerar diferentes tipos de backup para seu app. Ao gerar um backup, selecione o tipo que se relaciona ao cenário que você quer testar:

• De dispositivo para dispositivo:gera um backup do app, semelhante a um criado durante a transferência de dispositivo para dispositivo. Nas transferências de dispositivo para dispositivo, os dados de backup do app são enviados diretamente para outro dispositivo, por exemplo, por USB ou Wi-Fi.
• Cloud:gera um backup do app, semelhante a um salvo no armazenamento da Conta do Google do usuário. Ao configurar um novo dispositivo, o usuário pode escolher restaurar de um backup na nuvem.
• Cloud (sem criptografia): gera um backup do seu app, semelhante a um salvo no armazenamento da Conta do Google do usuário em um dispositivo sem criptografia do lado do cliente ativada.

Observação: ao usar o recurso para testar Cloud, Cloud (sem criptografia) ou Backups de dispositivo para dispositivo, o backup gerado não é enviado para o Cloud nem para outro dispositivo, ao contrário do fluxo de backup real. Ele gera o backup do seu app como se fosse ser salvo na nuvem ou enviado para outro dispositivo. Os backups gerados para qualquer tipo de backup podem estar em Arquivos de backup na janela de ferramentas Projeto > Android.

Restaurar dados do app

Para restaurar dados de apps, faça o seguinte:

1. Implante o app no dispositivo conectado. O app precisa ter o mesmo ID do aplicativo que o arquivo de backup que você quer restaurar no dispositivo.
2. Navegue até uma das seguintes ações e clique nela:
   • Na janela Running Device, clique na ação Restore App Data na barra de ferramentas e selecione um arquivo de backup no histórico recente ou clique em Procurar.
   • Navegue até Run > Restore App Data na barra de menus principal.
   • Na guia Device Explorer > Processes, clique com o botão direito do mouse no processo do app e selecione Restore App Data.
   • Na janela de ferramentas Project > Android, clique com o botão direito do mouse em um backup no nó Backup Files e selecione Restore App Data.
3. Se aplicável, selecione um backup no histórico recente ou clique em Procurar para selecionar um arquivo de backup a ser restaurado do armazenamento local.

Como alternativa, inclua um arquivo de backup como parte de uma configuração de execução para que a implantação do app também restaure os dados dele de um arquivo de backup. Para fazer isso, siga estas etapas:

1. Navegue até Run > Edit Configurations na barra de menus principal.
2. Selecione uma configuração de execução do app e navegue até Opções de restauração.

   

3. Para restaurar um app de um backup, marque a caixa ao lado de Restaurar estado do app.
4. Selecione um arquivo de backup no histórico recente ou procure e selecione o arquivo de backup no armazenamento local.
5. Se você quiser restaurar apenas os dados do app em uma nova instalação, marque a caixa ao lado de Restaurar apenas em uma nova instalação de APK. Essa opção pode ser útil se você estiver implantando em um novo dispositivo de teste e quiser restaurar dados para ajudar na depuração e no desenvolvimento de apps.
6. Clique em OK para salvar a configuração de execução.
7. Implante o app usando a configuração de execução para testar a restauração dos dados em um dispositivo conectado.

Inspeções do Proguard

O Android Studio agora inclui inspeções para evitar regras do ProGuard mal feitas ou que impedem as otimizações do R8. Regras de manutenção muito amplas, como -keep class **.*, e configurações de regras do ProGuard do consumidor, como dontshrink e -dontoptimize, agora acionam um aviso no ambiente de desenvolvimento integrado do Studio. Para criar uma boa regra de manutenção que permita a redução de código, defina o escopo da regra para um pacote específico e seja explícito sobre o que você quer manter.

Arquivos AGENT.md para contexto no nível do projeto

Agora você pode incluir arquivos AGENT.md no seu projeto. São arquivos Markdown que fornecem instruções específicas do projeto, regras de estilo de programação e outras orientações ao Gemini como contexto.

O Gemini descobre e aplica automaticamente instruções de qualquer arquivo chamado AGENT.md no seu projeto. Se um arquivo AGENT.md não estiver presente, o Gemini vai procurar um arquivo GEMINI.md como substituto.

Nova configuração para desativar a sincronização automática

Agora, o Android Studio oferece uma configuração para alternar do modo de sincronização automática padrão (por exemplo, a sincronização é executada automaticamente quando um projeto é aberto) para um novo modo de sincronização manual com lembretes. O comportamento padrão ainda é a sincronização automática. Para mudar para a sincronização manual, acesse File (Android Studio no macOS) > Settings > Build, Execution, Deployment > Build Tools e defina Project Sync mode como Manual Sync with reminders.

Recursos que estão saindo do Studio Labs

Os seguintes recursos experimentais dos Labs do Studio estão estáveis a partir do Narwhal 3 Feature Drop:

• Anexar imagens no Gemini
• @Contexto do arquivo no Gemini

Atualização de recursos do Android Studio Narwhal 4 | 2025.1.4

Confira a seguir os novos recursos da Atualização de recursos 4 do Android Studio Narwhal | 2025.1.4.

Para conferir o que foi corrigido nessa versão do Android Studio, consulte os problemas resolvidos.

Programas de aprendizado do Android Studio

O Journeys para Android Studio ajuda a facilitar a escrita e a manutenção de testes de ponta a ponta, permitindo que você use linguagem natural para descrever as etapas e declarações de cada teste, chamado de jornada. Ao aproveitar os recursos de visão e raciocínio do Gemini, as etapas escritas em linguagem natural são convertidas em ações que o Gemini realiza no seu app, facilitando a escrita e a compreensão das jornadas. Além disso, você pode escrever e descrever asserções mais complexas, que o Gemini avalia com base no que vê no dispositivo para determinar se as jornadas são aprovadas ou reprovadas.

Como o Gemini raciocina sobre quais ações realizar para atingir as metas, as jornadas são mais resilientes a mudanças sutis no layout ou comportamento do app, resultando em menos testes instáveis ao serem executados em diferentes versões do app e configurações de dispositivos.

Escreva e execute jornadas diretamente do Android Studio em qualquer dispositivo Android local ou remoto. O IDE oferece uma nova experiência de editor para criar jornadas, além de resultados avançados que ajudam você a entender melhor o raciocínio e a execução da sua jornada pelo Gemini.

Backup e sincronização

Agora é possível fazer backup das configurações do Android Studio no armazenamento em nuvem usando sua conta do Google ou da JetBrains. Isso ajuda a sincronizar suas configurações, como mapas de teclado, configurações do editor de código, configurações do sistema e muito mais. Para começar, faça o seguinte:

• Depois de abrir um projeto no Android Studio, faça login na sua Conta do Google clicando no avatar no canto superior direito do ambiente de desenvolvimento integrado e em Fazer login.

  

  1. Siga as instruções na caixa de diálogo que aparece e marque a caixa para autorizar o Android Studio a acessar o armazenamento da sua Conta do Google.
  2. Siga as instruções para autorizar o Android Studio.

• Acesse Configurações > Backup e sincronização.

  1. Selecione Google para usar o armazenamento da sua Conta do Google e sincronizar os dados do app em todas as instalações do Android Studio. Como alternativa, use uma conta JetBrains para sincronizar os dados do app nas instalações do IntelliJ e do Android Studio.
  2. Depois de seguir as instruções para autorizar o Android Studio a acessar o armazenamento da sua conta preferida, volte ao Android Studio.
  3. Na página Configurações > Backup e sincronização, você pode revisar as categorias de dados de apps que quer sincronizar com sua conta.
  4. Para desativar o Backup e sincronização, desmarque a caixa que ativa o recurso.

Se você já tiver dados sincronizados com o dispositivo selecionado, o Android Studio vai oferecer a opção de fazer o download das configurações do armazenamento remoto (essa é a opção padrão) ou fazer upload das configurações locais e substituir as configurações sincronizadas com o armazenamento remoto.

Correções sugeridas para falhas

No Android Studio Meerkat Feature Drop, lançamos insights do Gemini para falhas informadas na janela de ferramentas App Quality Insights. Agora, o Android Studio pode usar o Gemini para analisar os dados de falha com seu código-fonte e sugerir possíveis correções. Depois de selecionar uma falha na janela de ferramentas do App Quality Insights, navegue até a guia Insights e clique em Sugerir uma correção depois que o Gemini gerar um insight para a falha. Em seguida, o Gemini gera mudanças de código sugeridas que você pode revisar e aceitar em uma guia de diferenças do editor.

Nova configuração para abrir projetos com a visualização "Projeto"

Há uma nova configuração para que os novos projetos sejam abertos na visualização de projeto por padrão. Para ativar a configuração, acesse File (Android Studio no macOS) > Settings > Advanced Settings > Project View e selecione Set Project view as the default.

Ferramenta de teste de captura de tela da visualização do Compose

Use a ferramenta de teste de captura de tela da prévia do Compose para testar as UIs do Compose e evitar regressões. A nova ferramenta ajuda você a gerar relatórios HTML que permitem detectar visualmente mudanças na interface do seu app. Saiba mais em Teste de captura de tela na visualização do Compose.

Melhoria na árvore de componentes do Layout Inspector incorporado

Interagir com a árvore de componentes no Layout Inspector incorporado agora é mais intuitivo e eficiente graças a várias melhorias importantes. Essas atualizações foram criadas para simplificar seu fluxo de trabalho e fornecer insights mais claros sobre as estruturas da interface do Compose.

1. Rolagem horizontal: agora você pode rolar horizontalmente na árvore de componentes, facilitando a navegação e a inspeção de layouts amplos ou profundamente aninhados sem perder o contexto.
2. Rolagem automática na seleção: ao selecionar um item na árvore de componentes, a visualização rola automaticamente na horizontal e na vertical para focar no item selecionado. Isso garante que o elemento de seu interesse esteja sempre em destaque.
3. Visualização de relacionamento aprimorada: refinamos as linhas de suporte na árvore de componentes para oferecer indicadores visuais mais explícitos para entender as relações entre nós. As linhas pontilhadas agora indicam claramente uma relação de pilha de chamadas entre um nó pai e um filho, ajudando você a rastrear conexões programáticas de forma mais eficaz. As linhas contínuas continuam representando todas as outras relações padrão pai-filho na árvore.

Essas melhorias têm como objetivo oferecer uma experiência de depuração mais tranquila e eficiente, permitindo que você entenda e refine sua interface rapidamente.

Usar um LLM local

Com o Android Studio Narwhal 4 Feature Drop, você pode escolher o LLM que alimenta os recursos de IA do IDE.

O LLM precisa estar na sua máquina local, o que é vantajoso se você tiver conectividade limitada à Internet ou restrições quanto ao uso de modelos de IA, ou se quiser testar modelos de pesquisa de código aberto.

Um LLM local oferece uma alternativa ao suporte de LLM integrado ao Android Studio. No entanto, o Gemini no Android Studio geralmente oferece a melhor experiência de desenvolvimento em Android porque ele é ajustado para o Android e oferece suporte a todos os recursos do Android Studio. Com o Gemini, você pode escolher entre vários modelos para suas tarefas de desenvolvimento do Android, incluindo o modelo padrão sem custo financeiro ou modelos acessados com uma chave de API Gemini paga.

Para usar LLMs locais, é necessário instalar um provedor de LLM, como o LM Studio ou o Ollama, no computador local, além de um modelo compatível de sua escolha.

O assistente para upgrade de SDK do Android agora é compatível com o Android 16 / API 36

A migração do Android 15 / API 35 para o Android 16 / API 36 foi adicionada ao assistente para upgrade de SDK do Android. Para receber ajuda com a migração, acesse Tools > Android SDK Upgrade Assistant.

Plug-in do Android para Gradle 9.0

O Plug-in do Android para Gradle 9.0 é uma nova versão principal da AGP que traz mudanças de API e comportamento.

Para atualizar para o Plug-in do Android para Gradle 9.0.0-alpha02, use o Assistente de upgrade do Plug-in do Android para Gradle no Android Studio Narwhal 4 Feature Drop | 2025.1.4.

O assistente de upgrade do AGP ajuda a preservar os comportamentos atuais ao fazer upgrade do projeto quando apropriado. Assim, é possível fazer upgrade do projeto para usar o AGP 9.0, mesmo que você não esteja pronto para adotar todos os novos padrões do AGP 9.0.

Compatibilidade

O nível máximo da API Android compatível com o Plug-in do Android para Gradle 9.0.0-alpha02 é o nível 36.

O plug-in do Android para Gradle 9.0.0-alpha02 exige o Gradle 9.0.0.

Mudanças de comportamento

O Plug-in do Android para Gradle 9.0 tem os seguintes novos comportamentos:

A AGP 9.0 inclui atualizações nos padrões das seguintes propriedades do Gradle. Isso permite que você preserve o comportamento do AGP 8.13 ao fazer upgrade:

android {
  buildFeatures {
    shaders = true
  }
}

Recursos removidos

O Plug-in do Android para Gradle 9.0 remove as seguintes funcionalidades:

• Suporte a apps do Wear OS incorporados
  O AGP 9.0 remove o suporte à incorporação de apps do Wear OS, que não é mais compatível com o Google Play. Isso inclui a remoção das configurações de wearApp e da DSL AndroidSourceSet.wearAppConfigurationName. Consulte Distribuir para Wear OS para saber como publicar seu app no Wear OS.

DSL alterada

O Plug-in do Android para Gradle 9.0 tem as seguintes mudanças interruptivas na DSL:

• A parametrização de CommonExtension foi removida. Por si só, essa é apenas uma mudança incompatível no nível da origem para ajudar a evitar futuras mudanças incompatíveis no nível da origem, mas também significa que os métodos do bloco DSL precisam ser movidos de CommonExtension para ApplicationExtension, LibraryExension, DynamicFeatureExtension e TestExtension.

DSL removida

O Plug-in do Android para Gradle 9.0 remove:

• AndroidSourceSet.jni, porque não estava funcional.

• AndroidSourceSet.wearAppConfigurationName, já que está relacionado à remoção do suporte a apps do Wear OS incorporados.

• BuildType.isRenderscriptDebuggable, porque não estava funcional.

• ComponentBuilder.enabled, que foi substituído por ComponentBuilder.enable.

• Installation.installOptions(String). Ela foi substituída pela propriedade mutável de Installation.installOptions.

• VariantBuilder.targetSdk e targetSdkPreview, porque não eram significativos em bibliotecas. Use GeneratesApkBuilder.targetSdk ou GeneratesApkBuilder.targetSdkPreview em vez disso.

• O bloco experimental, mas nunca estabilizado, PostProcessing.

• ProductFlavor.setDimension, que é substituída pela propriedade dimension

• Variant.unitTest, já que não era aplicável ao plug-in com.android.test. unitTest está disponível nos subtipos VariantBuilder que estendem HasUnitTest.

• VariantBuilder.enableUnitTest, já que não era aplicável ao plug-in com.android.test. enableUnitTest está disponível nos subtipos VariantBuilder que estendem HasUnitTestBuilder.

• VariantBuilder.unitTestEnabled foi removido em favor de enableUnitTest, que tem um nome mais consistente, nos subtipos VariantBuilder que estendem HasUnitTestBuilder.

Propriedades do Gradle removidas

As seguintes propriedades do Gradle foram adicionadas inicialmente como formas de desativar globalmente recursos que estavam ativados por padrão.

Esses recursos foram desativados por padrão desde o AGP 8.0 ou versões anteriores. Ative esses recursos apenas nos subprojetos que os usam para uma build mais eficiente.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

APIs removidas

O Plug-in do Android para Gradle 9.0 remove:

• As APIs BaseExtension.registerTransform descontinuadas e desativadas, que permaneceram apenas para permitir a compilação com a versão mais recente do AGP enquanto visavam a execução no AGP 4.2 ou versões anteriores.

Propriedades do Gradle aplicadas

O AGP 9.0 gera um erro se você definir as seguintes propriedades do Gradle.

O Assistente de upgrade do Plug-in do Android para Gradle não vai fazer upgrade de projetos para o AGP 9.0 que usam essas propriedades.