Android Studio'yu yapılandırma

Android Studio, Java Development Kit (JDK) ve kullanılabilir RAM gibi sistem gereksinimlerinizi doğrulayan sihirbazlar ve şablonlar sunar. 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 belgede, Android Studio kullanımınızı özelleştirmek için 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 makinelerde bu dosyanın, Android Studio sürümünüze bağlı olarak studio64.vmoptions olarak adlandırılacağını unutmayın.
  • idea.properties: Eklentiler klasör yolu veya desteklenen maksimum dosya boyutu gibi Android Studio özelliklerini özelleştirin.

Emülatör ve cihaz kurulumu ile kullanımı hakkında ayrıntılı 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 saklanır. Yapılandırma dizinini bulmak için Dizinler başlıklı makaleyi inceleyin.

Aşağıdaki ortam değişkenlerini kullanarak başka yerlerdeki belirli geçersiz kılma dosyalarını işaret edebilirsiniz:

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

Hangi JDK'ların kullanılacağını yapılandırmak için Android derlemelerindeki Java sürümleri sayfasını ziyaret edebilirsiniz.

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 en sık ayarlanan seçenek maksimum yığın boyutudur. Ancak studio.vmoptions dosyasını kullanarak ilk 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 aşağıdaki adımları uygulayın:

  1. Yardım > Özel VM Seçeneklerini Düzenle'yi tıklayın. Android Studio için VM 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 VM Seçenekleri sayfasını inceleyin.

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

Android Studio program klasöründe bulunan studio.vmoptions dosyasını doğrudan düzenlemeyin. Android Studio'nun varsayılan VM seçeneklerini görüntülemek için dosyaya erişebilirsiniz ancak yalnızca kendi studio.vmoptions dosyanızı düzenleyerek Android Studio'nun önemli varsayılan ayarlarını geçersiz kılmadığınızdan emin olabilirsiniz. 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

Android Studio'da varsayılan olarak maksimum yığın boyutu 1.280 MB'tır. Büyük bir proje üzerinde çalışıyorsanız veya sisteminizde çok fazla RAM varsa çekirdek IDE, Gradle daemon ve Kotlin daemon gibi Android Studio süreçleri için maksimum yığın boyutunu artırarak performansı iyileştirebilirsiniz.

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

1.şekil Ö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 uygulanabilmesi 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ı iş arkadaşlarınızın projelerine aktarması için kullanılabilir hale getirebilirsiniz.

Daha fazla bilgi için IntelliJ IDEA'daki IDE ayarlarını paylaşma başlıklı makaleyi inceleyin.

IDE özelliklerinizi özelleştirme

idea.properties dosyası, Android Studio'nun 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. Dosyayı düzenleyerek özelleştirilmiş IDE özelliklerinizi ekleyin.

Aşağıdaki idea.properties dosyası, sıkça özelleştirilen 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 düşük özelliklere sahip bir makinede çalıştırıyorsanız (sistem gereksinimlerine bakın) IDE'yi makinenizdeki performansı artıracak şekilde aşağıdaki gibi özelleştirebilirsiniz:

  • Android Studio'nun kullanabileceği maksimum yığın boyutunu küçültün: Android Studio'nun maksimum yığın boyutunu 512 MB'a düşürün. 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 yeni performans iyileştirmelerinden yararlanmak için Gradle'ın 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.
  • Güç tasarrufu modunu etkinleştirin: Güç tasarrufu modunu etkinleştirerek hata vurgulama ve anında inceleme, otomatik açılan kod tamamlama ve otomatik artımlı arka plan derlemesi gibi bellek ve pil açısından yoğun olan bir dizi arka plan işlemini kapatın. Güç tasarrufu modunu etkinleştirmek 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. 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 şekilde lint kontrollerini seçmek veya seçimini 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 cihazda hata ayıklayarak Android Studio'nun genel performansını artırın. Emülatörde hata ayıklama, fiziksel cihazda hata ayıklamaya 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, gereken 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ı bildirme başlıklı makaleyi inceleyin.

  • Gradle için kullanılabilen maksimum yığın boyutunu küçültün: gradle.properties dosyasındaki org.gradle.jvmargs özelliğini geçersiz kılarak Gradle'ın maksimum yığın boyutunun değerini varsayılan 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 etkin olmadığından 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) tıklayın.
    2. Sol bölmede Build, Execution, Deployment (Derleme, Yürütme, Dağıtım) seçeneğini genişletin ve ardından Compiler'ı (Derleyici) tıklayın.
    3. Bağımsız modülleri paralel olarak derle seçeneğinin işaretlenmediğinden emin olun.
    4. Bir 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 aracı bağlantı noktaları olarak işlev görür ve internet bağlantılarına güvenlik ve gizlilik katar.

Android Studio'nun güvenlik duvarı arkasında çalıştırılmasını 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 yapın.

Android Studio proxy'sini ayarlama

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

  1. Menü çubuğunda Dosya > Ayarlar'ı tıklayın (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 proxy yapılandırma URL'si kullanmak istiyorsanız Proxy ayarlarını otomatik olarak algıla'yı, ayarları kendiniz girmek istiyorsanız 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 özel HTTP proxy ayarları için proxy ayarlarını her uygulama modülü için gerektiği şekilde build.gradle dosyasında 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 proxy ayarlarını gradle/gradle.properties dosyasında ayarlayı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'da Android Studio performansını optimize etme

Windows'da Android Studio'nun 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.

Antivirüs yazılımının derleme hızı üzerindeki etkisini en aza indirme

Bazı antivirüs yazılımları, Android Studio derleme sürecini etkileyerek derlemelerin çok daha yavaş çalışmasına neden olabilir. Android Studio'da 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 birçok dosya oluşturulur. Antivirüs yazılımınızda gerçek zamanlı tarama etkinse antivirüs yazılımı, her dosya oluşturulduğunda bu dosyayı tararken derleme işleminin durdurulmasına neden olabilir.

Bu sorunu önlemek için belirli dizinleri antivirüs yazılımınızda gerçek zamanlı taramadan hariç tutabilirsiniz. Windows için Build Analyzer, etkin taramadan hariç tutulması gereken dizinleri belirlemenize ve bunları hariç tutmanıza yardımcı olabilir.

Aşağıdaki listede, gerçek zamanlı taramanın dışında bırakabileceğ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 ile kontrol edilen ortamlar için dizin konumlarını özelleştirme

Bir grup ilkesi, bilgisayarınızda gerçek zamanlı taramadan hariç tutabileceğiniz dizinleri sınırlıyorsa Android Studio dizinlerinizi, merkezi grup ilkesinin 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 zaten hariç tuttuğu dizindir:

Gradle önbelleği
GRADLE_USER_HOME ortam değişkenini C:\WorkFolder\.gradle işaret edecek şekilde tanımlayın.
Android Studio projeleri
Proje dizinlerini C:\WorkFolder öğesinin uygun bir alt dizinine taşıyın veya bu alt dizinde 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çın, ardından Görünüm ve Davranış > Sistem Ayarları > Android SDK'ya gidin.

  2. Android SDK Location 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 Help > Edit Custom Properties'i (Yardım > Özel Özellikleri Düzenle) tıklayın.

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

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

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