Android Studio'yu yapılandırma

Android Studio, Java Development Kit (JDK) ve kullanılabilir RAM gibi sistem gereksinimlerinizi doğrulayan ve optimize edilmiş varsayılan Android Virtual Device (AVD) emülasyonu ve güncellenmiş sistem resimleri gibi varsayılan ayarları yapılandıran sihirbazlar ve şablonlar sağlar. Bu belgede, Android Studio'yu kullanma deneyiminizi özelleştirmek için kullanabileceğiniz ek yapılandırma ayarları açıklanmaktadır.

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

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

Emülatör, cihaz kurulumu ve kullanımıyla ilgili 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 dizininde depolanır. Yapılandırma dizinini bulmak için Dizinler bölümüne bakın.

Başka bir yerdeki belirli geçersiz kılma dosyalarını işaretlemek için aşağıdaki ortam değişkenlerini 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ştirme

studio.vmoptions dosyası, Android Studio'nun JVM'si için seçenekleri özelleştirmenize olanak tanır. Android Studio'nun performansını artırmak için ayarlanabilecek en yaygın seçenek maksimum yığın boyutudur. Ancak ilk yığın boyutu, önbellek boyutu ve Java çöp toplama anahtarları gibi diğer varsayılan ayarları geçersiz kılmak için studio.vmoptions dosyasını da kullanabilirsiniz.

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

  1. Yardım > Özel VM Seçenekleri'ni Düzenle'yi tıklayın. Android Studio için daha önce hiç VM seçeneklerini 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 VM Options 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ündeki 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'nun önemli varsayılan ayarlarını geçersiz kılmamanızı sağlar. Bu nedenle, studio.vmoptions dosyanızda yalnızca önemsediğ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

Android Studio'nun varsayılan 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 daemon ve Kotlin daemon 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 sizi bilgilendirir.

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

Şekil 1. Önerilen bellek ayarlarıyla ilgili bir bildirim.

En az 5 GB RAM'e sahip 64 bit bir sistem kullanıyorsanız projenizin yığın boyutlarını manuel olarak da ayarlayabilirsiniz. Bunun için, aşağıdaki adımları uygulayın:

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

    Şekil 2. 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ının uygulanması için 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 tamamını veya bir alt kümesini içeren bir Settings.jar dosyası dışa aktarabilirsiniz. Ardından JAR dosyasını diğer projelerinize aktarabilir ve/veya JAR dosyasını projenize aktarmaları için iş arkadaşlarınıza sunabilirsiniz.

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

IDE özelliklerinizi özelleştirme

idea.properties dosyası, Android Studio için IDE özelliklerini (ör. kullanıcı tarafından yüklenen eklentilerin yolu ve IDE tarafından desteklenen maksimum dosya boyutu) özelleştirmenize olanak tanır. idea.properties dosyası, IDE'nin varsayılan özellikleriyle birleştirilir. Bu nedenle, yalnızca geçersiz kılma özelliklerini belirtebilirsiniz.

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

  1. Yardım > Özel Özellikleri 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ı, genellikle özelleştirilen IDE özelliklerini içerir. Özelliklerin tam listesi için IntelliJ IDEA'nın 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 düşük özelliklere sahip bir makinede çalıştırıyorsanız (sistem gereksinimlerine bakın) makinenizdeki performansı iyileştirmek için IDE'yi aşağıdaki gibi özelleştirebilirsiniz:

  • Android Studio'nun kullanabileceği maksimum yığın boyutunu azaltın: Android Studio için maksimum yığın boyutunu 512 MB'ye indirin. Maksimum yığın boyutunu değiştirme hakkında daha fazla bilgi için Maksimum yığın boyutu başlıklı makaleyi inceleyin.
  • Gradle ve Android Gradle eklentisini güncelleyin: En son performans iyileştirmelerinden yararlanmak için Gradle ve Android Gradle eklentisinin en son sürümlerine güncelleyin. Gradle ve Android Gradle eklentisini güncelleme hakkında daha fazla bilgi için Android Gradle eklentisi sürüm notlarına bakın.
  • Enerji Tasarrufu Modu'nu etkinleştirin: Hata vurgulama ve anında denetimler, otomatik pop-up kod tamamlama ve otomatik artımlı arka plan derlemesi gibi bellek ve pil yoğunluklu arka plan işlemlerini devre dışı bırakmak için Enerji Tasarrufu Modu'nu etkinleştirin. Güç Tasarrufu modunu açmak için Dosya > Güç Tasarrufu Modu'nu tıklayın.
  • Gereksiz lint kontrollerini devre dışı bırakma: Android Studio'nun kodunuzda hangi lint kontrollerini çalıştıracağını değiştirmek için şunları 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 olarak lint kontrollerini seçmek veya 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, fiziksel bir cihazda hata ayıklama işlemine kıyasla daha fazla bellek kullanır.

  • Yalnızca gerekli Google Play Hizmetleri'ni bağımlılık olarak ekleyin: Projenize yalnızca gerekli Google Play Hizmetleri'ni bağımlılık olarak ekleyin. Bağımlılıklar, gerekli bellek miktarını artırır. Bu nedenle, bağımlılıkları sınırlamak bellek kullanımını ve performansı iyileştirir. Daha fazla bilgi için Google Play Hizmetleri için bağımlılıkları belirtme başlıklı makaleyi inceleyin.

  • Gradle için kullanılabilen maksimum yığın boyutunu azaltma: gradle.properties dosyasındaki org.gradle.jvmargs mülkünü geçersiz kılarak Gradle'ın maksimum yığın boyutunun değerini varsayılan 1.536 MB'tan azaltı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 etkin olmadığından emin olun: Android Studio bağımsız modülleri paralel olarak derleyebilir ancak bellek miktarı düşük 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) 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şaretli olmadığından emin olun.
    4. Değişiklik yaptıysanız değişikliğinizin 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 aracı bağlantı noktaları olarak hizmet eder.

