Skonfiguruj Android Studio

Android Studio udostępnia kreatory i szablony, które weryfikują wymagania systemowe, takie jak pakiet Java Development Kit (JDK) i dostępna pamięć RAM, oraz umożliwiają konfigurowanie ustawień domyślnych, takich jak zoptymalizowana domyślna emulacja wirtualnego urządzenia z Androidem (AVD) czy zaktualizowane obrazy systemu. W tym dokumencie znajdziesz opis dodatkowych ustawień konfiguracji, które pozwalają dostosować Android Studio do Twoich potrzeb.

Android Studio zapewnia dostęp do dwóch plików konfiguracji z menu Pomoc:

  • studio.vmoptions: dostosuj opcje maszyny wirtualnej Java (JVM) w Android Studio, takie jak rozmiar stosu i rozmiar pamięci podręcznej. Pamiętaj, że na komputerach z systemem Linux ten plik może nosić nazwę studio64.vmoptions w zależności od wersji Android Studio.
  • idea.properties: dostosuj właściwości Androida Studio, np. ścieżkę folderu wtyczek lub maksymalny obsługiwany rozmiar pliku.

Dokumentację na temat konfigurowania i używania emulatora oraz urządzenia znajdziesz w tych tematach:

Znajdowanie plików konfiguracji

Oba pliki konfiguracji są przechowywane w katalogu konfiguracji Android Studio. Aby znaleźć katalog konfiguracji, przeczytaj sekcję Katalogi.

Możesz użyć tych zmiennych środowiskowych, aby wskazać konkretne pliki zastępujące w innym miejscu:

  • STUDIO_VM_OPTIONS: ustaw nazwę i lokalizację pliku .vmoptions.
  • STUDIO_PROPERTIES: ustaw nazwę i lokalizację pliku .properties.

Możesz skonfigurować, które pakiety JDK mają być używane, na stronie Wersje Java w kompilacjach Androida.

Dostosowywanie opcji maszyny wirtualnej

Plik studio.vmoptions umożliwia dostosowanie opcji JVM w Android Studio. Aby zwiększyć wydajność Android Studio, najczęstszą opcją dostosowania jest maksymalny rozmiar stosu. Możesz też jednak użyć pliku studio.vmoptions, aby zastąpić inne ustawienia domyślne, takie jak początkowy rozmiar stosu, rozmiar pamięci podręcznej czy przełączniki czyszczenia pamięci Java.

Aby utworzyć nowy plik studio.vmoptions lub otworzyć istniejący, wykonaj te czynności:

  1. Kliknij Pomoc > Edytuj opcje niestandardowej maszyny wirtualnej. Jeśli opcje maszyn wirtualnych nie były wcześniej edytowane w Android Studio, IDE poprosi o utworzenie nowego pliku studio.vmoptions. Kliknij Utwórz, aby utworzyć plik.
  2. Plik studio.vmoptions otworzy się w oknie edytora w Android Studio. Edytuj plik, aby dodać niestandardowe opcje maszyn wirtualnych. Pełną listę opcji JVM z możliwością dostosowania znajdziesz na stronie opcji maszyn wirtualnych Java HotSpot Oracle.

Utworzony przez Ciebie plik studio.vmoptions zostanie dodany do domyślnego pliku studio.vmoptions, który znajduje się w katalogu bin/ w folderze instalacyjnym Android Studio.

Nie edytuj bezpośrednio pliku studio.vmoptions, który znajduje się w folderze programu Android Studio. Możesz otworzyć ten plik i wyświetlić domyślne opcje maszyny wirtualnej Android Studio, ale edycja własnego pliku studio.vmoptions gwarantuje, że nie zastąpisz ważnych ustawień domyślnych Android Studio. Dlatego w pliku studio.vmoptions zastąp tylko te atrybuty, na których Ci zależy, i zezwól Android Studio na używanie wartości domyślnych dla wszystkich atrybutów, których nie zmienisz.

Maksymalny rozmiar sterty

Domyślnie maksymalny rozmiar sterty w Android Studio to 1280 MB. Jeśli pracujesz nad dużym projektem lub Twój system ma dużo pamięci RAM, możesz zwiększyć wydajność, zwiększając maksymalny rozmiar stosu procesów w Android Studio, takich jak podstawowy IDE, demon Gradle czy demon Kotlin.

