Android Studio fornisce procedure guidate e modelli che verificano i requisiti di sistema, ad esempio Java Development Kit (JDK) e la RAM disponibile, e configurano impostazioni predefinite, come l'emulazione predefinita di dispositivi virtuali Android (AVD) e 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 cache. Tieni presente che sui computer Linux questo file potrebbe chiamarsistudio64.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 le dimensioni massime dei file supportate.
Per la documentazione specifica sull'emulatore e sulla configurazione e sull'utilizzo del dispositivo, 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 per Android Studio. Per trovare la directory di configurazione, consulta Directory.
Puoi utilizzare le seguenti variabili di ambiente per puntare a file di override specifici altrove:
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 i JDK utilizzati visitando la pagina Versioni Java nelle build di Android.
Personalizza le opzioni della 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 modifica più comune è la dimensione massima dello heap, ma puoi anche utilizzare il file studio.vmoptions per eseguire l'override di altre impostazioni predefinite, come dimensioni iniziali dello heap, dimensioni della cache e 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 prima 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 per la VM. Per un elenco completo delle opzioni JVM personalizzabili, consulta la pagina delle opzioni JVM Java HotSpot 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. Anche se puoi accedere al file per visualizzare le opzioni VM predefinite di Android Studio, la modifica del solo file studio.vmoptions garantisce di non eseguire l'override di importanti impostazioni predefinite per Android Studio. Pertanto, nel file studio.vmoptions, sostituisci solo gli attributi che ti interessano e consenti ad Android Studio di continuare a utilizzare i valori predefiniti per gli attributi che non hai modificato.
Dimensione massima heap
Per impostazione predefinita, Android Studio ha una dimensione massima dello heap di 1280 MB. Se stai lavorando su un progetto di grandi dimensioni o se il tuo sistema ha molta RAM, puoi migliorare le prestazioni aumentando la dimensione massima dell'heap 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 dello heap e ti invia una notifica se rileva che le prestazioni possono essere migliorate.
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 dello heap per il tuo progetto. A tale scopo, procedi nel seguente modo:
- Fai clic su File > Impostazioni nella 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 della memoria.
Regola le dimensioni dello heap.
Fai clic su Applica.
Se modifichi le dimensioni dello heap per l'IDE, devi riavviare Android Studio prima che vengano applicate le nuove impostazioni della memoria.
Esporta e importa impostazioni IDE
Puoi esportare un file Settings.jar che contiene tutte o un sottoinsieme delle
impostazioni IDE preferite per un progetto. Puoi quindi importare il file JAR negli altri progetti e/o rendere il file JAR disponibile per consentire ai colleghi di importarlo nei loro progetti.
Per ulteriori informazioni, consulta la pagina sulla condivisione delle impostazioni dell'IDE su IntelliJ IDEA.
Personalizzare le proprietà IDE
Il file idea.properties ti consente di personalizzare le proprietà IDE per Android
Studio, ad esempio il percorso dei plug-in installati dall'utente e le dimensioni massime dei file
supportate dall'IDE. Il file idea.properties è unito alle proprietà predefinite per l'IDE, quindi puoi specificare solo le proprietà di override.
Per creare un nuovo file idea.properties o aprire quello esistente:
- Fai clic su Guida > Modifica proprietà personalizzate. Se non hai mai modificato prima 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 le 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 un computer con specifiche inferiori a quelle consigliate (vedi i requisiti di sistema), puoi personalizzare l'IDE per migliorare le prestazioni sul computer nel seguente modo:
- Riduci la dimensione massima dello heap disponibile per Android Studio: riduci la dimensione massima dello heap per Android Studio a 512 MB. Per ulteriori informazioni sulla modifica della dimensione massima dell'heap, consulta Dimensione massima heap.
- Aggiorna Gradle e il 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 maggiori informazioni sull'aggiornamento di Gradle e del plug-in Android Gradle, consulta le note di rilascio del plug-in Android Gradle.
- Abilita modalità di risparmio energetico. Attiva la modalità di risparmio energetico per disattivare alcune operazioni in background che consumano molta memoria e batteria, tra cui l'evidenziazione degli errori e ispezioni immediate, il completamento automatico del codice popup e la compilazione automatica incrementale dello sfondo. Per attivare la modalità di risparmio energetico, fai clic su File > Modalità di risparmio energetico.
Disattiva i controlli lint non necessari: per modificare i controlli lint eseguiti da Android Studio sul tuo codice, procedi nel seguente modo:
- 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 appropriati per il tuo progetto.
- Fai clic su Applica o su OK per salvare le modifiche.
Debug su un dispositivo fisico: migliora le prestazioni complessive per Android Studio eseguendo il debug su un dispositivo fisico. Il debug su un emulatore utilizza più memoria rispetto al 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 la loro limitazione migliora l'utilizzo e le prestazioni della memoria. Per maggiori informazioni, consulta la pagina Dichiarare le dipendenze per Google Play Services.
Riduci la dimensione massima dello heap disponibile per Gradle: riduci il valore della dimensione massima dello heap di Gradle rispetto al 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 verificare 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 Compiler.
- Assicurati che l'opzione Compila moduli indipendenti in parallelo sia deselezionata.
- Se hai apportato una modifica, fai clic su Applica o su OK per applicare la modifica.
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 internet.
Per supportare l'esecuzione di Android Studio dietro un firewall, utilizza la pagina delle impostazioni del proxy HTTP 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 macchine in cui Android Studio non è installato, ad esempio i server di integrazione continua, configura le impostazioni del proxy nel file di build Gradle.
Configurare il proxy Android Studio
Android Studio supporta le impostazioni del proxy HTTP, che ti consentono di eseguire Android Studio dietro un firewall o una rete protetta. Per configurare le impostazioni del proxy HTTP in Android Studio:
- Nella 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 personalmente ciascuna 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 macchine in cui Android Studio non è installato, imposta le impostazioni del proxy del plug-in Android per 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 richiesto 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 le prestazioni 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, riducendo notevolmente l'esecuzione delle build. Quando esegui una build in Android Studio, Gradle compila le risorse e il codice sorgente dell'app, quindi pacchettizza le risorse compilate in un APK o AAB. Durante questo processo, molti file vengono creati sul tuo computer. Se nel software antivirus è attiva la scansione in tempo reale, il software antivirus può forzare l'interruzione del processo di compilazione ogni volta che viene creato un file durante la scansione.
Per evitare questo problema, puoi escludere determinate directory dalla scansione in tempo reale nel software antivirus. Per Windows, Build Analyzer può aiutarti a identificare le directory che devono essere escluse dalla scansione attiva e a 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 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 criterio 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 dal criterio di gruppo centralizzato.
Il seguente elenco mostra come personalizzare la posizione di ogni directory di Android Studio, dove C:\WorkFolder è la directory già esclusa dal tuo criterio di gruppo:
- Cache Gradle
- Definisci la variabile di ambiente
GRADLE_USER_HOMEche punti aC:\WorkFolder\.gradle. - Progetti Android Studio
- Sposta o crea le directory del progetto in una sottodirectory appropriata di
C:\WorkFolder. Ad esempio,C:\WorkFolder\AndroidStudioProjects. - SDK Android
Per personalizzare la posizione, procedi nel seguente modo:
In Android Studio, apri la finestra di dialogo Impostazioni (Preferenze su macOS) e seleziona Aspetto e comportamento > Impostazioni di sistema > SDK per Android.
Modifica il valore di Posizione SDK Android in
C:\WorkFolder\AndroidSDK.Per evitare di scaricare di nuovo l'SDK, copia nella nuova posizione la directory dell'SDK esistente, che si trova all'indirizzo
%USERPROFILE%\AppData\Local\Android\SDKper impostazione predefinita.
- File di sistema Android Studio
Per personalizzare la posizione, procedi nel seguente modo:
In Android Studio, fai clic su Guida > Modifica proprietà personalizzate.
Se non ne hai già uno, Android Studio ti chiede di creare un file
idea.properties.Aggiungi la seguente riga al file
idea.properties:idea.system.path=c:/workfolder/studio/caches/trunk-system