Bize günlüğü verin,
ve onu düzeltebiliriz.

1Günlükte neler var

FT8AF, uygulama veri dizininde debug.log adlı dönen bir metin dosyası tutar. Şunun gibi şeyleri yakalar:

• USB takma / çıkarma olayları ve hangi CAT aygıtının eşleştiği
• Otomatik bağlanma denemeleri ve varsa başarısızlıklar
• Telsize gönderilen ve telsizden alınan CAT seri çerçeveleri
• Bant ve frekans değişiklikleri
• Uygulama başlayıp durduğunda yaşam döngüsü olayları

Düz metindir, okunması güvenlidir ve parola veya yükleme API anahtarı içermez. Paylaşmadan önce gözden geçirmek isterseniz aşağıdaki gizlilik bölümüne bakın.

2Hata ayıklama modunu açın

Günlüğü çekmenin en kolay yolu, uygulama içi bir hata ayıklama ekranı kullanır — bilgisayar yok, dosya yöneticisi yok, Android-data klasörü izinleri yok. Ekran varsayılan olarak gizlidir ve onu Android'in geliştirici seçenekleri gibi açarsınız: sürüm bloğuna yedi kez dokunarak.

1. FT8AF'de Settings sekmesini açın.
2. En alta kaydırın — ABOUT bölümü.
3. FAQ & Support'a dokunun. About iletişim kutusu açılır, uygulama sürümünü ve "FT8, made easy." ile başlayan bir açıklamayı gösterir.
4. O açıklama metnine arka arkaya yedi kez dokunun. Yedinci dokunuştan sonra hata ayıklama modu açılır ve başlatmalar arasında kalıcı olur.
5. About iletişim kutusunu kapatın. ABOUT bölümünde, FAQ & Support'un hemen altında artık yeni bir Debug satırı görünür.

3Debug'ı açın & paylaşın

Yeni Debug satırına dokunun. Tam ekran bir günlük görüntüleyici açılır, debug.log'un son birkaç yüz satırını canlı gösterir — her birkaç saniyede bir yenilenir ve otomatik olarak en alta kayar.

13:42:01  USB attach: vid=10c4 pid=ea60
13:42:01  autoConnect attempt #1 → SUCCESS
13:42:02  CAT > FE FE 94 E0 03 FD
13:42:02  CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05  band → 20m, freq 14.074 MHz
13:42:18  decode: 14 messages in 64 ms
13:42:33  decode: 11 messages in 58 ms

Üst araç çubuğundan:

Share

debug.log'u bir metin dosyası olarak ekli (konu satırı "FT8AF debug.log") Android'in paylaşım sayfasını açar. Bize doğrudan e-postayla göndermek için Gmail'i veya ekleri işleyen herhangi bir uygulamayı seçin — Drive, Outlook, Slack, Signal, Telegram, sistem Dosyalar uygulaması, hepsi çalışır.

Clear

Mevcut günlüğü siler. Bir hatayı yeniden oluşturmadan önce temiz başlamak isterseniz yararlı — sadece Clear'a basın, iletişim kutusundan çıkın, sorunu yeniden oluşturun, geri gelin ve paylaşın. Daha kısa günlük, ilgili olayları görmemizi kolaylaştırır.

Logcat: ON / OFF

ON iken görüntüleyici, uygulamanın kendi işleminden son logcat çıktısını da ekler — bir çökme veya ses hatası debug.log'da tam yakalanmadığında yararlı. Logcat kuyruğu Share'a dokunduğunuzda sizinle gider.

4Yedek: Dosyalar uygulaması

Bir nedenle uygulama içi Debug ekranına ulaşamazsanız — eski derleme, açma işe yaramadı, sadece dosya yöneticisini tercih ediyorsunuz — günlük dosyası diskte de şurada yaşar:

/Android/data/com.bg7yoz.ft8cn/files/debug.log

1. Telefonunuzda Dosyalar (veya Dosyalarım) uygulamasını açın.
2. Dahili depolama → Android → data'ya gidin. Bazı cihazlarda Android bu klasörü varsayılan olarak gizler; üç nokta menüsüne dokunun ve Gizli dosyaları göster veya Sistem klasörleri'ni etkinleştirin.
3. com.bg7yoz.ft8cn adlı klasörü, sonra files'ı açın. İçinde debug.log'u görmelisiniz.
4. debug.log'a uzun basın ve Paylaş'a dokunun.

