Configurar o Android Studio

O Android Studio oferece assistentes e modelos para verificar os requisitos do sistema, como o Java Development Kit (JDK) e a RAM disponível, além de definir configurações padrão, como uma emulação de Dispositivo virtual Android (AVD) otimizada padrão e imagens de sistema atualizadas. Este documento descreve outras definições de configuração para personalizar o uso do Android Studio.

O Android Studio oferece acesso a dois arquivos de configuração pelo menu Help:

  • studio.vmoptions: personalize opções para a máquina virtual Java (JVM) do Android Studio, como tamanho do heap e do cache. Em máquinas Linux, esse arquivo pode ser chamado de studio64.vmoptions, dependendo da versão do Android Studio.
  • idea.properties: personalize as propriedades do Android Studio, como o caminho da pasta de plug-ins ou o tamanho máximo de arquivo permitido.

Para a documentação específica sobre a configuração e o uso do emulador e do dispositivo, consulte os seguintes tópicos:

Encontrar os arquivos de configuração

Os dois arquivos de configuração são armazenados no diretório de configuração do Android Studio. Para encontrar o diretório de configuração, consulte Diretórios.

É possível usar as variáveis de ambiente a seguir para apontar para arquivos de substituição específicos em outro lugar:

  • STUDIO_VM_OPTIONS: defina o nome e o local do arquivo .vmoptions.
  • STUDIO_PROPERTIES: defina o nome e o local do arquivo .properties.

Para configurar quais JDKs são usados, acesse Versões do Java em builds do Android.

Personalizar opções da VM

O arquivo studio.vmoptions permite personalizar opções para a JVM do Android Studio. Para melhorar o desempenho do Android Studio, a opção mais comum é ajustar o tamanho máximo de heap, mas também é possível usar o arquivo studio.vmoptions para substituir outras configurações padrão, como tamanho inicial de heap, tamanho do cache e chaves de coleta de lixo do Java.

Para criar um novo arquivo studio.vmoptions ou abrir um já existente, siga estas etapas:

  1. Clique em Help > Edit Custom VM Options. Se você nunca editou opções de VM para o Android Studio antes, o ambiente de desenvolvimento integrado solicitará que você crie um novo arquivo studio.vmoptions. Clique em Criar para criar o arquivo.
  2. O arquivo studio.vmoptions é aberto na janela do editor do Android Studio. Edite o arquivo para adicionar as opções personalizadas de VM. Para uma lista completa das opções personalizáveis da JVM, consulte a página Java HotSpot VM Options da Oracle (em inglês).

O arquivo studio.vmoptions criado é adicionado ao arquivo studio.vmoptions padrão, localizado no diretório bin/ dentro da pasta de instalação do Android Studio.

Não edite diretamente o arquivo studio.vmoptions encontrado na pasta de programa do Android Studio. Embora você possa acessar o arquivo para conferir as opções padrão de VM do Android Studio, editar apenas o próprio arquivo studio.vmoptions garante que você não modifique configurações padrão importantes do Android Studio. Portanto, no arquivo studio.vmoptions, substitua apenas os atributos importantes e deixe o Android Studio continuar usando valores padrão para todos os atributos que você não mudou.

Tamanho máximo de heap

Por padrão, o tamanho máximo de pilha do Android Studio é 1.280 MB. Se você está trabalhando em um projeto grande ou se o sistema tem muita memória RAM, é possível melhorar o desempenho aumentando o tamanho máximo do heap para processos do Android Studio, como ambiente de desenvolvimento integrado principal, daemon do Gradle e daemon do Kotlin.

O Android Studio verifica automaticamente se é possível fazer otimizações de tamanho de heap e envia uma notificação se detectar que o desempenho pode ser melhorado.

Configurações de memória que permitem configurar a quantidade máxima de RAM
          para os processos do Android Studio.

Figura 1. Notificação sobre as configurações recomendadas de memória.

Se você está usando um sistema de 64 bits com 5 GB de RAM ou mais, também é possível ajustar manualmente os tamanhos de heap do seu projeto. Para fazer isso, siga estas instruções:

  1. Clique em File > Settings na barra de menus (Android Studio > Preferences no macOS).
  2. Clique em Appearance & Behavior > System Settings > Memory Settings.

    Configurações de memória que permitem configurar a quantidade máxima de RAM
  para os processos do Android Studio.

    Figura 2. Defina a quantidade máxima de RAM nas configurações de memória.

  3. Ajuste os tamanhos de heap.

  4. Clique em Aplicar.

    Se você mudar o tamanho de heap do ambiente de desenvolvimento integrado, precisará reiniciar o Android Studio para que as novas configurações de memória sejam aplicadas.

Exportar e importar configurações do ambiente de desenvolvimento integrado

Você pode exportar um arquivo Settings.jar com todas ou um subconjunto das suas configurações preferidas de ambiente de desenvolvimento integrado para um projeto. Esse arquivo JAR poderá ser importado para outros projetos e/ou disponibilizado para importação pelos seus colegas nos projetos deles.

