Bu sayfada, Android Studio'daki yaygın sorunları ve yapılandırma problemlerini gidermeyle ilgili yönergeler yer almaktadır.
Yüksek yoğunluklu ekranlar
Android Studio, 1.5 sürümünden itibaren tüm platformlarda yüksek yoğunluklu ekranlar (ör. HiDPI ve Retina monitörler) için destek sunar.
Ölçeklendirme faktörü ayarları
Android Studio, ekranınızın ölçeklendirme faktörünü aşağıdaki gibi belirler:
- Mac
- Retina ekranlarda kullanıcı arayüzü öğeleri% 200 oranında ölçeklendirilir ve resimler yüksek çözünürlükte oluşturulur. Ölçeklendirme nedeniyle bulanıklık olmamalıdır. Bu durum, çoklu monitör yapılandırmaları için de geçerlidir. %100 (Retina olmayan ekranlar için) ve %200 (Retina ekranlar için) dışındaki ölçeklendirme faktörlerinin desteklenmediğini unutmayın.
- Windows
- Android Studio, kullanıcı arayüzü öğelerinin ölçeklendirme faktörünü belirlemek için birincil ekranın DPI ayarlarını kullanır. Resimlerde ölçeklendirme faktörü %150'den düşükse normal çözünürlüklü resimler büyütülür. Ölçeklendirme faktörü %150'den büyükse yüksek çözünürlüklü resimler uygun şekilde ölçeklendirilir.
- Linux
- Android Studio, ölçeklendirme faktörünü belirlemek için önce "Metin Ölçeklendirme Faktörü"ne, ardından XWindow sistemi DPI ayarına bakar.
hidpi
özelliğini idea.properties
dosyasında IDE özelliklerinizi özelleştirme bölümünde açıklandığı şekilde ayarlayarak DPI'yı manuel olarak ayarlayabilirsiniz. Bu özelliğin Mac bilgisayarlarda etkisi olmadığını unutmayın.
Bu özellik aşağıdaki gibi çalışır:
hidpi=true
- Sistem ayarlarını yoksayarak DPI'yı 192'ye (200% ölçeklendirme) ayarlar.
hidpi=false
- Sistem ayarlarını yok sayarak DPI'yı 96'ya (%100 ölçeklendirme) ayarlar.
Yüksek yoğunluklu ekranlarda bulanık veya pikselli öğeler
Android Studio'nun kullanıcı arayüzünün bir veya daha fazla öğesi yüksek yoğunluklu ekranınızda bulanık ya da pikselli görünüyorsa aşağıdaki sorunlardan birini yaşıyor olabilirsiniz:
- Android Studio kullanıcı arayüzünün çoğu iyi görünmesine rağmen belirli bir simge bulanık veya pikselli görünüyorsa ya da belirli bir kullanıcı arayüzü öğesinde yanlış boyutlu bir yazı tipi kullanılıyorsa bu öğe, HiDPI desteği için henüz tam olarak güncellenmemiştir. Lütfen Yardım > Geri Bildirim Gönder'i tıklayarak hata bildirin. Lütfen ekran görüntüsü ve sistem yapılandırmanızla ilgili mümkün olduğunca fazla bilgi ekleyin.
- Windows veya Linux makine kullanıyorsanız ve ekranınızda% 100 ya da %200 dışında bir ölçeklendirme faktörü kullanılıyorsa ölçeklendirme nedeniyle resimler biraz bulanık görünebilir.
- Windows makine kullanıyorsanız ve Denetim Masası'nda Windows yazı tipi boyutunu değiştirdiyseniz yazı tipi bulanık veya pikselli görünebilir. Windows'ta oturumu kapatıp tekrar açarak bu sorunu çözebilirsiniz.
- Windows 8.1 veya sonraki sürümlerin yüklü olduğu çoklu monitör kurulumunda, bir pencereyi bir ekrandan farklı çözünürlüğe veya DPI'ya sahip başka bir ekrana taşıdığınızda yazı tipi veya görüntü sorunları yaşayabilirsiniz (186007 numaralı hataya bakın). Şu anda bu sorun için bilinen bir geçici çözüm yoktur.
- JRE 1.8'in eski sürümlerinde bulanık yazı tipleriyle ilgili bir sorun vardı (Özellikle JRE 1.8.0_25-b18 amd64, bkz. hata 192316). Android Studio, 2.2 sürümünden itibaren JDE'yi içeren, desteklenen en son JDK'nın paketlenmiş bir sürümünü içerir. Bu sorunu çözmek için Android Studio'yu 2.2 veya sonraki bir sürüme güncelleyin ve File > Project Structure > SDK Location'ı tıklayıp Use embedded JDK onay kutusunu işaretleyerek paketlenmiş JDK'yı kullanmaya geçin.
Yüksek yoğunluklu ekranlarda yanlış boyutlandırılmış öğeler
Yüksek yoğunluklu ekranınızda Android Studio kullanıcı arayüzünün tamamı yanlış boyuttaysa ölçeklendirme faktörü ayarları bölümüne bakın. Android Studio kullanıcı arayüzünün bazı öğeleri yüksek yoğunluklu ekranınızda yanlış boyutta görünüyorsa ancak diğerleri doğru boyutta görünüyorsa aşağıdaki sorunlardan birini yaşıyor olabilirsiniz:
- Özel bir düzenleyici şeması kullanıyorsanız düzenleyici yazı tipi, yüksek yoğunluklu bir ekranda kullanıcı arayüzünün diğer öğelerine kıyasla çok küçük veya çok büyük görünebilir. Bu sorunu düzeltmek için Dosya > Ayarlar'ı, ardından Düzenleyici > Renkler ve Yazı Tipleri > Yazı Tipi'ni tıklayın ve düzenleyici yazı tipinin boyutunu değiştirin. Varsayılan şema etkin olduğunda düzenleyici yazı tipi boyutunun otomatik olarak ölçeklendirildiğini (186920 numaralı hataya bakın) unutmayın.
- Android Studio'nun bazı kullanıcı arayüzü öğeleri doğru boyutta ancak diğerleri çok küçük veya çok büyükse 186923 numaralı sorunu yaşıyor olabilirsiniz. Lütfen Yardım > Geri Bildirim Gönder'i tıklayarak hata bildirin. Lütfen ekran görüntüsü ve sistem yapılandırmanızla ilgili mümkün olduğunca fazla bilgi ekleyin.
Proje senkronizasyonu sorunları
Projenizi senkronize etmeye çalışırken şu hata mesajını alabilirsiniz: "İnternet bağlantısı reddedildi. ('Permission denied: connect')" (İzin reddedildi: bağlanma).
Bu hata mesajını, Android Studio'daki
-Djava.net.preferIPv4Stack=true
dosyanıza aşağıdaki gibi sistem özelliğini ekleyerek düzeltebilirsiniz:
gradle.properties
- Android Studio'da
gradle.properties
dosyanızı açın. - Dosyaya aşağıdaki satırı ekleyin:
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
gradle.properties
dosyanıza başka Gradle JVM bağımsız değişkenleri eklediyseniz bu özelliği aşağıdaki örnekte gösterildiği gibi aynı satıra ekleyebilirsiniz:org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
- Değişikliklerinizin geçerli olması için Android Studio'yu yeniden başlatın.
- Projenizi senkronize etmek için Sync Project with Gradle Files'ı (Projeyi Gradle Dosyalarıyla Senkronize Et) tıklayın.
Windows'da IDE'yi güncelleme sorunları
Windows'da, bir işlem tarafından kullanılan dosyalar silinemez. IDE'deki yerleşik güncelleme mekanizmasını kullanmaya çalıştığınızda bazen güncellemeyi yüklemeyi reddeder ve genellikle "C:\some\path\file silinemiyor" gibi bir hata mesajı gösterir.
Bu sorunu çözmek için görev yöneticisini açın ve dosyayı kullanıyor olabilecek işlemleri (ör. Gradle daemon'ları) sonlandırmayı deneyin.
minSdkVersion sorunları
Android Destek Kitaplıkları'nın eski bir sürümünü kullanıyorsanız aşağıdaki gibi bir hata mesajı alabilirsiniz:
:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error: uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage
Bu sorunu çözmek için SDK Yöneticisi'ni kullanarak Android Destek Kitaplıkları'nın en son (önizleme olmayan) sürümlerine güncelleyin. Destek kitaplıklarını ayarlama hakkında daha fazla bilgi için Destek kitaplığı kurulumu başlıklı makaleyi inceleyin.
Android Emulator ile ilgili sorunlar
Android Emulator sorun giderme başlıklı makaleyi inceleyin.
Dizinler
Android Studio, ayarları, önbellekleri, eklentileri ve günlükleri depolamak için aşağıdaki dizinleri kullanır.
Windows
- Yapılandırma (idea.config.path):
%APPDATA%\Google\AndroidStudioVERSION
- Eklentiler (idea.plugins.path):
%APPDATA%\Google\AndroidStudioVERSION\plugins
- Sistem (idea.system.path):
%LOCALAPPDATA%\Google\AndroidStudioVERSION
- Günlükler (idea.log.path):
%LOCALAPPDATA%\Google\AndroidStudioVERSION\log
%APPDATA%
örneği:C:\Users\YourUserName\AppData\Roaming
%LOCALAPPDATA%
örneği:C:\Users\YourUserName\AppData\Local
macOS
- Yapılandırma (idea.config.path):
~/Library/Application Support/Google/AndroidStudioVERSION
- Eklentiler (idea.plugins.path):
~/Library/Application Support/Google/AndroidStudioVERSION/plugins
- Sistem (idea.system.path):
~/Library/Caches/Google/AndroidStudioVERSION
- Günlükler (idea.log.path):
~/Library/Logs/Google/AndroidStudioVERSION
Linux
- Yapılandırma (idea.config.path):
~/.config/Google/AndroidStudioVERSION
- Eklentiler (idea.plugins.path):
~/.local/share/Google/AndroidStudioVERSION
- Sistem (idea.system.path):
~/.cache/Google/AndroidStudioVERSION
- Günlükler (idea.log.path):
~/.cache/Google/AndroidStudioVERSION/log
Her dizin aşağıdaki biçimde listelenir:
<informal directory name>
(<IDE property>
):<default path>
.
Değiştir:
AndroidStudio
ile birlikte kullanın. Kararlı sürümlerdeAndroidStudio
, RC ve Canary sürümlerinde iseAndroidStudioPreview
kullanılır.- Sürümle birlikte
VERSION
. Örneğin:2023.1
veya2023.3
.