Konfigurowanie Android Studio

Android Studio zawiera kreatory i szablony, które sprawdzają 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 urządzenia wirtualnego z Androidem (AVD) czy zaktualizowane obrazy systemu. W tym dokumencie znajdziesz opis dodatkowych ustawień konfiguracyjnych, które pozwalają dostosować sposób korzystania z Android Studio.

Android Studio umożliwia dostęp do dwóch plików konfiguracji za pomocą menu Pomoc:

  • studio.vmoptions: dostosuj opcje maszyny wirtualnej Java (JVM) w Android Studio, takie jak rozmiar sterty i rozmiar pamięci podręcznej. Pamiętaj, że na komputerach z systemem Linux ten plik może mieć 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.

Dokładną dokumentację dotyczącą konfiguracji i używania emulatora i urządzenia znajdziesz w tych tematach:

Znajdowanie plików konfiguracji

Oba pliki konfiguracji są przechowywane w katalogu konfiguracji Android Studio. Katalog konfiguracji znajdziesz w sekcji Katalogi.

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

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

Aby określić, które pakiety JDK są używane, otwórz stronę wersji Java w kompilacjach na Androida.

Dostosowywanie opcji maszyn wirtualnych

Plik studio.vmoptions pozwala dostosować opcje interfejsu JVM w Android Studio. Aby poprawić wydajność Android Studio, najpopularniejszą opcją jest dostosowanie maksymalnego rozmiaru stosu. Możesz też użyć pliku studio.vmoptions, aby zastąpić inne ustawienia domyślne, takie jak początkowy rozmiar sterty, 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 niestandardowych maszyn wirtualnych. Jeśli opcje maszyn wirtualnych w Android Studio nie były wcześniej edytowane, IDE wyświetli prośbę o utworzenie nowego pliku studio.vmoptions. Kliknij Utwórz, aby utworzyć plik.
  2. Plik studio.vmoptions otworzy się w oknie edytora Android Studio. Edytuj plik, aby dodać niestandardowe opcje maszyny wirtualnej. Pełną listę dostosowywanych opcji JVM znajdziesz na stronie opcji maszyny wirtualnej Java HotSpot firmy Oracle.

Utworzony plik studio.vmoptions zostanie dodany do domyślnego pliku studio.vmoptions znajdującego 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. Chociaż możesz uzyskać dostęp do tego pliku, aby wyświetlić domyślne opcje maszyny wirtualnej w Android Studio, edytowanie tylko własnego pliku studio.vmoptions sprawi, że nie zastąpisz ważnych ustawień domyślnych w Android Studio. Dlatego w pliku studio.vmoptions zastąp tylko te atrybuty, na których Ci zależy, i pozwól Android Studio dalej używać wartości domyślnych dla wszystkich atrybutów, które nie zostały zmienione.

Maksymalny rozmiar sterty

Domyślnie rozmiar stosu Android Studio nie może przekraczać 1280 MB. Jeśli pracujesz nad dużym projektem lub system ma dużo pamięci RAM, możesz poprawić wydajność, zwiększając maksymalny rozmiar stosu procesów Android Studio, np. podstawowego IDE, demona Gradle czy demona Kotlin.

Android Studio automatycznie sprawdza możliwość optymalizacji rozmiaru 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 dla 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ć rozmiary sterty w projekcie. Aby to zrobić:

  1. Kliknij Plik > Ustawienia na pasku menu (Android Studio > Ustawienia w systemie macOS).
  2. Kliknij Wygląd i zachowanie > Ustawienia systemu > Ustawienia pamięci.

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

    Rysunek 2. Skonfiguruj maksymalną ilość pamięci RAM w ustawieniach pamięci.

  3. Dostosuj rozmiary sterty.

  4. Kliknij Zastosuj.

    Jeśli zmienisz rozmiar stosu w 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 podzbiór ustawień preferowanego IDE dla projektu. Następnie możesz zaimportować plik JAR do innych projektów lub udostępnić go współpracownikom, aby mogli go zaimportować do ich projektów.