Android Studio automatycznie sprawdza, czy można zoptymalizować rozmiar stosu, i powiadamia Cię, jeśli wykryje, że można poprawić wydajność.

Ustawienia pamięci, które umożliwiają skonfigurowanie maksymalnej ilości pamięci RAM na potrzeby procesów Android Studio.

Rysunek 1. Powiadomienie o zalecanych ustawieniach pamięci.

Jeśli używasz 64-bitowego systemu z co najmniej 5 GB pamięci RAM, możesz też ręcznie dostosować rozmiar sterty w projekcie. Aby to zrobić:

  1. Na pasku menu kliknij Plik > Ustawienia (Android Studio > Ustawienia w systemie macOS).
  2. Kliknij Wygląd i działanie > Ustawienia systemu > Ustawienia pamięci.

    Ustawienia pamięci, które umożliwiają skonfigurowanie maksymalnej ilości pamięci RAM na potrzeby procesów Android Studio.

    Rysunek 2. Maksymalna ilość pamięci RAM możesz skonfigurować w ustawieniach pamięci.

  3. Dostosuj rozmiary sterty.

  4. Kliknij Zastosuj.

    Jeśli zmienisz rozmiar stosu dla IDE, musisz ponownie uruchomić Android Studio, zanim zostaną zastosowane nowe ustawienia pamięci.

Eksportowanie i importowanie ustawień IDE

Możesz wyeksportować plik Settings.jar, który zawiera wszystkie lub niektóre z Twoich preferowanych ustawień IDE w projekcie. Następnie możesz zaimportować plik JAR do innych projektów lub udostępnić plik JAR współpracownikom, aby zaimportować go do ich projektów.

Więcej informacji znajdziesz w sekcji o udostępnianiu ustawień IDE w witrynie IntelliJ IDEA.

Dostosuj właściwości IDE

Plik idea.properties umożliwia dostosowanie właściwości IDE dla Androida Studio, takich jak ścieżka do wtyczek zainstalowanych przez użytkownika oraz maksymalny rozmiar pliku obsługiwany przez IDE. Plik idea.properties jest scalony z domyślnymi właściwościami IDE, więc możesz określić tylko właściwości zastępowania.

Aby utworzyć nowy plik idea.properties lub otworzyć istniejący plik, wykonaj te czynności:

  1. Kliknij Pomoc > Edytuj właściwości niestandardowe. Jeśli właściwości IDE nie były wcześniej edytowane, Android Studio wyświetli prośbę o utworzenie nowego pliku idea.properties. Kliknij Tak, aby utworzyć plik.
  2. Plik idea.properties otworzy się w oknie edytora w Android Studio. Edytuj plik, aby dodać dostosowane właściwości IDE.

Ten plik idea.properties zawiera często dostosowane właściwości IDE. Pełną listę właściwości znajdziesz w opisie pliku idea.properties dla 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

Skonfiguruj IDE pod kątem maszyn z małą ilością pamięci

