Android Studio'yu yapılandırma

Android Studio, Java Geliştirme Kiti (JDK) ve mevcut RAM gibi sistem gereksinimlerinizi doğrulayan sihirbazlar ve şablonlar sağlar. Ayrıca optimize edilmiş varsayılan Android Sanal Cihaz (AVD) emülasyonu ve güncellenmiş sistem görüntüleri gibi varsayılan ayarları yapılandırır. Bu dokümanda, Android Studio kullanımınızı özelleştirmek için gereken ek yapılandırma ayarları açıklanmaktadır.

Android Studio, Yardım menüsü üzerinden iki yapılandırma dosyasına erişim sağlar:

  • studio.vmoptions: Android Studio'nun Java Sanal Makinesi'ne (JVM) yönelik yığın boyutu ve önbellek boyutu gibi seçenekleri özelleştirin. Linux makinelerinde Android Studio sürümünüze bağlı olarak bu dosyanın studio64.vmoptions olarak adlandırılabileceğini unutmayın.
  • idea.properties: Eklenti klasör yolu veya desteklenen maksimum dosya boyutu gibi Android Studio özelliklerini özelleştirebilirsiniz.

Emülatör ve cihaz kurulumu ve kullanımı hakkında özel dokümanlar için aşağıdaki konulara bakın:

Yapılandırma dosyalarınızı bulma

Her iki yapılandırma dosyası da Android Studio'nun yapılandırma klasöründe saklanır. Klasörün adı, Android Studio sürümünüze bağlıdır.

Android Studio 4.1 ve sonraki sürümlerde yapılandırma dosyaları aşağıdaki konumlarda bulunur:

  • Windows

    Sözdizimi: %APPDATA%\Google\<product><version>

    Örnek: C:\Users\YourUserName\AppData\Roaming\Google\AndroidStudio4.1

  • macOS

    Sözdizimi: ~/Library/Application Support/Google/<product><version>

    Örnek: ~/Library/Application Support/Google/AndroidStudio4.1

  • Linux

    Sözdizimi: ~/.config/Google/<product><version>

    Örnek: ~/.config/Google/AndroidStudio4.1

Android Studio 4.0 ve önceki sürümleri için yapılandırma dosyaları aşağıdaki konumlarda bulunur:

  • Windows: %USERPROFILE%\.CONFIGURATION_FOLDER
  • macOS: ~/Library/Preferences/CONFIGURATION_FOLDER
  • Linux: ~/.CONFIGURATION_FOLDER

Aşağıdaki ortam değişkenlerini, başka yerlerdeki belirli geçersiz kılma dosyalarına işaret etmek için kullanabilirsiniz:

  • STUDIO_VM_OPTIONS: .vmoptions dosyasının adını ve konumunu ayarlayın.
  • STUDIO_PROPERTIES: .properties dosyasının adını ve konumunu ayarlayın.

Android derlemelerindeki Java sürümleri sayfasını ziyaret ederek hangi JDK'ların kullanılacağını yapılandırabilirsiniz.

Sanal makine seçeneklerinizi özelleştirin

studio.vmoptions dosyası, Android Studio'nun JVM seçeneklerini özelleştirmenize olanak tanır. Android Studio'nun performansını iyileştirmek için en sık kullanılan seçenek, maksimum yığın boyutudur. Ancak studio.vmoptions dosyasını da başlangıç yığın boyutu, önbellek boyutu ve Java çöp toplama anahtarları gibi diğer varsayılan ayarları geçersiz kılmak için kullanabilirsiniz.

