Configura Android Studio

Android Studio fornisce procedure guidate e modelli per la verifica del sistema standard quali il Java Development Kit (JDK) e la RAM disponibile, e configurare le impostazioni predefinite, ad esempio un Android Virtuale predefinito ottimizzato Emulazione della durata di visualizzazione media del dispositivo e immagini di sistema aggiornate. Questo documento descrive 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 Android Studio Java Virtual Machine (JVM), ad esempio dimensioni heap e 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 sull'emulatore e sulla configurazione e l'uso del dispositivo, vedi le 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. Viene aperto un file di configurazione. Controlla il percorso del file di configurazione per trovare la directory di configurazione.

Puoi usare le seguenti variabili di ambiente per puntare a specifiche sostituisci i file altrove:

• STUDIO_VM_OPTIONS: imposta il nome e la posizione del file .vmoptions.
• STUDIO_PROPERTIES: imposta il nome e la posizione del file .properties.

Per configurare i JDK utilizzati, visita Versioni Java nelle build di Android.

Personalizzare le opzioni della VM

Il file studio.vmoptions ti consente di personalizzare le opzioni per Android Studio e JVM. 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 Altre impostazioni predefinite come dimensioni heap iniziali, dimensioni della cache e garbage Java interruttori delle raccolte.

Per creare un nuovo file studio.vmoptions o aprire quello esistente: 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 personalizzate per la VM. 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 valore predefinito studio.vmoptions, che si trova nella directory bin/ all'interno di Android Cartella di installazione di Studio.

Non modificare direttamente il file studio.vmoptions trovato nella cartella del programma di Android Studio. Sebbene tu possa accedere al file per visualizzare le opzioni della VM predefinite di Android Studio, modificando solo il tuo file studio.vmoptions ti assicuri 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.

Dimensione massima 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 se il sistema ha molta RAM, puoi migliorare le prestazioni aumentando la dimensione massima dell'heap per i processi di Android Studio, come 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 le prestazioni possono essere migliorate.

Figura 1. Una notifica su impostazioni di memoria consigliate.

Se utilizzi un sistema a 64 bit con almeno 5 GB di RAM, puoi anche regolare 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 le dimensioni dello heap per l'IDE, devi riavviare Android Studio prima dell'applicazione delle nuove impostazioni della memoria.

Nota: allocare troppa memoria può ridurre le prestazioni.

Esportare e importare le impostazioni dell'IDE

Puoi esportare un file Settings.jar contenente tutte o un sottoinsieme 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, vedi Condividi impostazioni IDE di IntelliJ IDEA.

Personalizzare le proprietà dell'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 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 tue proprietà IDE personalizzate.

Il seguente file idea.properties include le proprietà IDE personalizzate più comuni. Per un elenco completo delle proprietà, leggi le informazioni sulle 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 esegui Android Studio su un computer con meno di specifiche (vedi i requisiti di sistema), puoi personalizzare l'IDE per migliorare le prestazioni sul tuo 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 sulla modifica dimensione massima heap, consulta Dimensione massima heap.
• Aggiorna Gradle e il plug-in Android Gradle:esegui l'aggiornamento all'ultima versione di Android Gradle e il plug-in Android Gradle sfruttare gli ultimi 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 modalità di risparmio energetico. Attiva la modalità di risparmio energetico per disattivare una serie di operazioni in background che consumano molta memoria e batteria, inclusi errori evidenziazioni e ispezioni immediate, completamento automatico del codice popup e la compilazione incrementale automatica in background. 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 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.

• Debug su un dispositivo fisico: migliora il rendimento complessivo 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 tuo progetto. 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à disabilitata se hai un 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 sia deselezionata.
  4. Se hai apportato una modifica, fai clic su Applica o OK affinché la modifica hanno effetto.

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 delle impostazioni del 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 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, l'accesso ai repository remoti, l'inizializzazione di Gradle e sincronizzazione e aggiornamenti della versione di Android Studio.

Configurare il proxy di Android Studio

Android Studio supporta le impostazioni del proxy HTTP per l'esecuzione di Android Studio un firewall o una rete protetta. 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 per l'applicazione, configura le impostazioni del proxy nella build.gradle file richiesto per ogni modulo di 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 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 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 le prestazioni 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, che rallentano notevolmente l'esecuzione delle build. 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 un AAB. Durante questo processo, vengono creati sul computer. 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 dai report scansione nel software antivirus. Per Windows: Lo Strumento di analisi Build può aiutarti a identificare le directory che devono essere escluse dalla scansione attiva ed escluderle.

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

Nell'elenco seguente viene mostrata 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

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 ricerca in tempo reale sul computer, puoi spostare le directory di Android Studio in una delle posizioni già escluse dal criterio di gruppo centralizzato.

Nell'elenco che segue viene spiegato come personalizzare la posizione di ogni Android Studio. directory, dove C:\WorkFolder è la directory il tuo criterio di gruppo esclude già:

Cache di Gradle

Definisci la variabile di ambiente GRADLE_USER_HOME a cui deve fare riferimento C:\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 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 Android SDK Location (Posizione SDK Android) in C:\WorkFolder\AndroidSDK.

   Per evitare di scaricare nuovamente l'SDK, copia quello esistente , situata nella cartella %USERPROFILE%\AppData\Local\Android\SDK per impostazione predefinita, nella nuova posizione.

File di sistema di Android Studio

Per personalizzare la posizione, procedi nel seguente modo:

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

   Se non lo fai, Android Studio ti chiede di creare un file idea.properties ne hai già uno.

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

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