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 Logcat 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.
• Logcat 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

Cihaz konumu, arama sorguları, rota oluşturma sonuçları ve navigasyon verileri gibi özel bilgiler içerebileceğinden logcat günlüklerini gönderirken dikkatli olun.

OsmAnd Uygulamasından Günlük Gönderme (Android)

1. Menü → Yardım → Çökme günlük kaydı gönder (Logcat günlük kaydı gönder) bölümüne gidin. 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 Logcat 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. E-posta otomatik olarak oluşturulacaktır.
3. Gönder düğmesine dokunun.

iOS Cihazlardan Günlük Gönderme

1. iOS cihazlardan günlükler gönderilebilir:

   • Otomatik olarak.

     • OsmAnd uygulaması Menü → Yardım → Hata bildir (Rapor gönder) bölümüne gidin.
     • Ardından, e-posta uygulamanızı kullanarak günlükleri crash@osmand.net adresine göndermenizi öneririz.

   • Manuel olarak.

     • iOS sistem uygulaması Dosyalar → iPhone'umda (veya iPad'imde) → OsmAnd Haritalar → Günlükler bölümüne gidin.

   

2. IPS formatında günlükleri ve yetkilendirme verilerini gönderin:

   • iOS Ayarlar → Analiz → Analiz Verileri → OsmAnd Haritalar ips-format dosyası bölümüne gidin (iOS 17'ye kadar).
   • iOS Ayarlar → Gizlilik ve Güvenlik → Analiz ve İyileştirmeler → Analiz Verileri → OsmAnd Haritalar ips-format dosyası bölümüne gidin (iOS 18'den itibaren).
   • Ardından, e-posta uygulamanızı kullanarak günlükleri crash@osmand.net adresine göndermenizi öneririz.

   

Tombstone Dosyaları Gönderme (Android)

Çok Önemli

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: crash@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, 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 İstemi'ni 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ı crash@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 crash@osmand.net adresine gönderin.

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