Konfigurowanie Android Studio

Android Studio udostępnia kreatory i szablony, które sprawdzają wymagania systemowe, takie jak pakiet Java Development Kit (JDK) i dostępna pamięć RAM, oraz konfigurują ustawienia domyślne, takie jak zoptymalizowana domyślna emulacja urządzenia wirtualnego Androida (AVD) i 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 wskazywać konkretne pliki zastępcze w innym miejscu, możesz używać 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 zwiększyć wydajność Android Studio, najczęściej należy dostosować maksymalny rozmiar stosu, ale możesz też użyć pliku studio.vmoptions, aby zastąpić inne domyślne ustawienia, takie jak początkowy rozmiar stosu, rozmiar pamięci podręcznej i przełączniki obsługi usuwania elementów nieużywanych w 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 VM dla 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. Zmodyfikuj plik, aby dodać niestandardowe opcje maszyny wirtualnej. Pełną listę opcji JVM dostępnych do dostosowania 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 IDE podstawowe, demon Gradle i demon Kotlin.

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 systemu 64-bitowego z co najmniej 5 GB pamięci RAM, możesz też ręcznie dostosować rozmiary stosu dla swojego projektu. Aby to zrobić:

  1. Na pasku menu kliknij Plik > Ustawienia (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. W ustawieniach pamięci skonfiguruj maksymalną ilość pamięci RAM.

  3. Dostosuj rozmiary stosu.

  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 zawierający wszystkie lub część preferowanych ustawień środowiska 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 swoich projektów.

Więcej informacji znajdziesz w artykule Udostępnianie ustawień IDE w IntelliJ IDEA.

Dostosowywanie właściwości środowiska IDE

Plik idea.properties umożliwia dostosowywanie właściwości środowiska IDE w Android Studio, takich jak ścieżka do wtyczek zainstalowanych przez użytkownika i maksymalny rozmiar pliku obsługiwany przez środowisko IDE. Plik idea.properties jest scalany z domyślnymi właściwościami IDE, więc możesz określić tylko właściwości zastępcze.

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. Aby utworzyć plik, kliknij Tak.
  2. Plik idea.properties otworzy się w oknie edytora Android Studio. Zmień 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 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 używasz Android Studio na komputerze, który nie spełnia zalecanych wymagań (patrz wymagania systemowe), możesz dostosować IDE, aby zwiększyć wydajność komputera w ten sposób:

  • Zmniejsz maksymalny rozmiar stosu dostępny dla Android Studio: zmniejsz maksymalny rozmiar stosu dla Android Studio do 512 MB. Więcej informacji o zmianie maksymalnego rozmiaru stosu znajdziesz w artykule 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 tryb oszczędzania energii, aby wyłączyć wiele operacji w tle, które wymagają dużej ilości pamięci i energii, w tym wyróżnianie błędów i sprawdzanie na bieżąco, automatyczne uzupełnianie kodu w wyskakujących okienek oraz automatyczną kompilację przyrostową w tle. Aby włączyć tryb oszczędzania energii, kliknij Plik > Tryb oszczędzania energii.
  • Wyłączanie niepotrzebnych kontroli lint: aby zmienić kontrole lint, które Android Studio wykonuje na kodzie, wykonaj te czynności:

    1. Kliknij Plik > Ustawienia (w systemie macOS: Android Studio > Preferencje), 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 w 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ń Tworzenie, wykonywanie, wdrażanie, a potem kliknij Kompilator.
    3. Upewnij się, że opcja Kompiluj niezależne moduły równolegle nie jest zaznaczona.
    4. Aby zmiany zaczęły obowiązywać, kliknij Zastosuj lub OK.

Ustawianie ustawień serwera proxy

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

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

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ć Android Studio za zaporą sieciową lub w bezpiecznej 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 panelu po lewej stronie kliknij Wygląd i zachowanie > Ustawienia systemowe > 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.

Ustawienia serwera proxy HTTP wtyczki Androida do obsługi 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.

W przypadku ustawień serwera proxy HTTP specyficznych dla aplikacji ustaw ustawienia serwera proxy w pliku build.gradle zgodnie z wymaganiami dla 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 ustawień serwera proxy znajdziesz w przewodniku użytkownika Gradle.

Optymalizowanie wydajności Android Studio w systemie Windows

Na wydajność Android Studio w systemie Windows może mieć wpływ wiele czynników. W tej sekcji opisano, jak zoptymalizować ustawienia Android Studio, aby uzyskać jak najlepszą wydajność w systemie Windows.

Minimalizowanie wpływu oprogramowania antywirusowego na szybkość kompilacji

Niektóre programy antywirusowe mogą zakłócać proces kompilacji w Android Studio, przez co kompilacje będą trwać znacznie dłużej. Gdy uruchomisz kompilację w Android Studio, Gradle skompiluje zasoby i kod źródłowy aplikacji, a potem spakował skompilowane zasoby w plik APK lub AAB. Podczas tego procesu na komputerze powstaje wiele plików. Jeśli w Twoim programie antywirusowym włączone jest skanowanie w czasie rzeczywistym, może on przerwać proces kompilacji za każdym razem, gdy tworzy się plik podczas skanowania.

Aby uniknąć tego problemu, możesz wykluczyć z skanowania w czasie rzeczywistym wybrane katalogi w oprogramowaniu antywirusowym. W Windows analizator kompilacji może pomóc w identyfikacji katalogów, które powinny być wykluczone z aktywnego skanowania.

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ę:

  1. W Android Studio otwórz okno Ustawienia (Ustawienia na macOS) i kliknij 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