Configura Android Studio

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 configurano le impostazioni predefinite, ad esempio un'emulazione Android Virtual Device (AVD) predefinita ottimizzata e immagini di sistema aggiornate. Questo documento descrive le impostazioni di configurazione aggiuntive per personalizzare l'utilizzo di Android Studio.

Android Studio fornisce l'accesso a due file di configurazione tramite il menu Guida:

• studio.vmoptions: personalizza le opzioni per la JVM (Java Virtual Machine) di Android Studio, ad esempio la dimensione dell'heap e della cache. Tieni presente che su macchine Linux questo file potrebbe essere denominato studio64.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 sulla configurazione e sull'utilizzo dell'emulatore e 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 memorizzati nella directory di configurazione di Android Studio. Per trovare la directory di configurazione, consulta Directory.

Nota: per individuare rapidamente la directory di configurazione, vai a Guida > Modifica opzioni VM personalizzate o Guida > Modifica proprietà personalizzate in Android Studio. Si apre un file di configurazione. Controlla il percorso del file di configurazione per trovare la directory di configurazione.

Puoi utilizzare le seguenti variabili di ambiente per fare riferimento 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 da utilizzare visitando Versioni Java nelle build Android.

Personalizzare 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 più comune da modificare è la dimensione massima dell'heap, ma puoi anche utilizzare il file studio.vmoptions per sostituire altre impostazioni predefinite, come la dimensione dell'heap iniziale, la dimensione della cache e gli switch per la raccolta dei rifiuti di Java.

Per creare un nuovo file studio.vmoptions o aprirne uno esistente, segui questi passaggi:

1. 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.
2. Il file studio.vmoptions si apre nella finestra dell'editor di Android Studio. Modifica il file per aggiungere le opzioni VM personalizzate. Per un elenco completo delle opzioni JVM personalizzabili, consulta la pagina Opzioni VM 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 trovato nella cartella del programma Android Studio. Sebbene tu possa accedere al file per visualizzare le opzioni della VM predefinite di Android Studio, la modifica solo del tuo file studio.vmoptions ti consente di non sostituire le impostazioni predefinite importanti per Android Studio. Pertanto, nel file studio.vmoptions, override solo gli attributi che ti interessano e lascia che Android Studio continui a utilizzare i valori predefiniti per gli attributi che non hai modificato.

Dimensioni massime dell'heap

Per impostazione predefinita, Android Studio ha una dimensione massima dell'heap di 1280 MB. Se stai lavorando su un progetto di grandi dimensioni o il tuo sistema ha molta RAM, puoi migliorare le prestazioni aumentando la dimensione massima dell'heap per i processi di Android Studio, come l'IDE di base, il daemon Gradle e il daemon Kotlin.

Android Studio controlla automaticamente le possibili ottimizzazioni delle dimensioni dell'heap e ti invia una notifica se rileva che il rendimento può essere migliorato.

Figura 1. Una notifica relativa alle impostazioni di memoria consigliate.

Se utilizzi un sistema a 64 bit con almeno 5 GB di RAM, puoi anche modificare manualmente le dimensioni dell'heap per il tuo progetto. A tale scopo, procedi nel seguente modo:

1. Fai clic su File > Impostazioni nella barra dei menu (Android Studio > Preferenze su macOS).

2. Fai clic su Aspetto e comportamento > Impostazioni di sistema > Impostazioni memoria.

   

   Figura 2. Configura la quantità massima di RAM nelle impostazioni della memoria.

3. Modifica le dimensioni dell'heap.

4. Fai clic su Applica.

   Se modifichi la dimensione dell'heap per l'IDE, devi riavviare Android Studio prima che vengano applicate le nuove impostazioni di memoria.

Nota: l'allocazione di troppa memoria può ridurre le prestazioni.

Esportare e importare le impostazioni dell'IDE

Puoi esportare un file Settings.jar contenente tutte o alcune delle impostazioni IDE preferite per un progetto. Puoi quindi importare il file JAR negli altri progetti e/o renderlo disponibile ai colleghi per l'importazione nei loro progetti.

Per ulteriori informazioni, consulta Condividere le impostazioni dell'IDE in IntelliJ IDEA.

Personalizzare le proprietà dell'IDE

Il file idea.properties consente di personalizzare le proprietà dell'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 viene unito alle proprietà predefinite per l'IDE, quindi puoi specificare solo le proprietà di override.

