Solucionar problemas do Android Studio

Esta página traz algumas orientações de como solucionar problemas comuns e de configuração no Android Studio.

Telas de alta densidade

A partir da versão 1.5, o Android Studio é compatível com telas de alta densidade, como monitores HiDPI e Retina, em todas as plataformas.

Configurações de fator de escala

O Android Studio determina o fator de escala da sua tela da seguinte maneira:

Mac
Em telas Retina, a escala dos elementos de IU é ajustada por um fator de 200%, e as imagens são renderizadas em alta resolução. O ajuste de escala não deve provocar imagens desfocadas, mesmo em configurações de várias telas. Não há compatibilidade para fatores de escala diferentes de 100% para monitores que não são Retina e de 200% para monitores Retina.
Windows
O Android Studio usa as configurações de DPI da tela principal para determinar o fator de escala dos elementos de IU. Para imagens, se o fator de escala for inferior a 150%, a escala das imagens com resolução normal será aumentada. Se o fator de escala for maior que 150%, a escala das imagens de alta resolução será ajustada adequadamente.
Linux
O Android Studio determina o fator de escala analisando o "Text Scaling Factor" e a configuração de DPI de sistema do XWindow.
Uma configuração de DPI igual a 96 corresponde a um fator de escala de 100% (sem alteração de escala), e uma configuração de DPI igual a 192 corresponde a um fator de escala de 200% (o tamanho dos elementos de IU é dobrado). No momento, o Android Studio é compatível com configurações de DPI entre 96 (escala de 100%) e 288 (escala de 300%). Se o Android Studio não detectar o DPI de sistema correto em uma máquina Linux ou Windows, você poderá defini-lo manualmente configurando a propriedade hidpi no arquivo ide.properties, conforme descrito em Personalizar propriedades do ambiente de desenvolvimento integrado. Essa propriedade não tem efeito em máquinas Mac. A propriedade funciona da seguinte forma:
hidpi=true
Define o DPI em 192 (escala de 200%), ignorando as configurações do sistema.
hidpi=false
Define o DPI em 96 (escala de 100%), ignorando as configurações do sistema.

Elementos desfocados ou pixelados em telas de alta densidade

Se um ou mais elementos da IU do Android Studio aparecerem desfocados ou pixelados em uma tela de alta densidade, um dos problemas a seguir poderá ser o responsável:

  • Se a maior parte da IU do Android Studio estiver normal, mas um determinado ícone estiver desfocado ou pixelado, ou um elemento específico da IU estiver usando o tamanho errado de fonte, é provável que esse elemento ainda não tenha sido totalmente atualizado para ser compatível com HiDPI. Informe um bug clicando em Help > Submit Feedback. Inclua uma captura de tela e o maior número de informações possível sobre a configuração do sistema.
  • Se você estiver usando uma máquina Windows ou Linux, e a tela usar um fator de escala diferente de 100% ou 200%, as imagens poderão aparecer ligeiramente desfocadas devido à alteração da escala.
  • Se você estiver usando uma máquina Windows e tiver alterado o tamanho de fonte do Windows no Painel de controle, as fontes poderão ficar desfocadas ou pixeladas. Esse problema pode ser resolvido saindo do Windows e fazendo login novamente.
  • Em uma configuração de várias telas com Windows 8.1 ou posterior, quando você move uma janela de uma tela para outra com resolução ou DPI diferente, pode ocorrer problemas com as fontes ou imagens (consulte o bug 186007). Não há solução alternativa no momento.
  • Versões anteriores do JRE 1.8 apresentavam um problema de fontes desfocadas (especificamente, JRE 1.8.0_25-b18 amd64, consulte o bug 192316). A partir da versão 2.2, o Android Studio inclui uma versão empacotada do JDK compatível mais recente, que inclui o JDE. Para resolver esse problema, atualize o Android Studio para a versão 2.2 ou posterior e comece a usar o JDK empacotado clicando em File > Project Structure > SDK Location e marcando a caixa de seleção Use embedded JDK.

Elementos com tamanho incorreto e telas de alta densidade

Se toda a IU do Android Studio estiver com o tamanho errado na tela de alta densidade, consulte Configurações de fator de escala. Se alguns elementos da IU do Android Studio estiverem com o tamanho errado na tela de alta densidade, mas outros estiverem com o tamanho correto, um dos problemas a seguir poderá ser o responsável:

  • Se você está usando um esquema de editor personalizado, a fonte do editor pode aparecer muito pequena ou grande em relação aos demais elementos da IU em uma tela de alta densidade. Para corrigir o problema, clique em File > Settings, depois em Editor > Colors and Fonts > Font e altere o tamanho da fonte do editor. Quando o esquema padrão estiver ativo, a escala do tamanho da fonte do editor será alterada automaticamente (consulte o bug 186920).
  • Se alguns elementos da IU do Android Studio estiverem com o tamanho correto, mas outros estiverem muito pequenos ou muito grandes, o problema 186923 poderá ser o responsável. Informe um bug clicando em Help > Submit Feedback. Inclua uma captura de tela e o maior número de informações possível sobre a configuração do sistema.

Problemas de sincronização do projeto

Ao tentar sincronizar um projeto, você pode receber a seguinte mensagem de erro: "Connection to the Internet denied. ('Permission denied: connect')". Essa mensagem de erro pode ser resolvida adicionando a propriedade de sistema -Djava.net.preferIPv4Stack=true ao arquivo gradle.properties no Android Studio, da seguinte forma:

  1. Abra seu arquivo gradle.properties no Android Studio.
  2. Adicione a linha a seguir ao arquivo:
        org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
        
    Se você já adicionou outros argumentos de JVM do Gradle ao arquivo gradle.properties, pode adicionar essa propriedade à mesma linha, como mostrado neste exemplo:
        org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
        
  3. Reinicie o Android Studio para que as alterações sejam aplicadas.
  4. Clique em Sync Project with Gradle Files para sincronizar seu projeto.

Problemas para atualizar o ambiente de desenvolvimento integrado no Windows

No Windows, os arquivos em uso por um processo não podem ser excluídos. Quando você tenta usar o mecanismo de atualização incorporado no ambiente de desenvolvimento integrado, a atualização pode não ser instalada, exibindo normalmente uma mensagem de erro como "Can't delete C:\some\path\file".

Para contornar esse problema, abra o gerenciador de tarefas e tente encerrar os processos que podem estar usando o arquivo, como todos os daemons do Gradle.

Problemas de minSdkVersion

Se você estiver usando uma versão obsoleta das Android Support Libraries, poderá receber uma mensagem de erro como esta:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
    uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
    Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

Para resolver o problema, use o SDK Manager para atualizar para as versões mais recentes (não Preview) das Android Support Libraries. Para ver mais informações sobre a configuração das Support Libraries, consulte Configuração da Support Library.

Problemas do Android Emulator

Consulte a Solução de problemas do Android Emulator.