Configurar o Android Studio

O Android Studio oferece assistentes e modelos que verificam o sistema requisitos, como o Java Development Kit (JDK) e a RAM disponível, e definir as configurações padrão, como um ambiente virtual padrão otimizado Emulação de dispositivo (AVD) e imagens do sistema atualizadas. Este documento descreve definições de configuração adicionais para personalizar seu uso do Android Estúdio.

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

• studio.vmoptions: personalizar opções para o Android Studio Java Virtual Machine (JVM), como tamanho da heap e do cache. Observe que em Nas máquinas Linux, esse arquivo pode ser nomeado como studio64.vmoptions, dependendo da sua 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:

• Criar e gerenciar dispositivos virtuais
• Executar apps em um dispositivo de hardware
• Instalar drivers USB OEM

Encontrar os arquivos de configuração

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

Observação :para localizar rapidamente o diretório de configuração, acesse Ajuda > Editar opções de VM personalizadas ou Ajuda > Editar propriedades personalizadas no Android Studio Um arquivo de configuração será aberto. Inspecione o caminho do de configuração para encontrar o diretório.

É possível usar as variáveis de ambiente a seguir para apontar para substituir arquivos 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 o JVM. Para melhorar o desempenho do Android Studio, a opção mais comum de ajuste é a tamanho de heap máximo, 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 lixo do Java interruptores de coleta.

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 será 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 Arquivo studio.vmoptions, localizado no diretório bin/ dentro do Android. Pasta de instalação do Studio.

Não edite diretamente o arquivo studio.vmoptions encontrado dentro da pasta de programa do Android Studio. Embora você possa acessar o arquivo ver as opções padrão de VM do Android Studio, editando apenas as suas studio.vmoptions garante que você não substitua padrões importantes do Android Studio. Portanto, no arquivo studio.vmoptions, substitua apenas os atributos desejados e deixe o Android Studio continuar usando valores padrão para quaisquer atributos que você não tenha alterado.

Tamanho máximo de heap

Por padrão, o tamanho máximo de heap do Android Studio é 1280 MB. Se você está trabalhando em um projeto grande ou se o sistema tem bastante RAM disponível, é possível melhorar o desempenho com o aumento do tamanho máximo de heap nos processos do Android Studio, como o ambiente de desenvolvimento integrado principal, o daemon do Gradle e o 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.

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 isso, siga estas etapas:

1. Clique em Arquivo > Configurações na barra de menus (Android Studio > Preferências no macOS).

2. Clique em Appearance & Behavior > System Settings > Memory Settings.

   

   Figura 2. Configurar o máximo de memória 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 antes da aplicação das novas configurações.

Observação: a alocação de memória em excesso pode prejudicar o desempenho.

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 mais informações, 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 Android. Studio, como o caminho para os plug-ins instalados pelo usuário e o tamanho máximo do arquivo compatíveis com o ambiente de desenvolvimento integrado. O arquivo idea.properties é mesclado com o arquivo padrão para o ambiente de desenvolvimento integrado, para que seja possível especificar somente as propriedades de modificação.

Para criar um novo arquivo idea.properties ou abrir um já existente, siga estas etapas: 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 será aberto na janela do editor do Android Studio. Editar o arquivo para adicionar as propriedades personalizadas do ambiente de desenvolvimento integrado.

O arquivo idea.properties a seguir inclui um ambiente de desenvolvimento integrado comumente personalizado propriedades. 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 menos do que o recomendado especificações (consulte os requisitos do sistema), você pode personalizar o ambiente de desenvolvimento integrado para melhorar o desempenho na sua 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.
• Atualizar o Gradle e o Plug-in do Android para Gradle:atualize para a versão mais recente. do Gradle e do Plug-in do Android para Gradle e aproveitar as últimas melhorias de desempenho. Para mais informações sobre como atualizar o Gradle e o Plug-in do Android para Gradle, consulte a Notas da versão do Plug-in do Android para Gradle.
• Ativar o modo de economia de energia:ative o modo de economia de energia para desativar vários operações em segundo plano com uso intensivo de memória e bateria, inspeções imediatas e destacadas, 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.

• Depurar em um dispositivo físico:melhore o desempenho geral do Android Studio com a depuração em um dispositivo físico. A depuração em um emulador usa mais memória do que a depuração em um dispositivo físico.

• Inclua somente os serviços necessários do Google Play como dependências:inclua apenas os serviços necessários. o Google Play Services necessário como dependências no projeto. Aumento das dependências a quantidade de memória necessária, de modo que limitá-los melhora o uso de memória e desempenho. Para mais informações, consulte Declare dependências para o Google Play Services.

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

  # Make sure to gradually decrease this value and note
  # changes in performance. Allocating too little memory can
  # also decrease performance.
  org.gradle.jvmargs = -Xmx1536m
  

• Confira se a compilação paralela não está ativada:o Android Studio pode compilar. módulos independentes em paralelo, mas deixe esse recurso desativado se você tiver uma 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 o Android Studio Página de configurações de proxy HTTP do ambiente de desenvolvimento integrado para definir as configurações do 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 em servidores de integração contínua, defina as configurações de proxy no arquivo de build do Gradle.

Observação: após a instalação inicial do pacote do Android Studio, o Android O Studio pode ser executado com acesso à Internet ou off-line. No entanto, o Android Studio é necessária uma conexão de Internet para sincronizar o assistente de configuração, acesso à biblioteca, acesso a repositórios remotos, inicialização do Gradle e sincronização e atualizações de versão do Android Studio.

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

Ao executar o plug-in do Android na linha de comando ou em máquinas em que O Android Studio não está instalado, defina o 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 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 na 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).

Observação: ao usar o Android Studio, as configurações na página de configurações de proxy HTTP do ambiente de desenvolvimento integrado do Android Studio substituem essas configurações no arquivo gradle.properties.

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 são criados no seu computador. Se seu software antivírus tem aplicativos estiver ativada, o software antivírus poderá forçar a interrupção do processo de build sempre que um arquivo é criado enquanto ele é verificado.

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

Atenção: para garantir que seu computador seja protegido contra softwares maliciosos, não desativar completamente a verificação em tempo real ou seu software antivírus.

A lista a seguir mostra o local padrão de cada diretório do Android Studio que podem ser excluídas 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 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