Para saber mais, consulte Compartilhar configurações do ambiente de desenvolvimento integrado no IntelliJ IDEA.

Personalizar propriedades do ambiente de desenvolvimento integrado

O arquivo idea.properties permite personalizar as propriedades do ambiente de desenvolvimento integrado para o Android Studio, como o caminho para plug-ins instalados pelo usuário e o tamanho máximo de arquivo compatível com ele. O arquivo idea.properties é mesclado com as propriedades padrão do ambiente de desenvolvimento integrado. Assim, você pode especificar apenas as propriedades de substituição.

Para criar um novo arquivo idea.properties ou abrir um arquivo existente, siga estas etapas:

  1. Clique em Help > Edit Custom Properties. Se você nunca editou as propriedades do ambiente de desenvolvimento integrado, o Android Studio solicitará a criação de um novo arquivo idea.properties. Clique em Yes para criar o arquivo.
  2. O arquivo idea.properties é aberto na janela do editor do Android Studio. Edite o arquivo para adicionar as propriedades personalizadas do ambiente de desenvolvimento integrado.

O arquivo idea.properties a seguir inclui propriedades de ambiente de desenvolvimento integrado comumente personalizadas. Para ver uma lista completa de propriedades, leia sobre o arquivo idea.properties para o IntelliJ IDEA (link em inglês).

#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger the file is, the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features.
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise", then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6.
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff.
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480

Configurar o ambiente de desenvolvimento integrado para máquinas com pouca memória

Se você estiver executando o Android Studio em uma máquina com especificações inferiores às recomendadas (consulte os requisitos do sistema), poderá personalizar o ambiente de desenvolvimento integrado para melhorar o desempenho na máquina da seguinte maneira:

  • Reduza o tamanho de heap máximo disponível para o Android Studio: reduza o heap máximo do Android Studio para 512 MB. Para mais informações sobre como mudar esse parâmetro, consulte Tamanho máximo de heap.
  • Atualize o Gradle e o Plug-in do Android para Gradle:atualize para as versões mais recentes do Gradle e do Plug-in do Android para Gradle para aproveitar as melhorias de desempenho mais recentes. Para mais informações sobre a atualização do Gradle e do Plug-in do Android para Gradle, consulte as notas da versão.
  • Ative o modo de economia de energia:ative esse modo para desativar várias operações que consomem muita memória e bateria, incluindo destaque de erros e inspeções em tempo real, preenchimento automático de código pop-up e compilação incremental automática em segundo plano. Para ativar o modo de economia de energia, clique em File > Power Save Mode.
  • Desative verificações desnecessárias de lint: para mudar quais verificações de lint o Android Studio executa no seu código, faça o seguinte:

    1. Clique em File > Settings (no macOS, Android Studio > Preferences) para abrir a caixa de diálogo Settings.
    2. No painel esquerdo, expanda a seção Editor e clique em Inspections.
    3. Clique nas caixas de seleção para marcar ou desmarcar verificações de lint adequadas para o projeto.
    4. Clique em Apply ou OK para salvar as modificações.
  • Depure em um dispositivo físico:melhore o desempenho geral do Android Studio depurando em um dispositivo físico. A depuração em um emulador usa mais memória que a depuração em um dispositivo físico.

  • Inclua apenas os serviços necessários do Google Play como dependências:inclua apenas os serviços necessários como dependências no projeto. As dependências aumentam a quantidade de memória necessária. Portanto, limitá-las melhora o uso da memória e o desempenho. Para mais informações, consulte Declarar dependências para o Google Play Services.

  • Reduza o tamanho de heap máximo disponível para o Gradle:reduza o valor do tamanho máximo de heap do Gradle do padrão de 1.536 MB substituindo a propriedade org.gradle.jvmargs no arquivo gradle.properties, conforme mostrado abaixo:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory can
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • Verifique se a compilação paralela não está ativada:o Android Studio pode compilar módulos independentes em paralelo, mas esse recurso pode ficar desativado se você tiver um sistema com pouca memória. Para verificar essa configuração, faça o seguinte:

    1. Clique em File > Settings (no macOS, Android Studio > Preferences) para abrir a caixa de diálogo Settings.
    2. No painel esquerdo, expanda Build, Execution, Deployment e clique em Compiler.
    3. Verifique se a opção Compile independent modules in parallel está desmarcada.
    4. Se você fez uma modificação, clique em Apply ou OK para que ela entre em vigor.

Definir configurações do proxy

Os proxies atuam como pontos de conexão intermediários entre clientes HTTP e servidores da Web que adicionam segurança e privacidade às conexões de Internet.

Para oferecer suporte à execução do Android Studio atrás de um firewall, use a página de configurações do proxy HTTP do ambiente de desenvolvimento integrado do Android Studio para definir as configurações de proxy HTTP.

Ao executar o Plug-in do Android para Gradle na linha de comando ou em máquinas em que o Android Studio não está instalado, como servidores de integração contínua, defina as configurações do proxy no arquivo de build do Gradle.