Android Studio'yu güvenlik duvarının arkasında çalıştırmayı desteklemek için HTTP proxy ayarlarını belirlemek ü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 proxy ayarlarını Gradle derleme dosyasında ayarlayın.

Android Studio proxy'sini ayarlama

Android Studio, HTTP proxy ayarlarını destekler. Böylece Android Studio'yu bir güvenlik duvarının veya güvenli bir ağın 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'sini tıklayın. HTTP Proxy sayfası görünür.
  3. Proxy ayarlarında otomatik proxy yapılandırması URL'si kullanmak için Proxy ayarlarını otomatik olarak algıla'yı veya ayarların her birini 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çerli olması için Uygula veya Tamam'ı tıklayın.

Gradle için Android eklentisi HTTP proxy ayarları

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ı yapın.

Uygulamaya özgü HTTP proxy ayarları için build.gradle dosyasında proxy ayarlarını her uygulama modülü için 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 genelinde HTTP proxy ayarları için gradle/gradle.properties dosyasında 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 istiyorsanız Gradle Kullanıcı Kılavuzu'na bakın.

Windows'ta Android Studio performansını optimize etme

Windows'daki Android Studio performansı çeşitli faktörlerden etkilenebilir. Bu bölümde, Windows'ta 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ımının derleme hızı üzerindeki etkisini en aza indirme

Bazı virüsten koruma yazılımları, Android Studio derleme sürecini etkileyerek derlemelerin çok daha yavaş çalışmasına neden olabilir. Android Studio'da derleme işlemi yaptığınızda Gradle, uygulamanızın kaynak kodunu ve kaynaklarını derleyip derlenmiş kaynakları bir APK veya AAB'de paketler. Bu işlem sırasında bilgisayarınızda birçok dosya oluşturulur. Virüsten koruma yazılımınızda gerçek zamanlı tarama etkinse yazılım, bir dosya oluşturulduğunda bu dosyayı tararken derleme işlemini durdurmaya zorlayabilir.

Bu sorunu önlemek için virüsten koruma yazılımınızda belirli dizinleri anlık tarama kapsamı dışında bırakabilirsiniz. Windows için Build Analyzer, etkin taramadan hariç tutulması gereken dizinleri belirlemenize ve hariç tutmanıza yardımcı olabilir.

Aşağıdaki listede, gerçek zamanlı taramadan hariç tutabildiğiniz her 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ı kontrollü ortamlar için dizin konumlarını özelleştirme

Bir grup politikası, bilgisayarınızda anlık tarama kapsamı dışında bırakabileceğiniz dizinleri sınırlandırıyorsa Android Studio dizinlerinizi, merkezi grup politikasının zaten hariç tuttuğu konumlardan birine taşıyabilirsiniz.

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

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

Konumu özelleştirmek için aşağıdaki adımları uygulayın:

  1. Android Studio'da Ayarlar iletişim kutusunu (macOS'te Tercihler) açıp Görünüm ve Davranış > Sistem Ayarları > Android SDK'sı'na 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 aşağıdaki adımları uygulayın:

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

    Android Studio, idea.properties dosyanız yoksa bir dosya oluşturmanızı ister.

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

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