Yeni bir studio.vmoptions dosyası oluşturmak veya mevcut dosyanızı açmak için şu adımları uygulayın:

  1. Yardım > Özel Sanal Makine Seçeneklerini Düzenle'yi tıklayın. Daha önce Android Studio için sanal makine seçeneklerini düzenlemediyseniz IDE sizden yeni bir studio.vmoptions dosyası oluşturmanızı ister. Dosyayı oluşturmak için Oluştur'u tıklayın.
  2. studio.vmoptions dosyası, Android Studio'nun düzenleyici penceresinde açılır. Özelleştirilmiş sanal makine seçeneklerinizi eklemek için dosyayı düzenleyin. Özelleştirilebilir JVM seçeneklerinin tam listesi için Oracle'ın Java HotSpot Sanal Makine Seçenekleri sayfasına bakın.

Oluşturduğunuz studio.vmoptions dosyası, Android Studio yükleme klasörünüzün bin/ dizininde bulunan varsayılan studio.vmoptions dosyasına eklenir.

Android Studio program klasörünün içinde bulunan studio.vmoptions dosyasını doğrudan düzenlemeyin. Android Studio'nun varsayılan sanal makine seçeneklerini görüntülemek için dosyaya erişebilirsiniz ancak yalnızca kendi studio.vmoptions dosyanızı düzenlemeniz, Android Studio için önemli varsayılan ayarları geçersiz kılmamanızı sağlar. Bu nedenle, studio.vmoptions dosyanızda yalnızca önem verdiğiniz özellikleri geçersiz kılın ve Android Studio'nun değiştirmediğiniz tüm özellikler için varsayılan değerleri kullanmaya devam etmesine izin verin.

Maksimum yığın boyutu

Varsayılan olarak, Android Studio'nun maksimum yığın boyutu 1.280 MB'tır. Büyük bir proje üzerinde çalışıyorsanız veya sisteminizde çok fazla RAM varsa temel IDE, Gradle arka plan programı ve Kotlin arka plan programı gibi Android Studio işlemleri için maksimum yığın boyutunu artırarak performansı artırabilirsiniz.

Android Studio, olası yığın boyutu optimizasyonlarını otomatik olarak kontrol eder ve performansın iyileştirilebileceğini tespit ederse size bildirim gönderir.

Android Studio işlemleri için maksimum RAM miktarını yapılandırmanıza olanak tanıyan bellek ayarları.

Şekil 1. Önerilen bellek ayarları hakkında bir bildirim.

En az 5 GB RAM'i olan 64 bit bir sistem kullanıyorsanız projeniz için yığın boyutlarını manuel olarak da ayarlayabilirsiniz. Bunun için uygulamanız gereken adımlar şunlardır:

  1. Menü çubuğunda Dosya > Ayarlar'ı tıklayın (macOS'te Android Studio > Tercihler).

  2. Görünüm ve Davranış > Sistem Ayarları > Bellek Ayarları'nı tıklayın.

    Android Studio işlemleri için maksimum RAM miktarını yapılandırmanıza olanak tanıyan bellek ayarları.

    2. Şekil. Bellek Ayarları'nda maksimum RAM miktarını yapılandırın.

  3. Yığın boyutlarını ayarlayın.

  4. Uygula'yı tıklayın.

    IDE için yığın boyutunu değiştirirseniz yeni bellek ayarları uygulanmadan önce Android Studio'yu yeniden başlatmanız gerekir.

IDE ayarlarını dışa ve içe aktarma

Bir proje için tercih ettiğiniz IDE ayarlarının tümünü veya bir alt kümesini içeren bir Settings.jar dosyasını dışa aktarabilirsiniz. Ardından, JAR dosyasını diğer projelerinize aktarabilir ve/veya JAR dosyasını iş arkadaşlarınızın projelerine aktarmaları için kullanılabilir hale getirebilirsiniz.

Daha fazla bilgi için IntelliJ IDEA'daki IDE ayarlarını paylaşma bölümüne bakın.

IDE özelliklerinizi özelleştirin

