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. Ten dokument zawiera dodatkowe ustawienia konfiguracji, które umożliwiają dostosowanie Android Studio do własnych potrzeb.

W menu Pomoc Android Studio zapewnia dostęp do 2 plików konfiguracji:

  • studio.vmoptions: dostosuj opcje maszyny wirtualnej Java (JVM) w Android Studio, np. rozmiar stosu i 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: możesz dostosować właściwości Android Studio, takie jak ścieżka do folderu wtyczek lub maksymalny obsługiwany rozmiar pliku.

Szczegółowe informacje o konfigurowaniu i używaniu emulatora oraz urządzenia znajdziesz w tych tematach:

Znajdowanie plików konfiguracji

Oba pliki konfiguracji są przechowywane w katalogu konfiguracji Android Studio. Informacje o lokalizacji katalogu 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 skonfigurować, które wersje JDK mają być używane, otwórz wersje Javy w kompilacji Androida.

Dostosowywanie opcji maszyny wirtualnej

Plik studio.vmoptions umożliwia dostosowywanie opcji 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. Aby utworzyć plik, kliknij Utwórz.
  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 jest dodawany do domyślnego pliku studio.vmoptions, który znajduje się w katalogu bin/ w folderze instalacyjnym Android Studio.

Nie zmieniaj bezpośrednio pliku studio.vmoptions znajdującego się w folderze programu Android Studio. Możesz otworzyć ten plik, aby wyświetlić domyślne opcje maszyny wirtualnej Android Studio. Jednak edytowanie tylko własnego pliku studio.vmoptions zapewni, że nie zastąpisz ważnych domyślnych ustawień Android Studio. Dlatego w pliku studio.vmoptions zastąpij tylko te atrybuty, które Cię interesują, a w przypadku pozostałych atrybutów pozostaw wartości domyślne.

Maksymalny rozmiar stosu

Domyślny rozmiar stosu 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 dla procesów Android Studio, takich jak podstawowe IDE, demon Gradle i demon Kotlina.

Android Studio automatycznie sprawdza możliwe optymalizacje rozmiaru stosu i powiadamia, 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. Na pasku menu kliknij Plik > Ustawienia (Android Studio > Preferencje 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 dla IDE, musisz ponownie uruchomić Android Studio, zanim nowe ustawienia pamięci zostaną zastosowane.

Eksportowanie i importowanie ustawień IDE

Możesz wyeksportować plik Settings.jar, który zawiera wszystkie ustawienia preferowanego IDE dla projektu lub ich podzbiór. 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.

Dostosowywanie właściwości środowiska 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 plik, wykonaj te czynności:

  1. Kliknij Pomoc > Edytuj właściwości niestandardowe. Jeśli nigdy wcześniej nie edytowałeś/nie edytowałaś właściwości IDE, Android Studio wyświetli prompt z prośbą 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.

Ten plik idea.properties zawiera najczęściej dostosowywane 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 i wtyczkę Androida do obsługi Gradle do najnowszych wersji, aby skorzystać z najnowszych ulepszeń wydajności. Więcej informacji o aktualizowaniu Gradle i wtyczki Androida do obsługi Gradle znajdziesz w notatkach do 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 włączyć lub wyłączyć sprawdzanie błędów w zależności od projektu.
    4. Aby zapisać zmiany, kliknij Zastosuj lub OK.
  • Debugowanie na urządzeniu fizycznym: popraw ogólną wydajność Android Studio, przeprowadzając debugowanie na urządzeniu fizycznym. Debugowanie na emulatorze zużywa więcej pamięci niż debugowanie na urządzeniu fizycznym.

  • Uwzględniaj w projektach tylko niezbędne usługi Google Play: w projekcie uwzględniaj tylko niezbędne usługi Google Play. Zależność zwiększa ilość wymaganej pamięci, więc jej ograniczenie poprawia wykorzystanie pamięci i wydajność. Więcej informacji znajdziesz w artykule Oświadczenie zależności w Usługach Google Play.

  • Zmniejsz maksymalny rozmiar stosu dostępny 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, jak pokazano poniżej:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory can
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • Sprawdź, czy kompilacja równoległa nie jest włączona: Android Studio może kompilować niezależne moduły równolegle, 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 > Preferencje), 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. Aby zmiany zaczęły obowiązywać, kliknij Zastosuj lub OK.

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.

Gdy uruchamiasz wtyczkę Androida do obsługi Gradle z poziomu wiersza poleceń lub na maszynach, na których nie jest zainstalowane Android Studio (np. na serwerach ciągłej integracji), ustaw 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 ustawić 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. Pojawi się strona Serwer proxy HTTP.
  3. Wybierz Automatycznie wykrywaj ustawienia proxy, aby używać automatycznej konfiguracji serwera proxy, lub Ręcznie konfiguruj serwer proxy, aby samodzielnie wpisać ustawienia. Szczegółowe omówienie tych ustawień znajdziesz w artykule Serwer proxy HTTP.
  4. Aby zmiany zaczęły obowiązywać, kliknij Zastosuj lub OK.

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

Gdy uruchamiasz wtyczkę Androida z poziomu wiersza poleceń lub na komputerze, na którym nie jest zainstalowane Android Studio, skonfiguruj ustawienia serwera proxy wtyczki Androida do obsługi 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 ustawić ustawienia serwera proxy HTTP na poziomie 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 konfigurowania 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, 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 powstaje 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 w zidentyfikowaniu katalogów, które powinny zostać wykluczone z aktywnego skanowania, i w wykluczeniu ich.

Na liście poniżej znajdziesz domyślną lokalizację każdej z katalogów Android Studio, które możesz wykluczyć z skanowania w czasie rzeczywistym:

Pamięć podręczna Gradle
%USERPROFILE%\.gradle
Projekty w 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

Dostosowywanie lokalizacji katalogów w środowiskach kontrolowanych za pomocą zasad grupowych

Jeśli zasady grupy ograniczają katalogi, które możesz wykluczyć z 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.

Poniżej znajdziesz listę pokazującą, jak dostosować lokalizację poszczególnych katalogów Android Studio, gdzie C:\WorkFolder to katalog, który jest już wykluczony przez zasady grupy:

Pamięć podręczna Gradle
Zdefiniuj zmienną środowiskową GRADLE_USER_HOME tak, aby wskazywała na C:\WorkFolder\.gradle.
Projekty w Android Studio
Przenieś lub utwórz katalogi projektów w odpowiednim podkatalogu C:\WorkFolder. Na 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ść parametru Android SDK Location na C:\WorkFolder\AndroidSDK.

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

Pliki systemowe Android Studio

Aby dostosować lokalizację:

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

    Jeśli nie masz jeszcze pliku idea.properties, Android Studio poprosi Cię o jego utworzenie.

  2. Dodaj do pliku idea.properties ten wiersz:

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