Beri kami log,
dan kami bisa memperbaikinya.

1Apa isi log

FT8AF memelihara berkas teks bergulir bernama debug.log di direktori data aplikasinya. Ia menangkap hal-hal seperti:

• Peristiwa pencolokan / pencabutan USB dan perangkat CAT mana yang cocok
• Percobaan koneksi otomatis dan kegagalan apa pun
• Bingkai serial CAT yang dikirim ke dan diterima dari radio
• Pergantian band dan frekuensi
• Peristiwa siklus hidup saat aplikasi mulai dan berhenti

Ini teks biasa, aman dibaca, dan tak menyertakan kata sandi atau kunci API unggah. Lihat bagian privasi di bawah jika Anda ingin menelaahnya sebelum membagikan.

2Buka mode debug

Cara termudah mengambil log memakai layar debug di dalam aplikasi — tanpa komputer, tanpa pengelola berkas, tanpa izin folder Android-data. Layar tersembunyi secara default dan Anda membukanya seperti opsi pengembang Android: ketuk blok versi tujuh kali.

1. Buka tab Settings di FT8AF.
2. Gulir ke paling bawah — bagian ABOUT.
3. Ketuk FAQ & Support. Dialog About terbuka, menampilkan versi aplikasi dan deskripsi yang dimulai dengan "FT8, made easy."
4. Ketuk teks deskripsi itu tujuh kali berturut-turut. Setelah ketukan ketujuh, mode debug menyala dan bertahan antar peluncuran.
5. Tutup dialog About. Baris Debug baru kini muncul di bagian ABOUT, tepat di bawah FAQ & Support.

3Buka Debug & bagikan

Ketuk baris Debug baru. Penampil log layar penuh terbuka, menampilkan beberapa ratus baris terakhir debug.log secara langsung — ia menyegarkan setiap beberapa detik dan menggulir otomatis ke bawah.

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

Dari bilah alat atas:

Share

Membuka lembar berbagi Android dengan debug.log terlampir sebagai berkas teks (subjek "FT8AF debug.log"). Pilih Gmail untuk mengirimnya langsung ke kami lewat email, atau aplikasi apa pun yang menangani lampiran — Drive, Outlook, Slack, Signal, Telegram, aplikasi Files sistem, semuanya berfungsi.

Clear

Menghapus log saat ini. Berguna jika Anda ingin mulai bersih sebelum mereproduksi bug — cukup tekan Clear, keluar dari dialog, reproduksi masalahnya, kembali, dan bagikan. Log yang lebih pendek memudahkan kami menemukan peristiwa yang relevan.

Logcat: ON / OFF

Saat ON, penampil juga menambahkan keluaran logcat terbaru dari proses aplikasi sendiri — berguna saat crash atau bug audio tak sepenuhnya tertangkap di debug.log. Ekor logcat ikut serta saat Anda mengetuk Share.

4Cadangan: aplikasi Files

Jika karena suatu alasan Anda tak bisa mencapai layar Debug di dalam aplikasi — build lama, pembukaan tak berhasil, Anda lebih suka pengelola berkas — berkas log juga ada di disk di:

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

1. Buka aplikasi Files (atau My Files) di ponsel Anda.
2. Navigasi ke Penyimpanan internal → Android → data. Di sebagian perangkat, Android menyembunyikan folder ini secara default; ketuk menu tiga titik dan aktifkan Tampilkan berkas tersembunyi atau Folder sistem.
3. Buka folder bernama com.bg7yoz.ft8cn, lalu files. Anda harusnya melihat debug.log di dalamnya.
4. Tekan lama debug.log dan ketuk Bagikan.

5Cadangan: ADB

Untuk pengembang dengan komputer dan alat adb Android:

1. Di ponsel Anda, aktifkan Opsi pengembang → USB debugging.
2. Colokkan ponsel ke komputer dengan USB, terima permintaan otorisasi debug.
3. Dari terminal, pastikan ponsel terlihat:

   adb devices -l

4. Tarik log:

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

   Pada penyiapan banyak perangkat, targetkan ponsel secara eksplisit dengan -s <serial>.

6Tulis isu

Laporan bug yang berguna itu kecil — tiga atau empat paragraf pendek sudah cukup. Pola yang selalu berhasil:

1. Apa yang Anda lakukan? "Mencolok FT-891 saya, mengetuk CQ di 20m." Tindakan konkret secara berurutan. Tak perlu mendeskripsikan aplikasi — cukup apa yang Anda ketuk.
2. Apa yang Anda harapkan terjadi? "Saya berharap radio mengudara dan aplikasi mulai mengirim nada di 14.074."
3. Apa yang sebenarnya terjadi? "Strip TX tetap di LISTENING. Tanpa PTT, tanpa nada." Jika ada yang muncul di layar — toast galat, antarmuka beku, waterfall aneh — deskripsikan. Tangkapan layar sangat berharga.
4. Seberapa sering? Setiap kali? Hanya setelah ponsel tidur? Hanya di 6m? Apa pun yang bisa Anda pastikan mempersempit pencarian.
5. Lampirkan log. Ambil debug.log tepat setelah mereproduksi masalah — baris terbaru paling berguna.

7Templat isu

Salin ini ke isu baru dan isi bagian kosongnya:

## 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.)

8Jika aplikasi crash

Saat FT8AF crash total, Android menyimpan laporan crash terpisah. Dua tempat untuk dilihat:

• Jika Anda mendapatkannya dari Google Play, ikut sertakan diri sekali ke pelaporan crash anonim, dan kami akan melihat jejak tumpukan otomatis. Anda tak perlu melakukan apa-apa — tapi menambahkan "Saya baru mengirim laporan crash dari perangkat X sekitar <waktu>" ke isu membantu kami mencocokkannya.
• Jika Anda punya ADB, log sistem langsung biasanya berisi jejak crash tepat setelah terjadi:

  adb logcat -d > logcat.txt

  Lampirkan logcat.txt selain debug.log.

9Privasi

Log debug hanyalah teks. Ia menangkap peristiwa operasi aplikasi, bukan data pribadi Anda. Anda akan melihat baris seperti:

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

Yang tak ada di sana: kunci API Cloudlog atau QRZ, kata sandi akun Anda, foto, kontak, atau lokasi. Callsign dan lokator Anda ada di sana, karena keduanya mengenali stasiun Anda — tapi itu toh informasi publik bagi amatir berlisensi.

Jika Anda ingin menelaah atau menyunting sebelum mengirim, berkasnya teks biasa UTF-8. Editor teks apa pun akan membukanya.