Więcej informacji znajdziesz w artykule o udostępnianiu ustawień IDE na stronie IntelliJ IDEA.

Dostosuj właściwości IDE

Plik idea.properties umożliwia dostosowanie właściwości IDE Android Studio, takich jak ścieżka do wtyczek zainstalowanych przez użytkownika i 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, wykonaj te czynności:

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

Poniższy 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

Konfigurowanie IDE na potrzeby maszyn z małą ilością pamięci

Jeśli korzystasz z Android Studio na komputerze, na którym parametry są mniejsze niż zalecane (zobacz wymagania systemowe), możesz dostosować IDE, by zwiększyć wydajność na komputerze, wykonując te czynności:

  • Zmniejsz maksymalny rozmiar stosu dostępny w Android Studio: zmniejsz maksymalny rozmiar stosu w Android Studio do 512 MB. Więcej informacji o zmienianiu maksymalnego rozmiaru stosu znajdziesz w sekcji Maksymalny rozmiar stosu.
  • Zaktualizuj Gradle i wtyczkę Androida do obsługi Gradle: zaktualizuj Gradle do najnowszej wersji i wtyczki Androida do obsługi Gradle, aby móc korzystać z najnowszych ulepszeń w zakresie wydajności. Więcej informacji o aktualizowaniu Gradle i wtyczki Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do obsługi Gradle.
  • Włącz tryb oszczędzania energii: włącz ten tryb, aby wyłączyć wiele operacji w tle, które pochłaniają dużo pamięci i baterii, w tym wyróżnianie błędów, przeprowadzanie inspekcji na bieżąco, automatyczne uzupełnianie kodu w wyskakującym okienku oraz automatyczną przyrostową kompilację w tle. Aby włączyć tryb oszczędzania energii, kliknij Plik > Tryb oszczędzania energii.
  • Wyłączanie zbędnych kontroli lintowania: aby zmienić sprawdzanie lintowania w kodzie, które Android Studio uruchamia 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ć lub odznaczyć kontrole lintowania odpowiednio do Twojego projektu.
    4. Kliknij Zastosuj lub OK, aby zapisać zmiany.
  • Debuguj na urządzeniu fizycznym: popraw ogólną wydajność Android Studio, debugując na urządzeniu fizycznym. Debugowanie w emulatorze wykorzystuje więcej pamięci niż debugowanie na urządzeniu fizycznym.

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

  • Zmniejsz maksymalny rozmiar stosu Gradle: zmniejsz wartość maksymalnego rozmiaru stosu Gradle z domyślnego 1536 MB. Aby to zrobić, zastąp właściwość org.gradle.jvmargs w pliku gradle.properties w ten 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 nie jest włączona: Android Studio może kompilować równoległe moduły niezależne, ale w systemie o małej 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 panelu po lewej stronie rozwiń Kompilowanie, wykonywanie, wdrażanie i kliknij Kompilator.
    3. Upewnij się, że opcja Kompiluj moduły niezależne równolegle jest odznaczona.
    4. Jeśli wprowadzisz zmiany, kliknij Zastosuj lub OK, aby je zastosować.

Skonfiguruj ustawienia serwera proxy

Serwery proxy służą jako pośrednie punkty połączenia między klientami HTTP a serwerami WWW, które zwiększają bezpieczeństwo i prywatność połączeń internetowych.

Aby zapewnić obsługę Androida Studio za zaporą sieciową, skonfiguruj ustawienia serwera proxy HTTP na stronie ustawień serwera proxy HTTP w Android Studio.

Jeśli uruchamiasz wtyczkę Androida do obsługi Gradle z poziomu wiersza poleceń lub na komputerach, na których nie ma zainstalowanego Android Studio (np. na serwerach ciągłej integracji), skonfiguruj ustawienia serwera proxy w pliku kompilacji Gradle.