Jeśli używasz Android Studio na komputerze, który nie spełnia zalecanych specyfikacji (zobacz wymagania systemowe), możesz dostosować IDE, aby zwiększyć wydajność na komputerze w ten sposób:

  • Zmniejsz maksymalny rozmiar stosu dostępnego w Android Studio: zmniejsz maksymalny rozmiar sterty w Android Studio do 512 MB. Więcej informacji o zmienianiu maksymalnego rozmiaru sterty znajdziesz w sekcji Maksymalny rozmiar sterty.
  • Zaktualizuj Gradle i wtyczkę Androida do obsługi Gradle: zaktualizuj narzędzie Gradle do najnowszych wersji i wtyczkę Androida do obsługi Gradle, aby korzystać z najnowszych ulepszeń w zakresie wydajności. Więcej informacji o aktualizowaniu Gradle i wtyczce Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do obsługi Gradle.
  • Włącz tryb oszczędzania energii: włącz tryb oszczędzania energii, aby wyłączyć szereg operacji w tle, które zużywają dużo pamięci i baterii, w tym podświetlanie błędów, inspekcję w czasie rzeczywistym, automatyczne uzupełnianie kodu dla wyskakujących okienek oraz automatyczną przyrostową kompilację w tle. Aby włączyć tryb oszczędzania energii, kliknij Plik > Tryb oszczędzania energii.
  • Wyłącz niepotrzebne sprawdzanie lintowań: aby zmienić lintowanie, które sprawdza, które lint ma działać w Twoim kodzie, wykonaj te czynności:

    1. Kliknij Plik > Ustawienia (w systemie macOS, Android Studio > Ustawienia), aby otworzyć okno Ustawienia.
    2. W panelu po lewej stronie rozwiń sekcję Edytor i kliknij Inspekcje.
    3. Kliknij pola wyboru, aby zaznaczyć pola wyboru lub odznaczyć pola wyboru lintowań, jeśli są odpowiednie dla Twojego projektu.
    4. Aby zapisać zmiany, kliknij Zastosuj lub OK.
  • Debuguj na urządzeniu fizycznym: popraw ogólną wydajność Androida Studio, debugując na urządzeniu fizycznym. Debugowanie w emulatorze wykorzystuje więcej pamięci niż debugowanie na urządzeniu fizycznym.

  • Uwzględnij tylko niezbędne Usługi Google Play jako zależności: uwzględniaj w projekcie tylko niezbędne Usługi Google Play jako zależności. Zależności zwiększają ilość niezbędnej pamięci, więc ich ograniczenie poprawia wykorzystanie i wydajność pamięci. Więcej informacji znajdziesz w artykule Deklarowanie zależności Usług Google Play.

  • Zmniejsz maksymalny rozmiar stosu dostępnego dla Gradle: zmniejsz wartość maksymalnego rozmiaru stosu Gradle z domyślnego 1536 MB, zastępując właściwość org.gradle.jvmargs w pliku gradle.properties w podany niżej sposób:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory can
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • Upewnij się, że kompilacja równoległa jest wyłączona: Android Studio może kompilować równolegle niezależne moduły, ale jeśli masz system z małą ilością pamięci, pozostaw tę funkcję wyłączoną. Aby sprawdzić to ustawienie:

    1. Kliknij Plik > Ustawienia (w systemie macOS, Android Studio > Ustawienia), aby otworzyć okno Ustawienia.
    2. W lewym panelu rozwiń Build, Execution, Deployment (Kompilacja, wykonanie, wdrożenie) i kliknij Kompilator.
    3. Upewnij się, że opcja Kompiluj niezależne moduły równolegle jest odznaczona.
    4. Po wprowadzeniu zmiany kliknij Zastosuj lub OK, aby ją zastosować.

Skonfiguruj ustawienia serwera proxy

Serwery proxy pełnią funkcję pośrednich punktów połączenia między klientami HTTP a serwerami WWW, które zwiększają bezpieczeństwo i prywatność połączeń internetowych.

Aby umożliwić uruchamianie Android Studio za zaporą sieciową, skonfiguruj ustawienia serwera proxy HTTP na stronie ustawień serwera proxy HTTP IDE Android Studio.

Gdy uruchamiasz wtyczkę Androida do obsługi Gradle z poziomu wiersza poleceń lub na komputerach, na których nie zainstalowano Android Studio, takich jak serwery integracji ciągłej, skonfiguruj ustawienia serwera proxy w pliku kompilacji Gradle.

Konfigurowanie serwera proxy Android Studio

Android Studio obsługuje ustawienia serwera proxy HTTP, dzięki czemu możesz uruchomić Android Studio za zaporą sieciową lub bezpieczną siecią. Aby skonfigurować ustawienia serwera proxy HTTP w Android Studio:

  1. Na pasku menu kliknij Plik > Ustawienia (w systemie macOS kliknij Android Studio > Ustawienia).
  2. W lewym okienku kliknij Wygląd i zachowanie > Ustawienia systemu > Serwer proxy HTTP. Pojawi się strona Serwer proxy HTTP.
  3. Wybierz Automatycznie wykryj ustawienia serwera proxy, aby do ustawień serwera proxy używać adresu URL automatycznej konfiguracji serwera proxy, lub Ręczna konfiguracja serwera proxy, aby samodzielnie podać wszystkie wartości. Szczegółowe objaśnienie tych ustawień znajdziesz w sekcji Serwer proxy HTTP.
  4. Kliknij Zastosuj lub OK, aby zapisać zmiany.

Wtyczka na Androida do ustawień serwera proxy HTTP Gradle

