Résoudre les problèmes liés à Android Studio

Cette page contient des conseils pour résoudre les problèmes courants et de configuration dans Android Studio.

Écrans haute densité

Depuis la version 1.5, Android Studio prend en charge les écrans haute densité (comme les écrans HiDPI et Retina) sur toutes les plates-formes.

Paramètres du facteur de scaling

Android Studio détermine le facteur de mise à l'échelle de votre écran comme suit :

Mac
Pour les écrans Retina, les éléments d'interface utilisateur sont mis à l'échelle avec un facteur de 200 %, et les images sont affichées en haute résolution. Le scaling ne devrait pas provoquer de floutage, même dans le cas de configurations multi-écrans. Notez que les facteurs de scaling supérieurs à 100 % (pour les écrans non Retina) et 200% (pour les écrans Retina) ne sont pas pris en charge.
Windows
Android Studio utilise les paramètres PPP de l'écran principal pour déterminer le facteur de scaling des éléments de l'interface utilisateur. Pour les images, si le facteur de scaling est inférieur à 150 %, un scaling à la hausse est effectué pour les images en résolution normale. Si le facteur de mise à l'échelle est supérieur à 150 %, les images haute résolution sont mises à l'échelle de manière appropriée.
Linux
Android Studio détermine le facteur de scaling en examinant le "Text Scaling Factor" ("facteur de scaling du texte"), puis le paramètre PPP du système XWindow.
Un paramètre PPP de 96 correspond à un facteur de scaling de 100 % (aucun scaling) et un paramètre PPP de 192 correspond à un facteur de scaling de 200 % (la taille des éléments d'interface utilisateur est doublée). Android Studio est actuellement compatible avec les paramètres PPP compris entre 96 (scaling à 100 %) et 288 (scaling à 300 %). Si Android Studio ne détecte pas le bon paramètre PPP du système sur votre machine Linux ou Windows, vous pouvez le définir manuellement en spécifiant la propriété hidpi dans le fichier idea.properties, comme décrit dans la section Personnalisez les propriétés de votre IDE. Notez que cette propriété n'a aucune incidence sur les machines Mac. Cette propriété fonctionne comme suit :
hidpi=true
Définit le PPP sur 192 (scaling à 200 %) en ignorant les paramètres système.
hidpi=false
Définit le PPP sur 96 (scaling à 100 %) en ignorant les paramètres système.

Éléments flous ou pixélisés sur des écrans haute densité

Si un ou plusieurs éléments de l'interface utilisateur d'Android Studio apparaissent flous ou pixélisés sur votre écran haute densité, vous rencontrez peut-être l'un des problèmes suivants :

  • Si la majeure partie de l'interface utilisateur d'Android Studio semble correcte, mais qu'une icône particulière est floue ou pixélisée, ou qu'un élément particulier de l'interface utilisateur utilise une police de taille incorrecte, cet élément particulier n'a probablement pas encore été entièrement mis à jour pour la prise en charge HiDPI. Pour signaler un bug, cliquez sur Help > Submit Feedback (Aide > Envoyer des commentaires). Veuillez inclure une capture d'écran et autant d'informations que possible sur la configuration de votre système.
  • Si vous utilisez une machine Windows ou Linux et que votre écran utilise un facteur de scaling autre que 100 % ou 200 %, les images peuvent apparaître légèrement floues en raison du scaling.
  • Si vous utilisez une machine Windows et que vous avez modifié la taille de police Windows dans le panneau de configuration, il est possible que la police soit floue ou pixélisée. Pour résoudre ce problème, déconnectez-vous de Windows, puis reconnectez-vous.
  • Avec une configuration multi-écran sous Windows 8.1 ou version ultérieure, vous pouvez rencontrer des problèmes de police ou d'image lorsque vous déplacez une fenêtre d'un écran vers un autre avec une résolution ou un PPP différent (voir le bug 186007). Il n'existe actuellement aucune solution de contournement connue.
  • Les anciennes versions de JRE 1.8 rencontraient un problème avec les polices floues (en particulier JRE 1.8.0_25-b18 amd64, voir le bug 192316). Depuis la version 2.2, Android Studio inclut une version intégrée du dernier JDK compatible, qui inclut le JDE. Pour résoudre ce problème, mettez à jour Android Studio vers la version 2.2 ou une version ultérieure et utilisez le JDK fourni en cliquant sur File > Project Structure > SDK Location (Fichier > Structure du projet > Emplacement du SDK) et en cochant la case Use embedded JDK (Utiliser le JDK intégré).

Éléments de taille incorrecte sur les écrans haute densité

Si la taille de l'interface utilisateur Android Studio est incorrecte sur votre écran haute densité, consultez la section Paramètres du facteur de scaling. Si la taille de certains éléments de l'interface utilisateur d'Android Studio est incorrecte sur votre écran haute densité, mais que d'autres sont correctement dimensionnés, vous pouvez rencontrer l'un des problèmes suivants :

  • Si vous utilisez un schéma d'éditeur personnalisé, la police de l'éditeur peut sembler trop petite ou trop grande par rapport aux autres éléments de l'interface utilisateur sur un écran haute densité. Pour résoudre ce problème, cliquez sur File > Settings (Fichier > Paramètres), puis sur Editor > Colors and Fonts > Font (Éditeur > Couleurs et polices > Police). Modifiez ensuite la taille de la police de l'éditeur. Notez que lorsque le schéma par défaut est actif, la taille de la police de l'éditeur est mise à l'échelle automatiquement (voir le bug 186920).
  • Si la taille de certains éléments d'interface utilisateur d'Android Studio est correcte, mais que d'autres sont trop petits ou trop volumineux, le problème peut être le numéro 186923. Pour signaler un bug, cliquez sur Help > Submit Feedback (Aide > Envoyer des commentaires). Veuillez inclure une capture d'écran et autant d'informations que possible sur la configuration de votre système.

Problèmes de synchronisation du projet

Lorsque vous tentez de synchroniser votre projet, le message d'erreur suivant peut s'afficher : "Connection to the Internet denied. ('Permission denied: connect')" (""Connexion à Internet refusée. ("Autorisation refusée : connexion")"). Vous pouvez résoudre ce message d'erreur en ajoutant la propriété système -Djava.net.preferIPv4Stack=true à votre fichier gradle.properties dans Android Studio, comme suit :

  1. Ouvrez votre fichier gradle.properties dans Android Studio.
  2. Ajoutez la ligne suivante au fichier :
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    Notez que si vous avez déjà ajouté d'autres arguments JVM Gradle à votre fichier gradle.properties, vous pouvez ajouter cette propriété à la même ligne, comme indiqué dans l'exemple suivant :
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. Redémarrez Android Studio pour que vos modifications soient prises en compte.
  4. Dans la barre d'outils, cliquez sur Sync Project with Gradle Files  (Synchroniser le projet avec les fichiers Gradle).

Problèmes de mise à jour de l'IDE sous Windows

Sous Windows, les fichiers en cours d'utilisation par un processus ne peuvent pas être supprimés. Lorsque vous tentez d'utiliser le mécanisme de mise à jour intégré dans l'IDE, celui-ci refuse parfois d'installer la mise à jour et affiche généralement un message d'erreur du type "Can't delete C:\some\path\file" ("Impossible de supprimer le chemin d'accès C:\some\path\").

Pour contourner ce problème, ouvrez le gestionnaire de tâches et essayez de supprimer les processus susceptibles d'utiliser le fichier, tels que les daemons Gradle.

Problèmes minSdkVersion

Si vous utilisez une version obsolète des bibliothèques Android Support, vous pouvez recevoir un message d'erreur semblable à celui-ci :

: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

Pour résoudre ce problème, utilisez le SDK Manager afin d'installer les dernières versions (non bêta) des bibliothèques Android Support. Pour en savoir plus sur la configuration des bibliothèques Support, consultez la page Configurer la bibliothèque Support.

Problèmes Android Emulator

Consultez la section Dépannage d'Android Emulator.

Répertoires

Les répertoires suivants sont utilisés par Android Studio pour stocker les paramètres, les caches, les plug-ins et les journaux.

Windows

  • Configuration (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • Système (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Journaux (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • Exemple pour %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • Exemple pour %LOCALAPPDATA%: C:\Users\YourUserName\AppData\Local

macOS

  • Configuration (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • Système (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Journaux (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Configuration (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • Système (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Journaux (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Chaque répertoire est listé au format suivant:

Remplacez:

  • AndroidStudio par le nom du produit, à savoir AndroidStudio pour les versions stables ou AndroidStudioPreview pour les versions bêta et Canary.
  • VERSION par la version ; Exemples: 2023.1 ou 2023.3.