Per creare un nuovo file idea.properties o per aprire un file esistente, segui questi passaggi:

1. 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.
2. Il file idea.properties si apre nella finestra dell'editor di Android Studio. Modifica il file per aggiungere le proprietà IDE personalizzate.

Il seguente file idea.properties include le proprietà IDE personalizzate più comuni. Per un elenco completo delle proprietà, consulta la sezione relativa al 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

Configurare l'IDE per macchine con poca memoria

Se utilizzi Android Studio su un computer con specifiche inferiori a quelle consigliate (consulta i requisiti di sistema), puoi personalizzare l'IDE per migliorare le prestazioni del computer nel seguente modo:

• Riduci la dimensione massima dell'heap disponibile per Android Studio: riduci la dimensione massima dell'heap per Android Studio a 512 MB. Per ulteriori informazioni su come modificare la dimensione massima dell'heap, consulta Dimensione massima dell'heap.
• Aggiorna Gradle e il plug-in Android per Gradle:esegui l'aggiornamento alle ultime versioni di Gradle e del plug-in Android per Gradle per usufruire dei più recenti miglioramenti delle prestazioni. Per ulteriori informazioni sull'aggiornamento di Gradle e del plug-in Android per Gradle, consulta le note di rilascio del plug-in Android per Gradle.
• Attiva la modalità di risparmio energetico:attiva la modalità di risparmio energetico per disattivare una serie di operazioni in background che richiedono 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 incrementale automatica in background. Per attivare la modalità di risparmio energetico, fai clic su File > Modalità risparmio energetico.

• Disattiva i controlli lint non necessari:per modificare i controlli lint eseguiti da Android Studio sul codice:

  1. Fai clic su File > Impostazioni (su macOS, Android Studio > Preferenze) per aprire la finestra di dialogo Impostazioni.
  2. Nel riquadro a sinistra, espandi la sezione Editor e fai clic su Ispezioni.
  3. Fai clic sulle caselle di controllo per selezionare o deselezionare i controlli lint in base alle esigenze del tuo progetto.
  4. Fai clic su Applica o OK per salvare le modifiche.

• Esegui il debug su un dispositivo fisico:migliora le prestazioni complessive di Android Studio esegui 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 nel tuo progetto solo i servizi Google Play necessari come dipendenze. Le dipendenze aumentano la quantità di memoria necessaria, quindi limitarle migliora l'utilizzo della memoria e le prestazioni. Per ulteriori informazioni, consulta Dichiarare le dipendenze per Google Play Services.

• Riduci la dimensione massima dell'heap disponibile per Gradle: riduci il valore della dimensione massima dell'heap di Gradle dal valore predefinito di 1536 MB sostituendo la proprietà org.gradle.jvmargs nel file gradle.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 = -Xmx1536m
  

• Assicurati che la compilazione parallela non sia abilitata: Android Studio può compilare moduli indipendenti in parallelo, ma lascia questa funzionalità disattivata se hai un sistema con poca memoria. Per controllare questa impostazione:

  1. Fai clic su File > Impostazioni (su macOS, Android Studio > Preferenze) per aprire la finestra di dialogo Impostazioni.
  2. Nel riquadro a sinistra, espandi Compilazione, esecuzione, implementazione e poi fai clic su Compilatore.
  3. Assicurati che l'opzione Compila moduli indipendenti in parallelo non sia selezionata.
  4. Se hai apportato una modifica, fai clic su Applica o Ok per applicarla.

Impostare le impostazioni del proxy

I proxy fungono da punti di connessione intermedi tra client HTTP e server web che aggiungono sicurezza e privacy alle connessioni a internet.

Per supportare l'esecuzione di Android Studio dietro un firewall, utilizza la pagina Impostazioni proxy HTTP IDE di Android Studio per impostare le impostazioni del proxy HTTP.

Quando esegui il plug-in Android per Gradle dalla riga di comando o su macchine su cui non è installato Android Studio, ad esempio i server di integrazione continua, imposta le impostazioni del proxy nel file di compilazione Gradle.

Nota: dopo l'installazione iniziale del bundle di Android Studio, Android Studio può essere eseguito con accesso a internet o offline. Tuttavia, Android Studio richiede una connessione a internet per la sincronizzazione della configurazione guidata, l'accesso alle librerie di terze parti, l'accesso ai repository remoti, l'inizializzazione e la sincronizzazione di Gradle e gli aggiornamenti della versione di Android Studio.

