Hata bildirin

Hata raporu doldurmak için bu sayfadaki adımları uygulayın. Hataları düzeltmek için sınırlı sayıda kaynak vardır, bu nedenle eksiksiz bilgi içeren hatalara öncelik verilir. Eksik hata raporları kapatıldı. Bu olursa ek bilgilerle birlikte hatanızı yeniden gönderin.

Halihazırda düzeltilmiş bir hatayı bildirmediğinizden emin olmak için araçların en son sürümlerini kullandığınızdan emin olun. Ayrıca, karşılaştığınız sorunun önceden bildirilip bildirilmediğini görmek için Android Studio sorun izleyicisinde benzer sorunları da arayabilirsiniz.

Hata bildirme

Bir hatayı bildirmek için aşağıdaki adımları uygulayın:

  1. Android Studio'da bir hata raporu açmak için Yardım > Geri Bildirim Gönder'i seçin.

    Bu, hata raporunu Android Studio sürümünüz, Kotlin veya Java sürümünüz ve sorunu doğru şekilde yeniden oluşturmak için gereken sistem bilgileriyle doldurduğundan, hata başlatmanın en kolay yoludur.

    Ayrıca hatanızı buradan bildirebilir ve sürüm bilgilerini kendiniz ekleyebilirsiniz.

  2. Sorununuzu giderebilmemiz için bir teşhis raporu ekleyin. Teşhis raporu zip dosyası oluşturmak için Yardım > Günlükleri ve Teşhis Verilerini Topla'yı tıklayın.

  3. Sorunun tekrar oluşmasına yönelik adımları tam olarak açıklayın. Kod snippet'leri, hatayı yeniden oluşturmak için kullanılabilecek bir GitHub projesi ve gözlemlediğiniz bilgilerin ekran görüntüleri veya kayıtları da dahil olmak üzere mümkün olduğunca fazla bilgi gönderin.

  4. Sorunu ayrıntılı bir şekilde açıklayın. Beklediğiniz sonucu ve onun yerine gözlemlediğiniz sonucu açıklayın.

  5. Hata raporu için açıklayıcı bir başlık seçin. Daha açıklayıcı bir başlık kullanmak, soruna göre sıralamayı kolaylaştırır.

Belirli hatalar için, aşağıdaki bölümlerde açıklandığı gibi ek bilgilere ihtiyacımız vardır:

Android Studio hatalarına ilişkin ayrıntılar

Android Studio'ya özgü hataları bildirmek için bu bölümde açıklandığı şekilde ek bilgiler sağlayın.

IDE kilitlenirse

IDE'nin kendisi çok yavaş veya tamamen donmuş görünüyorsa bu sayfada açıklandığı gibi birkaç iş parçacığı dökümü oluşturun ve bunları hata raporuna ekleyin. İş parçacığı dökümleri, IDE'nin onu yavaşlatan şeyleri gösterir.

IDE yavaş çalışıyor ancak donmuş değilse idea.log dosyasını hata raporunuza ekleyin. Dosyayı eklemek için Yardım > Günlükleri ve Teşhis Verilerini Topla veya Yardım > Giriş Dosyalarını Göster'i (macOS'te Yardım > Günlüğü Finder'da Göster) seçin. Bu dosya, IDE'nin günlüğe hatalar gönderip göndermediğini gösterir.

Yavaşlığı teşhis etmek için CPU profillerini kullanın

Android Studio'da yavaşlık yaşıyorsanız CPU profilleri bazen sorunun teşhis edilmesine yardımcı olabilir.

Android Studio Performans Testi eklentisini kullanarak CPU profili yakalamak için aşağıdaki adımları uygulayın:

  1. Eklentiyi yükleyin.

    • Android Studio'da, eklenti mağazasında "Performans Testi"ni arayın.
    • Alternatif olarak, eklenti web sitesinden Android Studio ile uyumlu bir sürüm indirebilirsiniz.
  2. CPU profilini oluşturun.

    1. Android Studio yavaş görünüyorsa CPU Kullanımı Profili Oluşturmayı Başlat'ı seçin.
    2. Gecikmenin sorunlu olduğu birkaç işlemi tekrarlayın (kod tamamlama, yazma ve vurgulamanın yetişmesini bekleme vb.).
    3. CPU Kullanım Profili Oluşturmayı Durdur'u tıklayın.
  3. Profil dosyasını paylaşın.

    CPU anlık görüntüsü dosya adını sağlayan ve snapshot-NNN biçimindeki bir balon görünür. Hata raporunuzda anlık görüntü dosyasını paylaşın.

