Android Studio'yu yapılandırma

Android Studio, Java Geliştirme Kiti (JDK) ve mevcut RAM gibi sistem gereksinimlerini doğrulayan sihirbazlar ve şablonlar sağlar. Ayrıca optimize edilmiş varsayılan Android Virtual Device (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 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 makinelerde 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ümleri için 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 bir yerdeki 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ştirebilmenizi sağlar. 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ı kullanarak başlangıç yığın boyutu, önbellek boyutu ve Java çöp toplama anahtarları gibi diğer varsayılan ayarları da geçersiz kılabilirsiniz.

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. Android Studio için sanal makine seçeneklerini daha önce hiç düzenlemediyseniz IDE, 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 içindeki 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üzenlemek, 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 ö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 1280 MB'tır. Büyük bir proje üzerinde çalışıyorsanız veya sisteminizde çok fazla RAM varsa Android Studio işlemleri için çekirdek IDE, Gradle arka plan programı ve Kotlin arka plan programı gibi 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 bildirir.

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 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ğundan 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 kullanabilirsiniz.

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ştirmenize olanak tanır. 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 Özellikleri Düzenle'yi tıklayın. IDE özelliklerini daha önce hiç düzenlemediyseniz Android Studio sizden 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ı, genellikle ö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

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

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

  • Android Studio'da kullanılabilen maksimum yığın boyutunu azaltın: 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'ın ve Android Gradle eklentisinin en yeni sürümlerine güncelleme yapın. Gradle ve Android Gradle eklentisini güncelleme hakkında daha fazla bilgi için Android Gradle eklentisi sürüm notlarına göz atın.
  • Güç Tasarrufu Modunu Etkinleştirin: Hata vurgulama, çalışırken kontrol etme, otomatik pop-up kod tamamlama ve otomatik kademeli arka plan derlemesi gibi bellek ve pil tüketimini yoğun olan 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 hangi lint kontrollerini çalıştıracağını değiştirmek için aşağıdakileri yapın:

    1. Dosya > Ayarlar'ı (macOS'te, Android Studio > Tercihler) tıklayarak Ayarlar iletişim kutusunu açı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 veya Tamam'ı tıklayın.
  • Fiziksel cihazda hata ayıklama: Fiziksel bir cihazda hata ayıklayarak 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.

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

  • Gradle için kullanılabilecek maksimum yığın boyutunu azaltın: gradle.properties dosyasında org.gradle.jvmargs özelliğini geçersiz kılarak aşağıda gösterildiği gibi Gradle'ın maksimum yığın boyutu değerini varsayılan değer olan 1.536 MB'tan 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. Dosya > Ayarlar'ı (macOS'te, Android Studio > Tercihler) tıklayarak Ayarlar iletişim kutusunu açın.
    2. Sol bölmede Build, Execution, Deployment'ı (Derleme, Yürütme, Dağıtım) genişletip Derleyici'yi tıklayın.
    3. Bağımsız modülleri paralel olarak derle seçeneğinin işaretli olmadığı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 görev yapar.

Android Studio'nun güvenlik duvarı arkasında çalıştırılmasını desteklemek için, HTTP proxy ayarlarını yapmak üzere Android Studio IDE HTTP Proxy ayarları sayfasını kullanı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, Gradle derleme dosyasında proxy ayarlarını belirleyin.

Android Studio proxy'sini ayarlama

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

  1. Menü çubuğundan 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 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 konusuna bakın.
  4. Değişikliklerinizin geçerli olması 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 uygulama modülünde gerektiği gibi 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 çapında HTTP proxy ayarları için gradle/gradle.properties dosyasındaki proxy ayarlarını yapın:

# 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 için 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 koruma yazılımlarının derleme hızı üzerindeki etkisini en aza indirme

Bazı virüsten koruma yazılımları Android Studio derleme 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, bir dosya taranırken 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ı taramadan hariç tutabilirsiniz. Windows için Derleme Analiz Aracı, etkin taramadan hariç 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 İlkesi tarafından denetlenen ortamlar için dizin konumlarını özelleştirme

Bir Grup Politikası, bilgisayarınızdaki 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
GRADLE_USER_HOME ortam değişkenini C:\WorkFolder\.gradle öğesine işaret edecek şekilde tanımlayın.
Android Studio projeleri
Proje dizinlerini C:\WorkFolder klasörünün uygun bir alt dizininde taşıyın veya oluşturun. Örneğin, C:\WorkFolder\AndroidStudioProjects.
Android SDK

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

  1. Android Studio'da Ayarlar iletişim kutusunu (macOS'te Tercihler) açın, 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ı izleyin:

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

    Android Studio, henüz dosyanız yoksa bir idea.properties dosyası oluşturmanızı ister.

  2. Aşağıdaki satırı idea.properties dosyanıza ekleyin:

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