Android Studio fornisce procedure guidate e modelli che verificano i requisiti di sistema, ad esempio il Java Development Kit (JDK) e la RAM disponibile, e che configura le impostazioni predefinite, come l'emulazione di un dispositivo virtuale Android (AVD) predefinito ottimizzato e le immagini di sistema aggiornate. Questo documento descrive le impostazioni di configurazione aggiuntive per personalizzare l'utilizzo di Android Studio.
Android Studio consente di accedere a due file di configurazione tramite il menu Guida:
studio.vmoptions: personalizza le opzioni per la Java Virtual Machine (JVM) di Android Studio, ad esempio dimensioni heap e dimensioni della cache. Tieni presente che sui computer Linux questo file potrebbe essere denominatostudio64.vmoptions, a seconda della versione di Android Studio.idea.properties: personalizza le proprietà di Android Studio, ad esempio il percorso della cartella dei plug-in o la dimensione massima dei file supportata.
Per la documentazione specifica sulla configurazione e sull'utilizzo di emulatori e dispositivi, consulta i seguenti argomenti:
- Creare e gestire dispositivi virtuali
- Eseguire app su un dispositivo hardware
- Installare i driver USB OEM
Trovare i file di configurazione
Entrambi i file di configurazione sono archiviati nella directory di configurazione di Android Studio. Per trovare la directory di configurazione, consulta Directory.
Puoi utilizzare le seguenti variabili di ambiente per indirizzare altri file di override specifici:
STUDIO_VM_OPTIONS: imposta il nome e la posizione del file.vmoptions.STUDIO_PROPERTIES: imposta il nome e la posizione del file.properties.
Puoi configurare quali JDK vengono utilizzati visitando la pagina Versioni Java nelle build Android.
Personalizza le opzioni delle VM
Il file studio.vmoptions ti consente di personalizzare le opzioni per la JVM di Android Studio. Per migliorare le prestazioni di Android Studio, l'opzione di regolazione più comune è la dimensione massima dello heap, ma puoi utilizzare il file studio.vmoptions anche per sostituire altre impostazioni predefinite, come le dimensioni heap iniziali, le dimensioni della cache e le opzioni di garbage collection Java.
Per creare un nuovo file studio.vmoptions o aprire quello esistente:
- Fai clic su Guida > Modifica opzioni VM personalizzate. Se non hai mai modificato le opzioni VM per Android Studio, l'IDE ti chiede di creare un nuovo file
studio.vmoptions. Fai clic su Crea per creare il file. - Il file
studio.vmoptionssi apre nella finestra dell'editor di Android Studio. Modifica il file per aggiungere le opzioni personalizzate della VM. Per un elenco completo delle opzioni JVM personalizzabili, consulta la pagina delle opzioni Java HotSpot VM di Oracle.
Il file studio.vmoptions che crei viene aggiunto al file studio.vmoptions predefinito, che si trova nella directory bin/ all'interno della cartella di installazione di Android Studio.
Non modificare direttamente il file studio.vmoptions che si trova
nella cartella del programma di Android Studio. Puoi accedere al file per visualizzare le opzioni VM predefinite di Android Studio, ma se modifichi solo il tuo file studio.vmoptions, puoi assicurarti di non sostituire importanti impostazioni predefinite per Android Studio. Pertanto, nel file studio.vmoptions, esegui l'override solo degli attributi che ti interessano e lascia che Android Studio continui a utilizzare i valori predefiniti per gli attributi che non hai modificato.
Dimensione heap massima
Per impostazione predefinita, Android Studio ha una dimensione heap massima di 1280 MB. Se lavori su un progetto di grandi dimensioni o se il tuo sistema ha molta RAM, puoi migliorare le prestazioni aumentando la dimensione heap massima per i processi di Android Studio, ad esempio l'IDE principale, il daemon Gradle e il daemon Kotlin.
Android Studio verifica automaticamente la presenza di possibili ottimizzazioni delle dimensioni heap e ti avvisa se rileva che il rendimento può essere migliorato.
Figura 1. Una notifica sulle impostazioni di memoria consigliate.
Se utilizzi un sistema a 64 bit con almeno 5 GB di RAM, puoi anche regolare manualmente le dimensioni heap del progetto. A tale scopo, procedi nel seguente modo:
- Fai clic su File > Impostazioni dalla barra dei menu (Android Studio > Preferenze su macOS).
Fai clic su Aspetto e comportamento > Impostazioni di sistema > Impostazioni memoria.
Figura 2. Configura la quantità massima di RAM nelle impostazioni di memoria.
Regola le dimensioni dello heap.
Fai clic su Applica.
Se modifichi la dimensione heap per l'IDE, devi riavviare Android Studio prima che vengano applicate le nuove impostazioni di memoria.
Esporta e importa le impostazioni IDE
Puoi esportare un file Settings.jar contenente tutte o un sottoinsieme delle tue
impostazioni IDE preferite per un progetto. Puoi quindi importare il file JAR negli altri progetti e/o rendere il file JAR disponibile ai colleghi per l'importazione nei loro progetti.
Per ulteriori informazioni, consulta la pagina relativa alla condivisione delle impostazioni IDE su IntelliJ IDEA.
Personalizza le proprietà IDE
Il file idea.properties ti consente di personalizzare le proprietà IDE per Android Studio, come il percorso dei plug-in installati dall'utente e le dimensioni massime dei file supportate dall'IDE. Il file idea.properties viene unito alle proprietà predefinite dell'IDE, quindi puoi specificare solo le proprietà di override.
Per creare un nuovo file idea.properties o aprire quello esistente, segui questi passaggi:
- Fai clic su Guida > Modifica proprietà personalizzate. Se non hai mai modificato le proprietà IDE, Android Studio ti chiede di creare un nuovo file
idea.properties. Fai clic su Sì per creare il file. - Il file
idea.propertiessi apre nella finestra dell'editor di Android Studio. Modifica il file per aggiungere le tue proprietà IDE personalizzate.
Il seguente file idea.properties include proprietà IDE comunemente personalizzate. Per un elenco completo delle proprietà, leggi informazioni sul file idea.properties per IntelliJ IDEA.
#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger the file is, the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features.
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise", then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6.
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff.
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480
Configura l'IDE per le macchine con memoria ridotta
Se esegui Android Studio su una macchina con specifiche non superiori a quelle consigliate (consulta i requisiti di sistema), puoi personalizzare l'IDE per migliorare le prestazioni sulla tua macchina nel seguente modo:
- Riduci la dimensione heap massima disponibile per Android Studio: riduci la dimensione massima dell'heap per Android Studio a 512 MB. Per ulteriori informazioni sulla modifica della dimensione massima dell'heap, consulta Dimensioni massime dello heap.
- Aggiornamento di Gradle e del plug-in Android Gradle: esegui l'aggiornamento alle versioni più recenti di Gradle e del plug-in Android Gradle per sfruttare gli ultimi miglioramenti delle prestazioni. Per ulteriori informazioni sull'aggiornamento di Gradle e del plug-in Android Gradle, consulta le note di rilascio del plug-in Android per Gradle.
- Attiva modalità di risparmio energetico: attiva la modalità di risparmio energetico per disattivare una serie di operazioni in background che consumano molta memoria e batteria, tra cui l'evidenziazione degli errori e le ispezioni in tempo reale, il completamento automatico del codice popup e la compilazione automatica incrementale in background. Per attivare questa modalità, fai clic su File > Modalità di risparmio energetico.
Disattiva i controlli lint non necessari: per modificare i controlli lint non necessari:
- Fai clic su File > Impostazioni (su macOS, Android Studio > Preferenze) per aprire la finestra di dialogo Impostazioni.
- Nel riquadro a sinistra, espandi la sezione Editor e fai clic su Ispezioni.
- Fai clic sulle caselle di controllo per selezionare o deselezionare i controlli lint in base alle esigenze del tuo progetto.
- Fai clic su Applica o OK per salvare le modifiche.
Debug su un dispositivo fisico: migliora le prestazioni generali di Android Studio eseguendo il debug su un dispositivo fisico. Il debug su un emulatore utilizza più memoria che il debug su un dispositivo fisico.
Includi solo i servizi Google Play necessari come dipendenze: includi solo Google Play Services necessario come dipendenze nel progetto. Le dipendenze aumentano la quantità di memoria necessaria, quindi limitarle migliora l'utilizzo e le prestazioni della memoria. Per maggiori informazioni, consulta Dichiarare le dipendenze per Google Play Services.
Riduci la dimensione massima dell'heap disponibile per Gradle: riduci il valore predefinito di 1536 MB del valore predefinito di 1536 MB sostituendo la proprietà
org.gradle.jvmargsnel filegradle.properties, come mostrato di seguito:# Make sure to gradually decrease this value and note # changes in performance. Allocating too little memory can # also decrease performance. org.gradle.jvmargs = -Xmx1536mAssicurati che la compilazione parallela non sia abilitata: Android Studio può compilare moduli indipendenti in parallelo, ma lascia questa funzionalità disabilitata se hai un sistema con memoria ridotta. Per controllare questa impostazione:
- Fai clic su File > Impostazioni (su macOS, Android Studio > Preferenze) per aprire la finestra di dialogo Impostazioni.
- Nel riquadro a sinistra, espandi Build, Execution, Deployment e fai clic su Compilatore.
- Assicurati che l'opzione Compila moduli indipendenti in parallelo sia deselezionata.
- Se hai apportato una modifica, fai clic su Applica o OK per applicarla.
Configura le impostazioni del proxy
I proxy fungono da punti di connessione intermedi tra i client HTTP e i server web che aggiungono sicurezza e privacy alle connessioni a internet.
Per supportare l'esecuzione di Android Studio protetta da un firewall, usa la pagina delle impostazioni del proxy HTTP dell'IDE di Android Studio per configurare le impostazioni del proxy HTTP.
Quando esegui il plug-in Android per Gradle dalla riga di comando o su computer su cui Android Studio non è installato, ad esempio server di integrazione continua, configura le impostazioni del proxy nel file di build Gradle.
Configurare il proxy di Android Studio
Android Studio supporta le impostazioni del proxy HTTP per permetterti di eseguire Android Studio dietro un firewall o una rete protetta. Per configurare le impostazioni del proxy HTTP in Android Studio:
- Dalla barra dei menu, fai clic su File > Impostazioni (su macOS, fai clic su Android Studio > Preferenze).
- Nel riquadro a sinistra, fai clic su Aspetto e comportamento > Impostazioni di sistema > Proxy HTTP. Viene visualizzata la pagina Proxy HTTP.
- Seleziona Rileva automaticamente impostazioni proxy per utilizzare un URL di configurazione automatica del proxy per le impostazioni del proxy oppure Configurazione manuale del proxy per inserire manualmente ogni impostazione. Per una spiegazione dettagliata di queste impostazioni, vedi Proxy HTTP.
- Fai clic su Applica o OK per applicare le modifiche.
Plug-in Android per le impostazioni del proxy HTTP Gradle
Quando esegui il plug-in Android dalla riga di comando o su computer in cui Android Studio non è installato, imposta le impostazioni proxy del plug-in Android Gradle nel file di build Gradle.
Per le impostazioni del proxy HTTP specifiche per l'applicazione, configura le impostazioni del proxy nel file build.gradle come necessario per ogni modulo dell'applicazione:
plugins {
id 'com.android.application'
}
android {
...
defaultConfig {
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=userid
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
}
...
}
Per le impostazioni del proxy HTTP a livello di progetto, configura le impostazioni del proxy nel file gradle/gradle.properties:
# Project-wide Gradle settings.
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain
...
Per informazioni sull'utilizzo delle proprietà Gradle per le impostazioni del proxy, consulta la Guida dell'utente di Gradle.
Ottimizzare il rendimento di Android Studio su Windows
Le prestazioni di Android Studio su Windows possono essere influenzate da diversi fattori. Questa sezione descrive come ottimizzare le impostazioni di Android Studio per ottenere le migliori prestazioni possibili su Windows.
Riduci al minimo l'impatto del software antivirus sulla velocità della build
Alcuni software antivirus possono interferire con il processo di compilazione di Android Studio, causando un rallentamento delle build. Quando esegui una build in Android Studio, Gradle compila le risorse e il codice sorgente dell'app e poi pacchettizza le risorse compilate insieme in un APK o AAB. Durante questa procedura, vengono creati molti file sul tuo computer. Se per il software antivirus è attiva l'analisi in tempo reale, il software antivirus può forzare l'interruzione del processo di compilazione ogni volta che viene creato un file mentre ne esegue la scansione.
Per evitare questo problema, puoi escludere determinate directory dall'analisi in tempo reale nel software antivirus. Per Windows, Build Analyzer può aiutarti a identificare le directory che devono essere escluse dalla scansione attiva ed escluderle.
Il seguente elenco mostra la posizione predefinita di ogni directory di Android Studio che puoi escludere dalla scansione in tempo reale:
- Cache Gradle
%USERPROFILE%\.gradle- Progetti Android Studio
%USERPROFILE%\AndroidStudioProjects- SDK Android
%USERPROFILE%\AppData\Local\Android\SDK
File di sistema di Android Studio
Sintassi: %LOCALAPPDATA%\Google\<product><version>
Esempio: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1
Personalizza le posizioni delle directory per gli ambienti controllati da Criteri di gruppo
Se un Criteri di gruppo limita le directory che puoi escludere dalla scansione in tempo reale sul computer, puoi spostare le directory di Android Studio in una delle posizioni già escluse dai Criteri di gruppo centralizzati.
Il seguente elenco mostra come personalizzare la posizione di ogni directory di Android Studio, dove C:\WorkFolder è la directory già esclusa dai criteri di gruppo:
- Cache Gradle
- Definisci la variabile di ambiente
GRADLE_USER_HOMEche deve puntare aC:\WorkFolder\.gradle. - Progetti Android Studio
- Sposta o crea directory di progetto in una sottodirectory appropriata di
C:\WorkFolder. Ad esempio,C:\WorkFolder\AndroidStudioProjects. - SDK Android
Per personalizzare la posizione:
In Android Studio, apri la finestra di dialogo Impostazioni (Preferenze su MacOS), quindi vai a Aspetto e comportamento > Impostazioni di sistema > SDK Android.
Cambia il valore di Posizione SDK Android in
C:\WorkFolder\AndroidSDK.Per evitare di scaricare di nuovo l'SDK, copia la directory dell'SDK esistente, che si trova per impostazione predefinita su
%USERPROFILE%\AppData\Local\Android\SDK, nella nuova posizione.
- File di sistema di Android Studio
Per personalizzare la posizione:
In Android Studio, fai clic su Guida > Modifica proprietà personalizzate.
Android Studio ti chiede di creare un file
idea.propertiesse non ne hai già uno.Aggiungi la seguente riga al tuo file
idea.properties:idea.system.path=c:/workfolder/studio/caches/trunk-system