IDE'de bellek tükenirse

Android Studio'da bellek sorunlarının yeniden oluşturulması ve raporlanması bazen zor olabilir. Android Studio bu sorunu çözmek için bir bellek kullanımı raporu ekler. Bu raporu, bellek sorunlarının kaynağını belirlemenize yardımcı olması için Android Studio ekibine gönderebilirsiniz.

Bellek kullanım raporu çalıştırma

Bellek kullanım raporu çalıştırmak için aşağıdaki adımları uygulayın:

  1. Menü çubuğundan Yardım > Bellek Kullanımını Analiz Et'i tıklayın.

    Android Studio, yığını döküme sokar ve IDE'yi yeniden başlatmanızı ister. IDE'yi yeniden başlatırsanız yığın dökümü analizi hemen başlar. Aksi takdirde, yığın dökümü analizi Android Studio'yu bir sonraki çalıştırmanızda başlar. Her iki durumda da IDE, bellek kullanım raporu Şekil 1'de gösterildiği gibi incelenmeye hazır olduğunda sizi bilgilendirir.

    Bellek kullanım raporunun incelenmeye hazır olduğunu belirten bildirim
    Şekil 1. Bellek kullanım raporu bildirimi.
  2. Raporu İncele'yi tıklayın.

    Raporu göndermeden önce içerdiği bilgileri inceleyebilirsiniz:

    Bellek kullanım raporu.
    Şekil 2. Bellek Kullanımı Raporu analizi.
  3. İncelemenizi bitirdikten sonra, raporun içeriğini bir dosyaya kopyalayın ve hata bildiriminde bulunurken bu dosyayı ekleyin.

    Rapor bilgilerini bu şekilde göndermeniz, Android Studio ekibinin bellek sorunlarınızı araştırırken sorun izleyiciyi kullanarak sizinle iletişim kurmasına olanak tanır.

IDE çökerse veya istisnalar verirse

Diğer kilitlenme türleri için Yardım > Günlükleri ve Teşhis Verilerini Toplama veya Yardım > Günlük Dosyalarını Göster'i (macOS'te Yardım > Günlüğü Bulucuda Göster) seçerek bulunan idea.log dosyasını ekleyin.

İş parçacığı dökümü oluşturma

İş parçacığı dökümü, JVM'de çalışan tüm iş parçacıklarının çıktısıdır. Her iş parçacığı için tüm yığın çerçevelerin bir çıktısını içerir. Bu, özellikle birkaç saniye arayla birkaç iş parçacığı dökümü oluşturursanız IDE'nin ne yapmakla meşgul olduğunu görmeyi kolaylaştırır.

IDE'nin sabit bir CPU ile son derece meşgul olduğu veya IDE'nin donmuş gibi göründüğü hataları bildirdiğinizde iş parçacığı dökümü, hangi kodun çok fazla iş yaptığını veya hangi iş parçacıklarının kaynak için rekabet ettiğini ve kilitlenmeye neden olduğunu belirleyebilir.

JDK, iş parçacığı yığını oluşturmak için kullanılabilecek jstack adlı bir araç sunar. Önce, Android Studio işleminin işlem kimliğini (PID) bulun. Bu işlemi yapmak için jps komutunu kullanın:

Linux veya macOS'te:

jps -mv | grep studio

Windows'da:

jps -mv | findstr studio

Aşağıdaki gibi uzun bir satır yazdırılır:

$ jps -mv | grep studio
37605 -Dfile.encoding=UTF-8 -ea -Dsun.io.useCanonCaches=false -Djava.net.preferIPv4Stack=true -Djna.nosys=true ...

İlk sayı (bu örnekte 37605), işlem kimliğidir.

Ardından, bir iş parçacığı dökümü oluşturun ve dump.txt dosyasına kaydedin:

jstack -l pid >> dump.txt

Bu işe yaramazsa iş parçacığı dökümü oluşturmanın platforma özgü bazı ek yolları vardır. Ayrıntılı talimatlar için IntelliJ Destek Ekibi'ne göz atın.

Derleme araçları ve Gradle hataları için ayrıntılar

