Resolver problemas do Android Studio

Esta página contém orientações para resolver problemas comuns e de configuração no Android Studio.

Telas de alta densidade

A partir da versão 1.5, o Android Studio oferece suporte a telas de alta densidade (como monitores HiDPI e Retina) em todas as plataformas.

Configurações de fator de escalonamento

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

Mac

Em telas Retina, a escala dos elementos da IU é ajustada por um fator de 200%, e as imagens são renderizadas em alta resolução. O ajuste de escala não pode provocar desfoque das imagens, mesmo em configurações de várias telas. Não há compatibilidade para fatores de escalonamento 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 escalonamento dos elementos da IU. Para imagens, se o fator de escalonamento for menor que 150%, a escala das imagens com resolução normal será aumentada. Se o fator de escalonamento for maior que 150%, a escala das imagens de alta resolução será ajustada adequadamente.

Linux

O Android Studio determina o fator de escalonamento analisando o "Text Scaling Factor" e a configuração de DPI do sistema XWindow.

Uma configuração de DPI igual a 96 corresponde a um fator de escalonamento de 100% (sem mudança de escala) e uma igual a 192 corresponde a um fator de escalonamento de 200% (o tamanho dos elementos da IU é dobrado). No momento, o Android Studio é compatível com configurações de DPI entre 96 (escalonamento de 100%) e 288 (escalonamento de 300%). Se o Android Studio não detectar o DPI correto do sistema na sua máquina Linux ou Windows, você pode defini-lo manualmente configurando a propriedade hidpi no arquivo idea.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 maneira:

hidpi=true

Define o DPI como 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 na tela de alta densidade, um dos seguintes problemas pode ser o responsável:

• Se a maior parte da IU do Android Studio estiver normal, mas um ícone específico estiver desfocado ou pixelado ou se 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 escalonamento diferente de 100% ou 200%, as imagens poderão aparecer ligeiramente desfocadas devido à mudança da escala.
• Se você estiver usando uma máquina Windows e tiver mudado o tamanho de fonte do sistema 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 uma versão mais recente, ao mover uma janela de uma tela para outra com uma resolução ou um DPI diferente, pode haver 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 (principalmente o JRE 1.8.0_25-b18 amd64). Consulte o bug 192316. Da versão 2.2 em diante, o Android Studio inclui uma versão agrupada do JDK compatível mais recente, que contém o JDE. Para resolver esse problema, atualize o Android Studio para a versão 2.2 ou mais recente e passe a usar o JDK incluído. Para isso, clique em File > Project Structure > SDK Location e marque 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 escalonamento. 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 ficar muito pequena ou muito 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 mude o tamanho da fonte do editor. Quando o esquema padrão estiver ativo, a escala do tamanho da fonte do editor será mudada 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, é possível que o responsável seja o problema 186923. 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')". Esse erro pode ser resolvido adicionando a propriedade de sistema -Djava.net.preferIPv4Stack=true ao arquivo gradle.properties no Android Studio da seguinte forma:

1. Abra o arquivo gradle.properties no Android Studio.
2. Adicione a seguinte linha ao arquivo:

   org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
   

   Se você já tiver adicionado outros argumentos de JVM do Gradle ao arquivo gradle.properties, poderá adicionar essa propriedade à mesma linha, conforme mostrado no exemplo abaixo:

   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 com a atualização do 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 do ambiente de desenvolvimento integrado, algumas vezes, a atualização não é instalada, normalmente gerando 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 daemons do Gradle.

Problemas de minSdkVersion

Se você está usando uma versão obsoleta das Bibliotecas de Suporte do Android, talvez receba 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 e faça a atualização das Bibliotecas de Suporte do Android para as versões mais recentes (não as de pré-lançamento). Para ver mais informações sobre a configuração das Bibliotecas de Suporte, consulte Configuração da Biblioteca de Suporte.

Problemas do Android Emulator

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

Diretórios

Os diretórios abaixo são usados pelo Android Studio para armazenar configurações, caches, plug-ins e registros.

Cada diretório é listado no seguinte formato:

• <informal directory name> (<IDE property>): <default path>.

Substitua:

• AndroidStudio pelo nome do produto, que é AndroidStudio para versões estáveis ou AndroidStudioPreview para versões Beta e Canary.
• VERSION pela versão. Por exemplo: 2023.1 ou 2023.3.