Configurar o proxy do Android Studio

O Android Studio é compatível com configurações de proxy HTTP para que você possa executá-lo com a proteção de um firewall ou de uma rede segura. Para definir as configurações de proxy HTTP no Android Studio:

  1. Na barra de menus, clique em File > Settings (no macOS, clique em Android Studio > Preferences).
  2. No painel esquerdo, clique em Appearance & Behavior > System Settings > HTTP Proxy. A página de proxy HTTP será exibida.
  3. Selecione Auto-detect proxy settings para usar um URL de configuração automática de proxy para as configurações de proxy ou Manual proxy configuration para inserir manualmente todas as configurações. Para ver uma explicação detalhada dessas configurações, consulte Proxy HTTP (link em inglês).
  4. Clique em Apply ou OK para que as modificações entrem em vigor.

Configurações de proxy HTTP para o plug-in do Android para Gradle

Para executar o plug-in do Android na linha de comando ou em máquinas em que o Android Studio não está instalado, defina as configurações de proxy do plug-in do Android para Gradle no arquivo de build do Gradle.

Para configurações de proxy HTTP específicas de aplicativos, defina as configurações de proxy no arquivo build.gradle conforme necessário para cada módulo do aplicativo:

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        ...
        systemProp.http.proxyHost=proxy.company.com
        systemProp.http.proxyPort=443
        systemProp.http.proxyUser=userid
        systemProp.http.proxyPassword=password
        systemProp.http.auth.ntlm.domain=domain
    }
    ...
}

Para configurações de proxy HTTP para todo o projeto, defina as configurações de proxy no arquivo gradle/gradle.properties:

# Project-wide Gradle settings.
...

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain

systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain

...

Para informações sobre o uso de propriedades do Gradle para configurações de proxy, consulte o Guia do usuário do Gradle (em inglês).

Otimizar o desempenho do Android Studio no Windows

O desempenho do Android Studio no Windows pode ser afetado por diversos fatores. Esta seção descreve como você pode otimizar as configurações do Android Studio para ter o melhor desempenho possível no Windows.

Minimizar o impacto do software antivírus na velocidade de compilação

Alguns softwares antivírus podem interferir no processo de compilação do Android Studio, fazendo com que os builds sejam executados de maneira muito mais lenta. Quando você executa um build no Android Studio, o Gradle compila os recursos e o código-fonte do seu app e, em seguida, agrupa os recursos compilados em um APK ou AAB. Durante esse processo, muitos arquivos são criados no seu computador. Se a verificação em tempo real estiver ativada no seu software antivírus, ele poderá forçar a interrupção do processo de compilação sempre que um arquivo for criado durante a verificação dele.

Para evitar esse problema, você pode excluir determinados diretórios da verificação em tempo real pelo software antivírus. Para o Windows, o Build Analyzer pode ajudar a identificar os diretórios que precisam ser excluídos da verificação ativa e excluí-los.

A lista a seguir mostra o local padrão de cada diretório do Android Studio que pode ser excluído da verificação em tempo real:

Cache do Gradle
%USERPROFILE%\.gradle
Projetos do Android Studio
%USERPROFILE%\AndroidStudioProjects
SDK do Android
%USERPROFILE%\AppData\Local\Android\SDK

Arquivos de sistema do Android Studio

Sintaxe: %LOCALAPPDATA%\Google\<product><version>

Exemplo: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

Personalizar locais de diretório para ambientes controlados pela Política de grupo

Se uma Política de grupo limitar os diretórios que você pode excluir da verificação em tempo real no seu computador, mova os diretórios do Android Studio para um dos locais que a Política de grupo centralizada já exclui.

A lista a seguir mostra como personalizar o local de cada diretório do Android Studio, em que C:\WorkFolder é o diretório que a Política de grupo já exclui:

Cache do Gradle
Defina a variável de ambiente GRADLE_USER_HOME para apontar para C:\WorkFolder\.gradle.
Projetos do Android Studio
Mova ou crie diretórios de projeto em um subdiretório adequado de C:\WorkFolder. Por exemplo, C:\WorkFolder\AndroidStudioProjects.
SDK do Android

Siga estas etapas para personalizar o local:

  1. No Android Studio, abra a caixa de diálogo Settings (Preferences no macOS) e navegue até Appearance & Behavior > System Settings > Android SDK.

  2. Mude o valor de Android SDK Location para C:\WorkFolder\AndroidSDK.

    Para evitar o download do SDK novamente, copie o diretório do SDK existente, localizado em %USERPROFILE%\AppData\Local\Android\SDK por padrão, para o novo local.

Arquivos de sistema do Android Studio

Siga estas etapas para personalizar o local:

  1. No Android Studio, clique em Help > Edit Custom Properties.

    O Android Studio solicitará que você crie um arquivo idea.properties, se ainda não tiver um.

  2. Adicione a linha a seguir ao arquivo idea.properties:

    idea.system.path=c:/workfolder/studio/caches/trunk-system