Derleme araçları veya Gradle'daki hataları bildirmek için sorunu gösteren gerçek ya da örnek bir proje ekleyerek gerekli tüm bilgilerin yakalanmasını sağlayabilirsiniz. Paylaşmadan önce hassas bilgileri kaldırın.

Proje paylaşamıyorsanız kullandığınız araçların sürümlerini belirtin. (Hata bildirmeden önce en son kararlı sürümleri veya önizleme sürümlerini kullanmayı deneyin). Aracınızın sürümlerini bulmak için aşağıdakileri yapın:

  • Android Gradle eklentisi sürümü:

    1. Dosya > Proje Yapısı'nı seçin.
    2. Proje'yi tıklayın.
    3. Android Gradle Eklenti Sürümü'nü bulun.
  • Gradle sürümü:

    1. Dosya > Proje Yapısı'nı seçin.
    2. Proje'yi tıklayın.
    3. Gradle Sürümü'nü bulun.
  • Android Studio sürümü:

    1. Yardım > Hakkında'yı seçin.
    2. Android Studio Sürümü'nü bulun.

Ayrıca, uygun olduğu durumlarda aşağıdaki bilgileri ekleyin:

  • Bir davranış beklenmedik bir şekilde önceki bir sürümden geçerli sürüme değiştiyse her iki sürümü de belirtin.
  • Derleme bir hatayla başarısız olduysa derlemeyi --stacktrace seçeneğiyle (ör. ./gradlew <task> --stacktrace) komut satırından çalıştırın ve hata raporunuzda yığın izleme (stack trace) sağlayın.
  • Derleme beklenenden daha uzun sürerse aşağıdakilerden birini deneyin:
    • ./gradlew <task> --scan komutunu çalıştırın ve oluşturulan Gradle derleme taramasını hata raporunuzda paylaşın.
    • ./gradlew <task> -Pandroid.enableProfileJson=true uygulamasını çalıştırın ve <root-project>/build/android-profile dizininde oluşturulan Chrome izleme dosyalarını paylaşın.

Android Emulator hata ayrıntıları

Bilgi toplamak ve hata bildirmek üzere emülatörün genişletilmiş denetimlerini kullanmak için şu adımları izleyin:

  1. Emülatör panelinde Diğer'i tıklayın.
  2. Genişletilmiş denetimler penceresinde Hata Raporu'nu seçin.

    Bu işlemden sonra ekran görüntüsü, AVD yapılandırma bilgileri ve hata raporu günlüğü gibi hata raporu ayrıntılarının yer aldığı bir ekran açılır. Yeniden oluşturmak için gerekli adımları buraya girebilir veya bekleyip sonraki adımda oluşturulan rapora girebilirsiniz.

  3. Hata raporunun toplanmasını bekleyin, ardından Google'a gönder'i tıklayın.

    Hata raporunu bir klasöre kaydetmeniz için bir pencere açılır. Tarayıcınız ayrıca Google sorun izleyicisinde gerekli emülatör ayrıntılarının doldurulduğu bir rapor oluşturmak için de açılır.

  4. Raporda, hatayı yeniden oluşturma adımları gibi geri kalan ayrıntıları tamamlayın ve hata raporunu oluştururken kaydedilen dosyaları ekleyin.

Aksi takdirde, aşağıdaki ayrıntıları manuel olarak girin:

  • Emülatör sürümü

    1. Emülatörde Genişletilmiş denetimler'i açın.
    2. Yardım'ı tıklayın.
    3. Emülatör sürümünü bulmak için Hakkında sekmesini tıklayın.
  • Android SDK Araçları sürümü

    1. Araçlar > SDK Yöneticisi'ni seçin.
    2. SDK Araçları'nı tıklayın.
    3. Android SDK Araçları'nı bulun.
  • Ana Makine CPU Modeli

    • Linux'ta: /proc/cpuinfo uygulamasını açın.
    • Windows'da: Bilgisayarım'ı sağ tıklayın ve Özellikler'i seçin.
    • macOS'te: Apple simgesini seçin ve About This Mac'i (Bu Mac Hakkında) tıklayın.
  • Cihaz adı

    1. AVD Yöneticisi'nden, cihaza ait İşlemler sütunundaki menüyü açmak için tıklayın.
    2. Ayrıntıları Göster'i seçin (veya $avdname.avd/config.ini dosyasını açın).
    3. hw.device.name girişini bulun. Örneğin: hw.device.name=Nexus 5.