idea.properties dosyası, Android Studio için kullanıcı tarafından yüklenen eklentilerin yolu ve IDE tarafından desteklenen maksimum dosya boyutu gibi IDE özelliklerini özelleştirmenizi sağlar. idea.properties dosyası IDE'nin varsayılan özellikleriyle birleştirilir, böylece yalnızca geçersiz kılma özelliklerini belirtebilirsiniz.

Yeni bir idea.properties dosyası oluşturmak veya mevcut dosyanızı açmak için şu adımları uygulayın:

  1. Yardım > Özel Mülkleri Düzenle'yi tıklayın. IDE özelliklerini daha önce hiç düzenlemediyseniz Android Studio yeni bir idea.properties dosyası oluşturmanızı ister. Dosyayı oluşturmak için Evet'i tıklayın.
  2. idea.properties dosyası, Android Studio'nun düzenleyici penceresinde açılır. Özelleştirilmiş IDE özelliklerinizi eklemek için dosyayı düzenleyin.

Aşağıdaki idea.properties dosyası, yaygın olarak özelleştirilmiş IDE özelliklerini içerir. Özelliklerin tam listesi için IntelliJ IDEA için idea.properties dosyası hakkında bilgi edinin.

#---------------------------------------------------------------------
# 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

IDE'yi düşük bellekli makineler için yapılandırma

Android Studio'yu, önerilen özelliklerden daha az özelliklere sahip bir makinede çalıştırıyorsanız (sistem gereksinimlerine bakın) IDE'yi, makinenizin performansını artıracak şekilde aşağıdaki şekilde özelleştirebilirsiniz:

  • Android Studio'da kullanılabilen maksimum yığın boyutunu küçültme: Android Studio için maksimum yığın boyutunu 512 MB'a indirin. Maksimum yığın boyutunu değiştirme hakkında daha fazla bilgi için Maksimum yığın boyutu bölümüne bakın.
  • Gradle ve Android Gradle eklentisini güncelleme: En son performans iyileştirmelerinden yararlanmak için Gradle ve Android Gradle eklentisinin en yeni sürümlerine güncelleyin. Gradle'ı ve Android Gradle eklentisini güncelleme hakkında daha fazla bilgi edinmek için Android Gradle eklentisi sürüm notlarına bakın.
  • Güç Tasarrufu Modunu Etkinleştir: Hata vurgulama, çalışırken inceleme, otomatik pop-up kod tamamlama ve otomatik artımlı arka plan derlemesi gibi bellek ve pil yoğun bazı arka plan işlemlerini kapatmak için Güç Tasarrufu Modu'nu etkinleştirin. Güç Tasarrufu Modu'nu açmak için Dosya > Güç Tasarrufu Modu'nu tıklayın.

  • Gereksiz lint kontrollerini devre dışı bırakın: Android Studio'nun kodunuzda çalıştırdığı lint kontrollerini değiştirmek için aşağıdakileri yapın:

    1. Ayarlar iletişim kutusunu açmak için Dosya > Ayarlar'ı (macOS'te Android Studio > Tercihler) tıklayın.
    2. Sol bölmede Düzenleyici bölümünü genişletin ve İncelemeler'i tıklayın.
    3. Projenize uygun lint kontrollerini seçmek veya seçimlerini kaldırmak için onay kutularını tıklayın.
    4. Değişikliklerinizi kaydetmek için Uygula'yı veya Tamam'ı tıklayın.

  • Fiziksel cihazda hata ayıklama: Fiziksel cihazda hata ayıklama yaparak Android Studio'nun genel performansını iyileştirin. Emülatörde hata ayıklama işlemi, fiziksel cihazdaki hata ayıklamaya kıyasla daha fazla bellek kullanır.

  • Bağımlılık olarak yalnızca gerekli Google Play hizmetlerini dahil edin: Projenize yalnızca gerekli Google Play Hizmetleri'ni bağımlılık olarak ekleyin. Bağımlılıklar gerekli bellek miktarını artırdığından bunların sınırlandırılması bellek kullanımını ve performansı iyileştirir. Daha fazla bilgi için Google Play Hizmetleri için bağımlılık bildirme bölümüne bakın.

  • Gradle için kullanılabilen maksimum yığın boyutunu azaltın: gradle.properties dosyasındaki org.gradle.jvmargs özelliğini geçersiz kılarak aşağıda gösterildiği gibi Gradle'ın maksimum yığın boyutu değerini 1.536 MB'lık varsayılan değerden düşürün:

    # Make sure to gradually decrease this value and note