5Yedek: ADB

Bir bilgisayarı ve Android'in adb aracı olan geliştiriciler için:

1. Telefonunuzda Geliştirici seçenekleri → USB hata ayıklama'yı etkinleştirin.
2. Telefonu bilgisayara USB ile bağlayın, hata ayıklama yetkilendirme istemini kabul edin.
3. Bir terminalden telefonun görünür olduğunu doğrulayın:

   adb devices -l

4. Günlüğü çekin:

   adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/files/debug.log .

   Çok cihazlı kurulumlarda telefonu açıkça -s <serial> ile hedefleyin.

6Konuyu yazın

Yararlı bir hata raporu küçüktür — üç ya da dört kısa paragraf yeterlidir. Her zaman işe yarayan desen:

1. Ne yaptınız? "FT-891'imi taktım, 20m'de CQ'ya dokundum." Sırayla somut eylemler. Uygulamayı anlatmaya gerek yok — sadece neye dokunduğunuz.
2. Ne olmasını beklediniz? "Telsizin anahtarlanmasını ve uygulamanın 14.074'te ton göndermeye başlamasını bekledim."
3. Gerçekte ne oldu? "TX şeridi LISTENING'de kaldı. PTT yok, ton yok." Ekranda bir şey belirdiyse — hata bildirimi, donmuş arayüz, garip şelale — onu anlatın. Bir ekran görüntüsü altın değerinde.
4. Ne sıklıkta? Her seferinde mi? Yalnızca telefon uyuduktan sonra mı? Yalnızca 6m'de mi? Belirleyebildiğiniz her şey aramayı daraltır.
5. Günlüğü ekleyin. Sorunu yeniden oluşturduktan hemen sonra debug.log'u çekin — en yeni satırlar en yararlısıdır.

7Konu şablonu

Bunu yeni bir konuya kopyalayın ve boşlukları doldurun:

## What happened

(One or two sentences describing the bug)

## Steps to reproduce
1. (First thing you tapped)
2. (Second thing)
3. (...)

## Expected vs. actual

Expected: (what should have happened)
Actual:   (what did happen)

## Environment

- FT8AF version:   (Settings → About, or the release tag you installed)
- Source:          GitHub APK / Google Play / built from source
- Android version: (e.g. 14)
- Device:          (e.g. Pixel 8, Samsung S23, etc.)
- Radio:           (e.g. Yaesu FT-891 over USB-C)
- Cable:           (USB-C direct / OTG adapter / brand if relevant)

## Log

(Attach debug.log, or paste the last ~50 lines in a code block.)

8Uygulama çöktüyse

FT8AF tamamen çöktüğünde, Android ayrı bir çökme raporu tutar. Bakılacak iki yer:

• Onu Google Play'den aldıysanız, bir kez anonim çökme raporlamayı açın, biz yığın izini otomatik göreceğiz. Hiçbir şey yapmanız gerekmez — ama konuya "X cihazından <saat> civarında bir çökme raporu gönderdim" eklemek eşleştirmemize yardımcı olur.
• ADB'niz varsa, canlı sistem günlüğü genellikle çökme izini olduktan hemen sonra içerir:

  adb logcat -d > logcat.txt

  debug.log'a ek olarak logcat.txt'yi de ekleyin.

9Gizlilik

Hata ayıklama günlüğü yalnızca metindir. Uygulamanın çalışma olaylarını yakalar, kişisel verilerinizi değil. Şunun gibi satırlar göreceksiniz:

13:42:01 USB attach: vid=10c4 pid=ea60 (Silicon Labs CP210x)
13:42:01 autoConnect attempt #1 → SUCCESS
13:42:02 CAT > FE FE 94 E0 03 FD
13:42:02 CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05 band → 20m, freq 14.074 MHz

Orada olmayan: Cloudlog veya QRZ API anahtarları, hesap parolalarınız, fotoğraflar, kişiler veya konum. Çağrı işaretiniz ve lokatörünüz orada vardır, çünkü istasyonunuzu tanımlarlar — ama bunlar zaten lisanslı radyo amatörleri için herkese açık bilgidir.

Göndermeden önce gözden geçirmek veya sansürlemek isterseniz, dosya düz UTF-8 metnidir. Herhangi bir metin düzenleyici onu açar.