Risolvere i problemi relativi ad Android Studio

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

Display ad alta densità

A partire dalla versione 1.5, Android Studio supporta 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 dell'interfaccia utente vengono ridimensionati del 200% e le immagini vengono visualizzate ad alta risoluzione. Anche nelle configurazioni su più monitor, non deve essere presente alcuna sfocatura dovuta alla scalabilità. Tieni presente che non è supportato per fattori di scalabilità diversi dal 100% (per i display non Retina) e dal 200% (per i display Retina).
Windows
Android Studio utilizza le impostazioni DPI del display principale per determinare il fattore di scalabilità degli elementi dell'interfaccia utente. Per le immagini, se il fattore di scalabilità è inferiore al 150%, le immagini con risoluzione normale vengono ingrandite. Se il fattore di scalabilità è superiore al 150%, le immagini ad alta risoluzione vengono ridimensionate in modo appropriato.
Linux
Android Studio determina il fattore di scalabilità esaminando il "Fattore di scalabilità del testo", quindi l'impostazione DPI del sistema XWindow.
Un'impostazione DPI pari a 96 corrisponde a un fattore di scalabilità del 100% (nessuna scalabilità), mentre un'impostazione DPI pari a 192 corrisponde a un fattore di scalabilità del 200% (la dimensione degli elementi UI è raddoppiata). Android Studio attualmente supporta le impostazioni DPI comprese tra 96 (scalabilità del 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 nella sezione 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 il DPI su 96 (scalabilità al 100%), ignorando le impostazioni di sistema.

Elementi sfocati o pixelati su display ad alta densità

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

  • Se la maggior parte dell'interfaccia utente di Android Studio ha un aspetto soddisfacente, ma un'icona specifica è sfocata o pixelata oppure un elemento specifico dell'interfaccia utente utilizza le dimensioni dei caratteri errate, è probabile che quell'elemento non sia stato ancora completamente aggiornato per il supporto di HiDPI. Segnala un bug facendo clic su Guida > Invia feedback. Includi uno screenshot e il maggior numero possibile di informazioni sulla configurazione del tuo sistema.
  • Se utilizzi un computer Windows o Linux e il display utilizza un fattore di scalabilità diverso dal 100% o dal 200%, le immagini potrebbero risultare leggermente sfocate a causa del ridimensionamento.
  • Se utilizzi un computer Windows e hai modificato le dimensioni del carattere di Windows nel pannello di controllo, il carattere potrebbe risultare 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 diverso, potresti riscontrare problemi di carattere o immagine (vedi il bug 186007). Al momento non esistono soluzioni alternative note.
  • Le versioni precedenti di JRE 1.8 presentavano un problema relativo ai caratteri sfocati (in particolare JRE 1.8.0_25-b18 amd64, vedi il bug 192316). A partire dalla versione 2.2, Android Studio include una versione in bundle dell'ultimo JDK supportato, che include il JDE. Per risolvere il problema, aggiorna Android Studio alla versione 2.2 o successive e passa all'utilizzo del JDK in bundle facendo clic su File > Struttura del progetto > Posizione SDK e selezionando la casella di controllo Usa JDK incorporato.

Elementi di dimensioni errate su display ad alta densità

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

  • Se utilizzi uno schema dell'editor personalizzato, il carattere dell'editor potrebbe sembrare troppo piccolo o troppo grande rispetto al resto degli elementi dell'interfaccia utente su uno schermo ad alta densità. Per risolvere il problema, fai clic su File > Impostazioni, poi fai clic 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 ridimensionate automaticamente (vedi il bug 186920).
  • Se alcuni elementi dell'interfaccia utente di Android Studio sono delle dimensioni corrette, ma altri sono troppo piccoli o troppo grandi, potrebbe essersi verificato il problema 186923. Segnala un bug facendo clic su Guida > Invia feedback. Includi uno screenshot e riporta quante più informazioni possibili sulla configurazione del sistema.

Problemi di sincronizzazione del progetto

Quando tenti di sincronizzare il tuo progetto, potresti ricevere il seguente messaggio di errore: "Connessione a internet negata. ('Autorizzazione negata: connetti')". 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 tuo 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 tuo progetto.

Problemi di aggiornamento dell'IDE su Windows

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

Per risolvere il problema, apri Task Manager e tenta di terminare i processi che potrebbero utilizzare il file, come i daemon Gradle.

Problemi relativi a minSdkVersion

Se utilizzi una versione obsoleta delle librerie di assistenza 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 in anteprima) delle librerie di assistenza Android. Per ulteriori informazioni sulla configurazione delle librerie di assistenza, consulta Configurazione della libreria di assistenza.

Problemi relativi all'emulatore Android

Vedi Risoluzione dei problemi dell'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
  • Esempio di %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • Esempio di %LOCALAPPDATA%: 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 beta e canary.
  • VERSION con la versione. Ad esempio: 2023.1 o 2023.3.