# changes in performance. Allocating too little memory can
# also decrease performance.
org.gradle.jvmargs = -Xmx1536m

  • Paralel derlemenin etkinleştirilmediğinden emin olun: Android Studio bağımsız modülleri paralel olarak derleyebilir, ancak düşük bellekli bir sisteminiz varsa bu özelliği devre dışı bırakın. Bu ayarı kontrol etmek için aşağıdakileri yapın:

    1. Ayarlar iletişim kutusunu açmak için Dosya > Ayarlar'ı (macOS'te Android Studio > Tercihler'i) tıklayın.
    2. Sol bölmede Derleme, Yürütme, Dağıtım'ı genişletin ve ardından Derleyici'yi tıklayın.
    3. Bağımsız modülleri paralel olarak derle seçeneğinin işaretinin kaldırıldığından emin olun.
    4. Değişiklik yaptıysanız yaptığınız değişikliğin geçerli olması için Uygula veya Tamam'ı tıklayın.

Proxy ayarlarını belirleme

Proxy'ler, HTTP istemcileri ile web sunucuları arasında internet bağlantılarına güvenlik ve gizlilik ekleyen ara bağlantı noktaları olarak hizmet verir.

Android Studio'nun güvenlik duvarı arkasında çalıştırılmasını desteklemek için Android Studio IDE HTTP Proxy ayarları sayfasını kullanarak HTTP proxy ayarlarını yapın.

Android Gradle eklentisini komut satırından veya Android Studio'nun yüklü olmadığı makinelerde (ör. sürekli entegrasyon sunucuları) çalıştırırken, proxy ayarlarını Gradle derleme dosyasında ayarlayın.

Android Studio proxy'sini ayarlama

Android Studio, HTTP proxy ayarlarını desteklediğinden Android Studio'yu bir güvenlik duvarının veya güvenli bir ağ arkasında çalıştırabilirsiniz. Android Studio'da HTTP proxy ayarlarını belirlemek için:

  1. Menü çubuğunda Dosya > Ayarlar'ı (macOS'te Android Studio > Tercihler'i) tıklayın.
  2. Sol bölmede Görünüm ve Davranış > Sistem Ayarları > HTTP Proxy'yi tıklayın. HTTP Proxy sayfası görüntülenir.
  3. Proxy ayarları için otomatik bir proxy yapılandırma URL'si kullanmak üzere Proxy ayarlarını otomatik algıla'yı veya her bir ayarı kendiniz girmek için Manuel proxy yapılandırması'nı seçin. Bu ayarların ayrıntılı açıklaması için HTTP Proxy başlıklı makaleyi inceleyin.
  4. Değişikliklerinizin geçerlilik kazanması için Uygula veya Tamam'ı tıklayın.

Gradle HTTP proxy ayarları için Android eklentisi

Android eklentisini komut satırından veya Android Studio'nun yüklü olmadığı makinelerde çalıştırırken, Gradle derleme dosyasında Android Gradle eklentisi proxy ayarlarını belirleyin.

Uygulamaya özel HTTP proxy ayarları için build.gradle dosyasındaki proxy ayarlarını her bir uygulama modülünde gereken şekilde ayarlayın:

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

Proje genelinde HTTP proxy ayarları için gradle/gradle.properties dosyasında proxy ayarlarını belirleyin:

# 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

...

Proxy ayarları için Gradle özelliklerini kullanma hakkında bilgi edinmek üzere Gradle Kullanıcı Kılavuzu'na bakın.

