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ınstudio64.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
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:
- 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. 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:
- Menü çubuğundan Dosya > Ayarlar'ı tıklayın (macOS'te Android Studio > Tercihler).
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.
Yığın boyutlarını ayarlayın.
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. 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:
- 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. 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:
- Dosya > Ayarlar'ı (macOS'te, Android Studio > Tercihler'i) tıklayarak Ayarlar iletişim kutusunu açın.
- Sol bölmede, Düzenleyici bölümünü genişletin ve İncelemeler'i tıklayın.
- Projenize uygun lint kontrollerini seçmek veya seçimlerini kaldırmak için onay kutularını tıklayın.
- 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ındaorg.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:
- Dosya > Ayarlar'ı (macOS'te, Android Studio > Tercihler'i) tıklayarak Ayarlar iletişim kutusunu açın.
- Sol bölmede Derleme, Yürütme, Dağıtım'ı genişletin ve ardından Derleyici'yi tıklayın.
- Bağımsız modülleri paralel olarak derleyin seçeneğinin işaretli olmadığından emin olun.
- 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.
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:
- Menü çubuğundan Dosya > Ayarlar'ı (macOS'te Android Studio > Tercihler'i tıklayın).
- 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.
- 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.
- 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.
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.
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 edecekGRADLE_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:
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.
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:
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.idea.properties
dosyanıza aşağıdaki satırı ekleyin:idea.system.path=c:/workfolder/studio/caches/trunk-system