O Android Studio é o ambiente de desenvolvimento integrado oficial para o Android e conta com tudo o que você precisa para criar apps desse sistema.
Esta página lista novos recursos e melhorias da versão mais recente no Canal estável, o Android Studio Narwhal 3 Feature Drop. Você pode fazer o download neste link ou atualizar no Android Studio clicando em Help > Check for updates. No macOS, clique em Android Studio > Check for updates.
Esta é uma versão estável do Android Studio. Os patches podem conter novos recursos secundários e correções de bugs. Consulte Nomes das versões do Android Studio para entender a nomenclatura das versões do Android Studio.
Para conferir o que foi corrigido nessa versão do Android Studio, consulte os problemas fechados.
As notas de versões mais antigas do Android Studio estão disponíveis no artigo Versões anteriores.
Para ter acesso antecipado a recursos e melhorias futuras, consulte as versões de pré-lançamento do Android Studio.
Se você encontrar problemas no Android Studio, consulte a página Problemas conhecidos ou Resolver problemas.
Plug-in do Android para Gradle e compatibilidade com o Android Studio
O sistema de build do Android Studio é baseado no Gradle, e o Plug-in do Android para Gradle (AGP, na sigla em inglês) adiciona vários recursos específicos para a criação de apps Android. A tabela abaixo lista qual versão do AGP é necessária para cada versão do Android Studio.
Versão do Android Studio | Versão necessária do AGP |
---|---|
Atualização de recursos do Narwhal 3 | 2025.1.3 | 4.0-8.13 |
Atualização de recursos do Narwhal | 2025.1.2 | 4.0-8.12 |
Narwhal | 2025.1.1 | 3.2-8.11 |
Atualização do Meerkat | 2024.3.2 | 3.2-8.10 |
Meerkat | 2024.3.1 | 3.2-8.9 |
Atualização de recursos do Ladybug | 2024.2.2 | 3.2-8.8 |
Ladybug | 2024.2.1 | 3.2-8.7 |
Atualização de recursos do Koala | 2024.1.2 | 3.2-8.6 |
Koala | 2024.1.1 | 3.2-8.5 |
Jellyfish | 2023.3.1 | 3.2-8.4 |
Iguana | 2023.2.1 | 3.2-8.3 |
Hedgehog | 2023.1.1 | 3.2-8.2 |
Giraffe | 2022.3.1 | 3.2-8.1 |
Flamingo | 2022.2.1 | 3.2-8.0 |
Versões anteriores
Versão do Android Studio | Versão necessária do AGP |
---|---|
Electric Eel | 2022.1.1 | 3.2-7.4 |
Dolphin | 2021.3.1 | 3.2-7.3 |
Chipmunk | 2021.2.1 | 3.2-7.2 |
Bumblebee | 2021.1.1 | 3.2-7.1 |
Arctic Fox | 2020.3.1 | 3.1-7.0 |
Para mais informações sobre as novidades do Plug-in do Android para Gradle, acesse as notas da versão.
Versões mínimas de ferramentas para um nível da API do Android
Há versões mínimas do Android Studio e do AGP que oferecem suporte a um nível
específico da API. O uso de versões do Android Studio ou do AGP que são anteriores às exigidas pelo
targetSdk
ou compileSdk
do projeto pode levar a problemas inesperados. Recomendamos
usar as versões de pré-lançamento mais recentes do Android Studio e do AGP para trabalhar
em projetos voltados para versões de pré-lançamento do SO Android. Além da versão estável, você também pode
instalar
versões de pré-lançamento do Android Studio.
As versões mínimas do Android Studio e do AGP são as seguintes:
Nível da API | Versão mínima do Android Studio | Versão mínima do AGP |
---|---|---|
36,0 | Suricate | 2024.3.1 Patch 1 | 8.9.1 |
35 | Atualização de recursos do Koala | 2024.2.1 | 8.6.0 |
34 | Hedgehog | 2023.1.1 | 8.1.1 |
33 | Flamingo | 2022.2.1 | 7.2 |
Compatibilidade do Android Studio e dos serviços do Cloud
O Android Studio inclui integrações de serviços que ajudam você e sua equipe a progredir mais rápido ao desenvolver, lançar e manter apps Android. Isso inclui serviços do Google Cloud, como o Gemini no Android Studio, o Play Vitals e o Firebase Crashlytics. Os serviços do Google Cloud só estão disponíveis na versão mais recente do canal estável do Android Studio, nas três versões principais anteriores mais recentes e nos patches associados a essas versões. Quando uma versão fica fora dessa janela de compatibilidade, as integrações de serviço são desativadas, e você precisa atualizar o Android Studio.
Versões do Android Studio que são compatíveis com os serviços do Cloud
Desde o lançamento do canal estável do Android Studio Meerkat Feature Drop, todas as versões do Studio são compatíveis com os serviços do Cloud. A aplicação vai começar com a atualização de recursos do Android Studio Narwhal.
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.
Recurso | Descrição | Documentos |
---|---|---|
Geração de visualização do Compose | O Gemini pode gerar automaticamente prévias do Compose, incluindo dados simulados para parâmetros de prévia, para um elemento combinável específico ou todos os elementos combináveis em um arquivo. | Gerar visualizações do Compose |
Transformar interface | Use a linguagem natural para atualizar a interface do app diretamente no painel de visualização do Compose. | Transformar interface |
Confira a seguir os novos recursos da atualização de recursos 3 do Android Studio Narwhal.
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 Feature Drop 3 do 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:
- Implantar uma versão de depuração do app em um dispositivo conectado
- 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.
- 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.
Gere um backup do seu app.
- Confirme o ID do aplicativo para o qual você quer gerar um backup.
- 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:
- 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.
- 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.
- 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:
- Navegue até Run > Edit Configurations na barra de menus principal.
- Selecione uma configuração de execução do app e navegue até Opções de restauração.
Restaurar opções em uma configuração de execução. - Para restaurar um app de um backup, marque a caixa ao lado de Restaurar estado do app.
- Selecione um arquivo de backup no histórico recente ou procure e selecione o arquivo de backup no armazenamento local.
- 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.
- Clique em OK para salvar a configuração de execução.
- 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.
Anexar imagens no Gemini
Agora você pode anexar arquivos de imagem e fornecer mais informações com seu comando. Por exemplo, você pode anexar simulações ou capturas de tela da interface para informar ao Gemini sobre o layout do app. Assim, o Gemini pode gerar código Compose com base em uma imagem fornecida ou explicar os combináveis e o fluxo de dados de uma captura de tela da interface. Para saber mais, consulte Anexar uma imagem à consulta.

@Contexto do arquivo no Gemini
Agora você pode anexar os arquivos do projeto como contexto nas interações de chat com o
Gemini no Android Studio. Assim, você pode consultar rapidamente os arquivos nos comandos
para o Gemini. Na entrada de texto do chat do Gemini, digite @
para abrir um menu de conclusão de arquivo e selecione os arquivos que você quer anexar. Você também pode clicar no menu suspenso Contexto para ver quais arquivos foram anexados automaticamente pelo Gemini. Isso dá mais controle sobre o contexto enviado ao Gemini. Para saber mais, consulte
Anexar um arquivo à sua consulta.