Gdy uruchamiasz wtyczkę na Androida z poziomu wiersza poleceń lub na komputerach, na których nie zainstalowano Android Studio, skonfiguruj ustawienia serwera proxy wtyczki Androida do obsługi Gradle w pliku kompilacji Gradle.

Aby skonfigurować ustawienia serwera proxy HTTP dla konkretnej aplikacji, skonfiguruj ustawienia serwera proxy w pliku build.gradle zgodnie z wymaganiami poszczególnych modułów aplikacji:

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
    }
    ...
}

Aby skonfigurować ustawienia serwera proxy HTTP dla całego projektu, skonfiguruj ustawienia serwera proxy w pliku 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

...

Informacje o używaniu właściwości Gradle do ustawień serwera proxy znajdziesz w przewodniku użytkownika Gradle.

Optymalizowanie wydajności Android Studio w systemie Windows

Na wydajność Android Studio w systemie Windows wpływa wiele czynników. W tej sekcji opisujemy, jak zoptymalizować ustawienia Android Studio, aby uzyskać najlepszą wydajność w systemie Windows.

Minimalizuj wpływ oprogramowania antywirusowego na szybkość kompilacji

Niektóre programy antywirusowe mogą zakłócać proces kompilacji w Android Studio, co spowalnia jego działanie. Gdy uruchamiasz kompilację w Android Studio, Gradle kompiluje zasoby i kod źródłowy aplikacji, a potem pakuje skompilowane zasoby w plik APK lub AAB. W trakcie tego procesu na komputerze powstaje wiele plików. Jeśli oprogramowanie antywirusowe ma włączone skanowanie w czasie rzeczywistym, może wymusić zatrzymanie procesu kompilacji przy każdym utworzeniu pliku podczas skanowania.

Aby uniknąć tego problemu, możesz wykluczyć niektóre katalogi ze skanowania w czasie rzeczywistym w oprogramowaniu antywirusowym. W przypadku systemu Windows Analizator kompilacji może pomóc Ci wskazać katalogi, które należy wykluczyć z aktywnego skanowania, i wykluczyć je.

Poniższa lista zawiera domyślną lokalizację każdego katalogu Android Studio, które możesz wykluczyć ze skanowania w czasie rzeczywistym:

Pamięć podręczna Gradle
%USERPROFILE%\.gradle
Projekty Android Studio
%USERPROFILE%\AndroidStudioProjects
Android SDK
%USERPROFILE%\AppData\Local\Android\SDK

Pliki systemowe Android Studio

Składnia: %LOCALAPPDATA%\Google\<product><version>

Przykład: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

Dostosuj lokalizacje katalogów dla środowisk kontrolowanych przez zasady grupy

Jeśli zasady grupy ograniczają katalogi, które możesz wykluczyć ze skanowania w czasie rzeczywistym na komputerze, możesz przenieść swoje katalogi w Android Studio do jednej z lokalizacji wykluczonych przez scentralizowane zasady grupy.

Na liście poniżej pokazujemy, jak dostosować lokalizację każdego katalogu Android Studio, gdzie C:\WorkFolder to katalog, który już wyklucza zasady grupy:

Pamięć podręczna Gradle
Zdefiniuj zmienną środowiskową GRADLE_USER_HOME wskazującą C:\WorkFolder\.gradle.
Projekty Android Studio
Przenieś lub utwórz katalogi projektu w odpowiednim podkatalogu C:\WorkFolder. Przykład: C:\WorkFolder\AndroidStudioProjects.
Android SDK

Aby dostosować lokalizację, wykonaj te czynności:

  1. W Android Studio otwórz okno Ustawienia (Ustawienia w systemie macOS), a następnie kliknij Wygląd i zachowanie > Ustawienia systemu > Android SDK.

  2. Zmień wartość opcji Lokalizacja pakietu SDK na Androida na C:\WorkFolder\AndroidSDK.

    Aby uniknąć ponownego pobierania pakietu SDK, skopiuj istniejący katalog SDK (domyślnie %USERPROFILE%\AppData\Local\Android\SDK) do nowej lokalizacji.

Pliki systemowe Android Studio

Aby dostosować lokalizację, wykonaj te czynności:

  1. W Android Studio kliknij Pomoc > Edytuj właściwości niestandardowe.

    Android Studio poprosi o utworzenie pliku idea.properties, jeśli jeszcze go nie masz.

  2. Dodaj do pliku idea.properties ten wiersz:

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