Konfigurowanie serwera proxy w Android Studio

Android Studio obsługuje ustawienia serwera proxy HTTP, dzięki czemu możesz uruchamiać Androida 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 działanie > Ustawienia systemu > Serwer proxy HTTP. Zostanie wyświetlona strona Serwer proxy HTTP.
  3. Wybierz Automatycznie wykrywaj ustawienia serwera proxy, aby na potrzeby ustawień serwera proxy używać adresu URL automatycznej konfiguracji serwera proxy, lub Ręczna konfiguracja serwera proxy, aby wpisać każde z ustawień samodzielnie. Szczegółowe omówienie tych ustawień znajdziesz w artykule Serwer proxy HTTP.
  4. Kliknij Zastosuj lub OK, aby zmiany zostały wprowadzone.

Wtyczka na Androida do obsługi ustawień serwera proxy HTTP Gradle

Jeśli uruchamiasz wtyczkę Androida z wiersza poleceń lub na komputerach, na których nie zainstalowano Android Studio, skonfiguruj ustawienia serwera proxy wtyczki Android Gradle w pliku kompilacji Gradle.

Aby skonfigurować ustawienia serwera proxy HTTP specyficzne dla aplikacji, skonfiguruj ustawienia serwera proxy w pliku build.gradle zgodnie z wymaganiami każdego modułu 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, określ ustawienia 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 konfigurowania ustawień serwera proxy znajdziesz w przewodniku użytkownika Gradle.

Optymalizowanie wydajności Android Studio w systemie Windows

Na wydajność Androida Studio w systemie Windows może wpływać wiele czynników. W tej sekcji opisujemy, jak zoptymalizować ustawienia Android Studio, by uzyskać najlepszą możliwą wydajność w systemie Windows.

Zminimalizuj wpływ oprogramowania antywirusowego na szybkość kompilacji.

Niektóre programy antywirusowe mogą zakłócać proces kompilacji w Android Studio, przez co kompilacje działają znacznie wolniej. Gdy uruchamiasz kompilację w Android Studio, Gradle kompiluje zasoby aplikacji i jej kod źródłowy, a następnie pakuje skompilowane zasoby w pakiet APK lub pakiet aplikacji na Androida. Podczas tego procesu na komputerze tworzonych jest wiele plików. Jeśli w oprogramowaniu antywirusowym jest włączone skanowanie w czasie rzeczywistym, może wymusić zatrzymanie procesu kompilacji za każdym razem, gdy zostanie utworzony plik w trakcie 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 zidentyfikować katalogi, które powinny zostać wykluczone z aktywnego skanowania, i je wykluczyć.

Na liście poniżej znajdziesz domyślną lokalizację każdego katalogu Android Studio, który 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 przy użyciu zasad grupy

Jeśli zasady grupy ograniczają możliwość wykluczenia katalogów ze skanowania w czasie rzeczywistym na komputerze, możesz przenieść katalogi Android Studio do jednej z lokalizacji, które są już wykluczone przez scentralizowane zasady grupy.

Na poniższej liście znajdziesz informacje o tym, jak dostosować lokalizację każdego katalogu Android Studio, gdzie C:\WorkFolder to katalog, który już wyklucza ze swoich zasad grupy:

Pamięć podręczna Gradle
Zdefiniuj zmienną środowiskową GRADLE_USER_HOME wskazującą C:\WorkFolder\.gradle.
Projekty Android Studio
Przenieś lub utwórz katalogi projektów 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 wybierz Wygląd i zachowanie > Ustawienia systemu > Android SDK.

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

    Aby uniknąć ponownego pobierania pakietu SDK, skopiuj do nowej lokalizacji dotychczasowy katalog SDK, który znajduje się domyślnie na %USERPROFILE%\AppData\Local\Android\SDK.

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 wyświetli prośbę 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