Windows'da Android Studio performansını optimize etme

Windows'da Android Studio performansı çeşitli faktörlerden etkilenebilir. Bu bölümde, Windows'da mümkün olan en iyi performansı elde etmek için Android Studio ayarlarını nasıl optimize edebileceğiniz açıklanmaktadır.

Virüsten korunma yazılımlarının derleme hızı üzerindeki etkisini en aza indirme

Bazı virüsten koruma yazılımları Android Studio oluşturma işlemini engelleyerek derlemelerin çok daha yavaş çalışmasına neden olabilir. Android Studio'da bir derleme çalıştırdığınızda, Gradle uygulamanızın kaynaklarını ve kaynak kodunu derler, ardından derlenen kaynakları bir APK veya AAB'de paketler. Bu işlem sırasında, bilgisayarınızda çok sayıda dosya oluşturulur. Virüsten koruma yazılımınızda gerçek zamanlı tarama özelliği etkinse, virüsten koruma yazılımı bir dosyayı tararken her dosya oluşturulduğunda derleme işlemini durmaya zorlayabilir.

Bu sorunu önlemek için, virüsten koruma yazılımınızın belirli dizinlerini gerçek zamanlı tarama işleminden hariç tutabilirsiniz. Windows için Derleme Analiz Aracı, etkin taramanın dışında tutulması gereken dizinleri belirlemenize ve hariç tutmanıza yardımcı olabilir.

Aşağıdaki listede, gerçek zamanlı taramanın dışında tutabileceğiniz her bir Android Studio dizininin varsayılan konumu gösterilmektedir:

Gradle önbelleği
%USERPROFILE%\.gradle
Android Studio projeleri
%USERPROFILE%\AndroidStudioProjects
Android SDK
%USERPROFILE%\AppData\Local\Android\SDK

Android Studio sistem dosyaları

Sözdizimi: %LOCALAPPDATA%\Google\<product><version>

Örnek: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

Grup Politikası tarafından denetlenen ortamlar için dizin konumlarını özelleştirme

Bir Grup Politikası, bilgisayarınızda gerçek zamanlı taramadan hariç tutabileceğiniz dizinleri sınırlandırırsa Android Studio dizinlerinizi, merkezi Grup Politikası'nın hariç tuttuğu konumlardan birine taşıyabilirsiniz.

Aşağıdaki listede her bir Android Studio dizininin konumunun nasıl özelleştirileceği gösterilmektedir. Burada C:\WorkFolder, Grup Politikanızın hariç tuttuğu dizindir:

Gradle önbelleği
C:\WorkFolder\.gradle işaret edecek şekilde GRADLE_USER_HOME ortam değişkenini tanımlayın.
Android Studio projeleri
Proje dizinlerini C:\WorkFolder klasörünün uygun bir alt dizinine taşıyın veya oluşturun. Örneğin, C:\WorkFolder\AndroidStudioProjects.
Android SDK

Konumu özelleştirmek için şu adımları uygulayın:

  1. Android Studio'da Ayarlar iletişim kutusunu açın (macOS'te Tercihler), ardından Görünüm ve Davranış > Sistem Ayarları > Android SDK'ya gidin.

  2. Android SDK Konumu değerini C:\WorkFolder\AndroidSDK olarak değiştirin.

    SDK'yı tekrar indirmemek için varsayılan olarak %USERPROFILE%\AppData\Local\Android\SDK konumunda bulunan mevcut SDK dizinini yeni konuma kopyalayın.

Android Studio sistem dosyaları

Konumu özelleştirmek için şu adımları uygulayın:

  1. Android Studio'da Yardım > Özel Özellikleri Düzenle'yi tıklayın.

    Henüz yoksa bir idea.properties dosyası oluşturmanızı ister.

  2. idea.properties dosyanıza şu satırı ekleyin:

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