Android Studio'yu yapılandırma

Android Studio, Java Geliştirme Kiti (JDK) ve kullanılabilir 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:

• Sanal cihaz oluşturma ve yönetme
• Uygulamaları donanım cihazında çalıştırma
• OEM USB sürücülerini yükleme

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

Not: Yapılandırma dizininizi bulmak için Android Studio'da Yardım > Özel Sanal Makine Seçeneklerini Düzenle'ye gidin. Bir yapılandırma dosyası açılır. Yapılandırma dizininizi bulmak için yapılandırma dosyasının yolunu inceleyin.

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ümlerini 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 ayar, 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 Sanal Makine Seçeneklerini Düzenle'yi tıklayın. Android Studio için sanal makine seçeneklerini daha önce hiç 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 göz atı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ü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 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 çekirdek 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 sizi bilgilendirir.

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

En az 5 GB RAM'i olan 64 bit sistem kullanıyorsanız projeniz için yığın boyutlarını manuel olarak 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.

   

   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.

Not: Çok fazla bellek ayırmak performansı düşürebilir.

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. Daha sonra JAR dosyasını diğer projelerinize aktarabilir ve/veya JAR dosyasını kendi projelerine aktarmaları için iş arkadaşlarınızın kullanımına sunabilirsiniz.

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ştirilmiştir. 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ı, yaygın olarak özelleştirilmiş IDE özelliklerini içerir. Özelliklerin tam listesi için IntelliJ IDEA için idea.properties dosyasını inceleyin.

#---------------------------------------------------------------------
# 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ı 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'ye 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üncelleyin: En son performans iyileştirmelerinden yararlanmak için Gradle'ın 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 göz atın.
• Güç Tasarrufu Modunu Etkinleştirin: Hata vurgulama ve anında inceleme, otomatik pop-up kod tamamlama ve otomatik artımlı arka plan derlemesi gibi bellek ve pil gücü kullanan 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'i) 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ıklama yaparak Android Studio'nun genel performansını iyileştirin. Emülatörde hata ayıklama, 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 bağımlılık olarak yalnızca gerekli Google Play Hizmetleri'ni 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 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 küçültme: 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 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. Dosya > Ayarlar'ı (macOS'te, Android Studio > Tercihler'i) tıklayarak Ayarlar iletişim kutusunu açı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 derleyin seçeneğinin işaretli olmadığından emin olun.
  4. Bir değişiklik yaptıysanız değişikliğin geçerli olması için Uygula veya Tamam'ı tıklayın.

Proxy ayarlarını yapın

Proxy'ler, HTTP istemcileri ile web sunucuları arasında internet bağlantılarına güvenlik ve gizlilik katan ara bağlantı noktaları görevi görür.

Android Studio'yu güvenlik duvarı arkasında çalıştırmayı 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 (örneğin, sürekli entegrasyon sunucuları) çalıştırırken, Gradle derleme dosyasındaki proxy ayarlarını yapın.

Not: Android Studio paketinin ilk yüklenmesinden sonra, Android Studio internet erişimiyle veya çevrimdışı olarak çalışabilir. Ancak Android Studio; Kurulum Sihirbazı senkronizasyonu, üçüncü taraf kitaplık erişimi, uzak depolara erişim, Gradle başlatma ve senkronizasyonu ile Android Studio sürüm güncellemeleri için internet bağlantısı gerektirir.

Android Studio proxy'sini ayarlama

Android Studio, HTTP proxy ayarlarını desteklediğinden Android Studio'yu bir 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ğ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'si seçeneğini tıklayın. HTTP Proxy sayfası görünür.
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 başlıklı makaleyi inceleyin.
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 genelinde HTTP proxy ayarları için gradle/gradle.properties dosyasındaki 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 için Gradle Kullanıcı Kılavuzu'na bakın.

Not: Android Studio kullanırken Android Studio IDE HTTP proxy ayarları sayfasındaki ayarlar, gradle.properties dosyasındaki HTTP proxy ayarlarını geçersiz kılar.

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 birçok dosya oluşturulur. Virüsten koruma yazılımınızda gerçek zamanlı tarama etkinse virüsten koruma yazılımı, dosya oluşturulduğunda derleme işlemini her dosya tarandığında durmaya zorlayabilir.

Bu sorunu önlemek için virüsten koruma yazılımınızın belirli dizinlerini gerçek zamanlı taramadan hariç tutabilirsiniz.

Dikkat: Bilgisayarınızın kötü amaçlı yazılımlara karşı güvende olduğundan emin olmak için gerçek zamanlı taramayı veya virüsten koruma yazılımınızı tamamen devre dışı bırakmayın.

Aşağıdaki listede, gerçek zamanlı taramadan hariç tutabileceğ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ı tarafından denetlenen ortamlar için dizin konumlarını özelleştirin

Bir Grup Politikası hangi dizinleri bilgisayarınızdaki gerçek zamanlı taramadan hariç tutabileceğinizi 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 öğesine işaret edecek 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ı 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 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