Kilitlenme Günlükleri

Genel Bakış

Kilitlenme günlükleri, geliştiricilerin uygulamanın çökmesine veya beklenmedik şekilde davranmasına neden olan sorunları ve hataları belirlemesine ve düzeltmesine yardımcı olan değerli tanılama araçlarıdır. Android cihazınızdan OsmAnd geliştirme ekibiyle günlükleri paylaşmak mümkündür. Şu anda, iOS kullanıcıları göndermek için yalnızca bir tür kilitlenme günlüğü seçeneğine sahiptir.

Kilitlenme ve Uygulama Günlükleri

OsmAnd, geliştiricilere iki tür veri göndermenize olanak tanır:

• Kilitlenme günlükleri. OsmAnd uygulaması çökmeye neden olan kritik bir hata veya istisna ile karşılaştığında oluşturulur. Bu günlükler, derleme verileri, yığın izlemeleri, hata mesajları ve diğer ilgili ayrıntılar dahil olmak üzere arıza sırasındaki uygulamanın durumu hakkında ayrıntılı bilgi sağlar.
• Geçerli oturum/uygulama günlükleri. Çeşitli olayları ve mesajları yakalayan OsmAnd günlük akışının bir kaydı. Bu günlükler, geliştiricilerin uygulama davranışını izlemesine, yürütme akışını izlemesine, belirli eylemleri izlemesine ve kilitlenmeyle ilgili olmayan sorunları araştırmasına yardımcı olur. Logcat günlükleri genellikle uygulamanın en son başlatıldığı zamandan itibaren etkinlik kayıtlarını içerir.

Özel bilgileriniz

Uygulama günlüklerini gönderirken dikkatli olun, çünkü cihaz konumu, arama sorguları, rota oluşturma sonuçları ve navigasyon verileri gibi özel bilgiler içerebilir.

OsmAnd Uygulamasından Günlük Gönderme

Android

iOS

