Risolvere i problemi relativi ad Android Studio

Questa pagina contiene indicazioni per la risoluzione dei problemi comuni e di configurazione in Android Studio.

Display ad alta densità

A partire dalla versione 1.5, Android Studio supporta i display ad alta densità (come i monitor HiDPI e Retina) su tutte le piattaforme.

Impostazioni del fattore di scalabilità

Android Studio determina il fattore di scalabilità per il display nel seguente modo:

Mac
Per i display Retina, gli elementi della UI vengono scalati di un fattore del 200% e le immagini vengono visualizzate ad alta risoluzione. Non dovrebbe esserci sfocatura dovuta al ridimensionamento, anche nelle configurazioni multi-monitor. Tieni presente che non è supportato alcun fattore di scalabilità diverso da 100% (per i display non Retina) e 200% (per i display Retina).
Windows
Android Studio utilizza le impostazioni DPI del display principale per determinare il fattore di scalabilità degli elementi UI. Per le immagini, se il fattore di ridimensionamento è inferiore al 150%, le immagini a risoluzione normale vengono ingrandite. Se il fattore di scalabilità è superiore al 150%, le immagini ad alta risoluzione vengono scalate in modo appropriato.
Linux
Android Studio determina il fattore di scalabilità esaminando il "Fattore di scalabilità del testo" e poi l'impostazione DPI del sistema XWindow.
Un'impostazione DPI di 96 corrisponde a un fattore di scalabilità del 100% (nessuna scalabilità) e un'impostazione DPI di 192 corrisponde a un fattore di scalabilità del 200% (le dimensioni degli elementi dell'interfaccia utente vengono raddoppiate). Android Studio attualmente supporta impostazioni DPI comprese tra 96 (scalabilità al 100%) e 288 (scalabilità al 300%). Se Android Studio non rileva il DPI di sistema corretto sul tuo computer Linux o Windows, puoi impostarlo manualmente impostando la proprietà hidpi nel file idea.properties come descritto in Personalizzare le proprietà dell'IDE. Tieni presente che questa proprietà non ha alcun effetto sui computer Mac. Questa proprietà funziona nel seguente modo:
hidpi=true
Imposta il DPI su 192 (scalabilità al 200%), ignorando le impostazioni di sistema.
hidpi=false
Imposta i DPI su 96 (scalabilità al 100%), ignorando le impostazioni di sistema.

Elementi sfocati o pixelati sui display ad alta densità

Se uno o più elementi dell'interfaccia utente di Android Studio appaiono sfocati o pixelati sul display ad alta densità, potresti riscontrare uno dei seguenti problemi:

  • Se la maggior parte dell'interfaccia utente di Android Studio ha un aspetto corretto, ma una particolare icona è sfocata o pixelata oppure un particolare elemento dell'interfaccia utente utilizza un carattere di dimensioni errate, probabilmente questo elemento non è ancora stato completamente aggiornato per il supporto HiDPI. Segnala un bug facendo clic su Guida > Invia feedback. Includi uno screenshot e il maggior numero possibile di informazioni sulla configurazione del sistema.
  • Se utilizzi un computer Windows o Linux e il display utilizza un fattore di scalabilità diverso da 100% o 200%, le immagini potrebbero apparire leggermente sfocate a causa della scalabilità.
  • Se utilizzi un computer Windows e hai modificato le dimensioni del carattere di Windows nel Pannello di controllo, potresti notare che il carattere è sfocato o pixelato. Puoi risolvere il problema uscendo da Windows e accedendo di nuovo.
  • In una configurazione multi-monitor con Windows 8.1 o versioni successive, quando sposti una finestra da un display a un altro con una risoluzione o un DPI diversi, potresti riscontrare problemi con i caratteri o le immagini (vedi il bug 186007). Al momento non è nota alcuna soluzione alternativa.
  • Le versioni precedenti di JRE 1.8 presentavano un problema di sfocatura dei caratteri (in particolare JRE 1.8.0_25-b18 amd64, vedi bug 192316). A partire dalla versione 2.2, Android Studio include una versione in bundle dell'ultima JDK supportata, che include JDE. Per risolvere il problema, aggiorna Android Studio alla versione 2.2 o successive e passa all'utilizzo dell'JDK in bundle facendo clic su File > Project Structure > SDK Location e selezionando la casella di controllo Usa JDK incorporato.

Elementi di dimensioni errate sui display ad alta densità

Se l'intera UI di Android Studio ha dimensioni errate sul display ad alta densità, consulta Impostazioni del fattore di scalabilità. Se alcuni elementi dell'interfaccia utente di Android Studio hanno dimensioni errate sul display ad alta densità, ma altri hanno dimensioni corrette, potresti riscontrare uno dei seguenti problemi:

  • Se utilizzi uno schema di editor personalizzato, il carattere dell'editor potrebbe apparire troppo piccolo o troppo grande rispetto al resto degli elementi della UI su un display ad alta densità. Per risolvere il problema, fai clic su File > Impostazioni, poi su Editor > Colori e caratteri > Carattere e modifica le dimensioni del carattere dell'editor. Tieni presente che quando lo schema predefinito è attivo, le dimensioni del carattere dell'editor vengono scalate automaticamente (vedi bug 186920).
  • Se alcuni elementi dell'interfaccia utente di Android Studio hanno le dimensioni giuste, ma altri sono troppo piccoli o troppo grandi, potresti riscontrare il problema 186923. Segnala un bug facendo clic su Guida > Invia feedback. Includi uno screenshot e il maggior numero possibile di informazioni sulla configurazione del sistema.

Problemi di sincronizzazione dei progetti

Quando tenti di sincronizzare il progetto, potresti ricevere il seguente messaggio di errore: "Connessione a internet negata. ("Autorizzazione negata: connessione"). Puoi risolvere questo messaggio di errore aggiungendo la proprietà di sistema -Djava.net.preferIPv4Stack=true al file gradle.properties in Android Studio nel seguente modo:

  1. Apri il file gradle.properties in Android Studio.
  2. Aggiungi la seguente riga al file:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    Tieni presente che se hai già aggiunto altri argomenti JVM Gradle al file gradle.properties, puoi aggiungere questa proprietà alla stessa riga come mostrato nell'esempio seguente:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. Riavvia Android Studio per applicare le modifiche.
  4. Fai clic su Sincronizza progetto con file Gradle per sincronizzare il progetto.

Problemi di aggiornamento dell'IDE su Windows

Su Windows, i file in uso da un processo non possono essere eliminati. Quando tenti di utilizzare il meccanismo di aggiornamento integrato nell'IDE, a volte si rifiuta di installare l'aggiornamento, in genere fornendo un messaggio di errore come "Impossibile eliminare C:\some\path\file".

Per risolvere il problema, apri Task Manager e prova a terminare i processi che potrebbero utilizzare il file, ad esempio tutti i daemon Gradle.

Problemi relativi a minSdkVersion

Se utilizzi una versione obsoleta delle librerie di supporto Android, potresti ricevere un messaggio di errore simile al seguente:

: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

Per risolvere il problema, utilizza SDK Manager per eseguire l'aggiornamento alle versioni più recenti (non di anteprima) delle librerie di supporto Android. Per ulteriori informazioni sulla configurazione delle librerie di supporto, vedi Configurazione della libreria di supporto.

Problemi con l'emulatore Android

Consulta la sezione Risoluzione dei problemi relativi all'emulatore Android.

Elenchi

Le seguenti directory vengono utilizzate da Android Studio per archiviare impostazioni, cache, plug-in e log.

Windows

  • Configurazione (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Plug-in (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • Sistema (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Log (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% Esempio: C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% Esempio: C:\Users\YourUserName\AppData\Local

macOS

  • Configurazione (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Plug-in (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • Sistema (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Log (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Configurazione (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Plug-in (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • Sistema (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Log (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Ogni directory è elencata nel seguente formato:

Sostituisci:

  • AndroidStudio con il nome del prodotto, che è AndroidStudio per le release stabili o AndroidStudioPreview per le release RC e Canary.
  • VERSION con la versione. Ad esempio: 2023.1 o 2023.3.