Configurare il proxy di Android Studio

Android Studio supporta le impostazioni proxy HTTP, quindi puoi eseguire Android Studio dietro un firewall o una rete sicura. Per impostare le impostazioni del proxy HTTP in Android Studio:

1. Nella barra dei menu, fai clic su File > Impostazioni (su macOS, fai clic su Android Studio > Preferenze).
2. Nel riquadro a sinistra, fai clic su Aspetto e comportamento > Impostazioni di sistema > Proxy HTTP. Viene visualizzata la pagina Proxy HTTP.
3. Seleziona Rileva automaticamente le impostazioni proxy per utilizzare un URL di configurazione automatica del proxy per le impostazioni del proxy o Configurazione manuale del proxy per inserire autonomamente ciascuna delle impostazioni. Per una spiegazione dettagliata di queste impostazioni, vedi Proxy HTTP.
4. Fai clic su Applica o Ok per applicare le modifiche.

Impostazioni del proxy HTTP del plug-in Android per Gradle

Quando esegui il plug-in Android dalla riga di comando o su macchine su cui non è installato Android Studio, imposta le impostazioni del proxy del plug-in Android Gradle nel file di compilazione Gradle.

Per le impostazioni del proxy HTTP specifiche dell'applicazione, imposta le impostazioni del proxy nel build.gradle file 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, imposta le impostazioni del proxy nel gradle/gradle.properties file:

# 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 proxy, consulta la Guida dell'utente di Gradle.

Nota: quando utilizzi Android Studio, le impostazioni nella pagina delle impostazioni del proxy HTTP dell'IDE Android Studio sostituiscono le impostazioni del proxy HTTP nel filegradle.properties.

Ottimizzare il rendimento di Android Studio su Windows

Le prestazioni di Android Studio su Windows possono essere influenzate da una serie di fattori. Questa sezione descrive come ottimizzare le impostazioni di Android Studio per ottenere il miglior rendimento possibile su Windows.

Riduci al minimo l'impatto del software antivirus sulla velocità di compilazione

Alcuni software antivirus possono interferire con il processo di compilazione di Android Studio, inducendo le compilazioni a essere notevolmente più lente. Quando esegui una compilazione in Android Studio, Gradle compila le risorse e il codice sorgente dell'app, quindi pacchettizza le risorse compilate in un APK o AAB. Durante questa procedura, sul computer vengono creati molti file. Se nel software antivirus è attivata la scansione in tempo reale, il software può interrompere forzatamente il 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 ricerca attiva ed escluderle.

Attenzione: per assicurarti che il tuo computer sia al sicuro da software dannosi, non disattivare completamente la scansione in tempo reale o il software antivirus.

L'elenco seguente mostra la posizione predefinita di ogni directory di Android Studio che puoi escludere dalla scansione in tempo reale:

Cache di 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

Personalizzare le posizioni delle directory per gli ambienti controllati dai criteri di gruppo

Se un criterio di gruppo limita le directory che puoi escludere dalla ricerca in tempo reale sul computer, puoi spostare le directory di Android Studio in una delle posizioni già escluse dal criterio di gruppo centralizzato.

L'elenco seguente mostra come personalizzare la posizione di ogni directory di Android Studio, dove C:\WorkFolder è la directory già esclusa dal criterio di gruppo:

Cache di Gradle

Definisci la variabile di ambiente GRADLE_USER_HOME a cui fare riferimento C:\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 località:

1. In Android Studio, apri la finestra di dialogo Impostazioni (Preferenze su macOS), quindi vai a Aspetto e comportamento > Impostazioni di sistema > SDK Android.

2. Modifica il valore di Posizione SDK Android inC:\WorkFolder\AndroidSDK.

   Per evitare di scaricare di nuovo l'SDK, copia la directory SDK esistente, che si trova in %USERPROFILE%\AppData\Local\Android\SDK per impostazione predefinita, nella nuova posizione.

File di sistema di Android Studio

Per personalizzare la località:

1. In Android Studio, fai clic su Guida > Modifica proprietà personalizzate.

   Android Studio ti chiede di creare un file idea.properties se non ne hai già uno.

2. Aggiungi la seguente riga al file idea.properties:

   idea.system.path=c:/workfolder/studio/caches/trunk-system