1. Menü → Yardım → Çökme günlük kaydı gönder veya Logcat günlük kaydı gönder bölümüne gidin (iOS'ta Geçerli uygulama günlüğünü gönder). Durumunuza bağlı olarak uygun günlük türünü seçin. Günlük türleri arasındaki farklar için Kilitlenme ve Uygulama Günlükleri bölümüne başvurabilirsiniz.
2. Açılır menüde Gmail'i veya tercih ettiğiniz e-posta uygulamasını seçin. Günlükleri support@osmand.net adresine göndermenizi öneririz.
3. Gönder düğmesine dokunun.

Bellek Sorunları için Yığın Histogramı (Android)

Yalnızca Android

Yığın histogramı, uygulamanın Java belleğini dolduranları gösteren bir tablodur: sınıf adları, nesne sayıları ve boyutlarıyla birlikte. Geliştiricilerin uygulama yavaşladığında, donduğunda veya bir süre sonra kapandığında belleği neyin tükettiğini bulmasına yardımcı olur. Konumlarınızı, parça adlarınızı veya arama sorgularınızı içermez. OsmAnd cihazda tam bir bellek dökümü alır, bunu histograma dönüştürür ve dökümü hemen siler.

Döküm almak uygulamayı 5–10 saniye dondurur. Bu süre içinde ekrana dokunursanız Android OsmAnd yanıt vermiyor uyarısı gösterebilir. Bu nedenle otomatik toplama varsayılan olarak kapalıdır.

Ne zaman açmalısınız:

• OsmAnd kendi kendine kapanıyor veya yanıt vermiyor uyarısı tekrar tekrar gösteriyorsa, özellikle bir süre kullanımdan sonra veya arama, çok sayıda POI içeren harita ya da çok sayıda parça içeren Yerlerim açıldığında.
• Uygulama çalıştıkça yavaşlıyor ve yeniden başlatmak işe yarıyorsa.
• Çökme raporu uygulamanın bellek tükettiğini belirtiyorsa (OutOfMemoryError).
• OsmAnd desteği sizden bir yığın histogramı toplamanızı istediyse.

Ne zaman kapalı bırakmalısınız:

• Uygulama normal çalışırken günlük kullanım ve navigasyon.
• Her başlangıçta hemen oluşan çökmeler veya tek bir dosya açma gibi belirli bir eylemle ilgili çökmeler. Bu durumda normal bir kilitlenme günlüğü yeterlidir.

Nasıl toplanır ve gönderilir:

1. OsmAnd geliştirme eklentisini etkinleştirin ve Ana Menü → Eklentiler → OsmAnd geliştirme → Ayarlar → Bellek → Java belleği bölümüne gidin.
2. Yığın dökümü panelinde aşağıdakilerden birini seçin:
   • Yüksek kullanımda topla. Java belleği neredeyse dolduğunda histogram otomatik olarak toplanır, en fazla 30 dakikada bir ve bir sonraki çökme raporuna eklenir. Sorun tekrar oluşana kadar uygulamayı normal şekilde kullanmaya devam edin.
   • Şimdi topla ve analiz et. Histogramı hemen toplar ve sonucu gösterir. Uygulama zaten yavaşladığında ve Java belleği yüksek kullanım gösteriyorsa kullanın.
3. En son raporu geliştiricilere göndermek için Raporu paylaş düğmesine dokunun veya uygulama bir sonraki başladığında çökme iletişim kutusundan gönderin.
4. Rapor gönderildikten sonra Yüksek kullanımda topla seçeneğini kapatın.

Tombstone Dosyaları Gönderme (Android)

Kritik

Yalnızca ileri düzey kullanıcılar için!

Bazı karmaşık veya olağandışı durumlarda, Tombstone dosyaları gerekebilir. Bu dosyalar, çöken bir işlemdeki tüm iş parçacıkları (yalnızca hataya neden olan değil) için ayrıntılı yığın izlemeleri, eksiksiz bir bellek haritası ve tüm açık dosya tanımlayıcılarının bir listesini sağlar. Tombstone dosyaları, Android platformundaki yerel kodla ilgili sorunları ayıklamak ve teşhis etmek için hayati öneme sahiptir.

Cihazınızı Kullanma

Tombstone dosyalarını dışa aktarmak için Android sistem ayarlarını kullanarak bir hata raporu oluşturmanız gerekir:

1. Geliştirici seçeneklerini etkinleştirin (bu ekran varsayılan olarak gizlidir).

   • Ayarlar → Telefon hakkında → Yazılım bilgileri bölümüne gidin (bu yol Samsung cihazlar için geçerlidir).
   • Geliştirici modunun etkin olduğunu onaylayan bir açılır pencere gelene kadar Yapı numarasına yedi kez dokunun.

2. Genellikle ayarlar listesinin en altında bulunan Geliştirici seçeneklerine gidin. Arama işlevini de kullanabilirsiniz.

   • Hata raporu al seçeneğine dokunun.
   • Hata raporunun türünü seçin ve Rapor öğesine dokunun.

Hata raporu hazırlandıktan sonra bir bildirim alacaksınız. Raporu cihazınıza indirmek için bildirim kutusuna dokunun. Dosyayı açın ve tombstone dosyalarını OsmAnd geliştiriciler ekibine gönderin (e-posta: support@osmand.net).

note

Hata raporlarının uygulama kullanımı veya konum dahil olmak üzere özel veriler içerebileceğini lütfen unutmayın.

ADB Kullanma

Android Hata Ayıklama Köprüsü (ADB), geliştiricilerin uygulamalarını hata ayıklamasına olanak tanıyan bir komut satırı aracıdır. Tombstone dosyalarını dışa aktarmak için ADB'yi kullanmak üzere önce indirip yüklemeniz gerekir. Resmi Android geliştirici sitesinde sağlanan talimatları izleyin.

Cihazınızı Hazırlayın

Geliştirici seçeneklerinin etkinleştirildiğinden (bu ekran varsayılan olarak gizlidir) ve USB hata ayıklamasının açık olduğundan emin olun:

• Ayarlar → Telefon hakkında → Yazılım bilgileri bölümüne gidin.
• Geliştirici modunun etkin olduğunu onaylayan bir açılır pencere gelene kadar Yapı numarasına yedi kez dokunun.
• Geliştirici seçeneklerinde,enable USB hata ayıklamasını etkinleştirin.

Ardından, cihazınızı USB aracılığıyla iş istasyonunuza bağlayın. İlk kez bağlanıyorsanız, hata ayıklamaya izin vermek için bir açılır pencere görünecektir.

Hata Raporu Oluştur

1. Bir komut satırı terminali açın. Mac veya Linux'ta Terminal uygulamasını, Windows'ta ise Komut Satırı'nı kullanın.
2. cd komutunu kullanarak ADB'nin bulunduğu platform-tools klasörüne gidin (örneğin, 'cd /Users/Kullanıcıadı/İndirilenler/Araçlar').
3. Hata raporunu oluşturun:
   • Mac'te: adb bugreport
   • Windows'ta: adb.exe bugreport
4. Raporun oluşturulması için birkaç dakika bekleyin. Ortaya çıkan dosya platform araçları klasörüne kaydedilecektir.
5. Dosyayı açın.
6. tombstone_00, tombstone_01 ve benzeri dosyaları içeren tombstones klasörünü bulun.
7. Tombstone dosyalarını support@osmand.net adresine gönderin.

Rootlu Cihazları veya Android Studio Emülatörünü Kullanma

• Cihazınıza root erişimi ile doğrudan /data/tombstones klasörünü açabilirsiniz.

• Android Studio'da, Cihaz Dosya Gezgini'ne gitmek için emülatörü kullanın ve /data/tombstones klasörünü bulun. İçinde tombstone_00, tombstone_01 ve diğerleri gibi adlandırılmış dosyalar bulacaksınız. Bu dosyaları indirin ve support@osmand.net adresine gönderin.

Hata raporları hakkında daha fazla ayrıntı için Android belgelerine bakın.