Beri kami log,
dan kami bisa memperbaikinya.

1Apa isi log

SSTV-AF 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, frekuensi, dan mode SSTV
• 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 bekerja: ketuk blok versi tujuh kali.

1. Buka tab Settings di SSTV-AF.
2. Gulir ke paling bawah — bagian ABOUT.
3. Ketuk FAQ & Support. Dialog About terbuka, menampilkan versi aplikasi dan deskripsi yang dimulai dengan "SSTV, 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.230 MHz
13:42:18  RX start: VIS 0x3c → Scottie 1
13:42:20  slant est: +0.7 ms/line, corrected

Dari bilah alat atas:

Share

Membuka lembar berbagi Android dengan debug.log terlampir sebagai berkas teks (subjek "SSTV-AF 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 Share. 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 folder data aplikasi:

/Android/data/radio.ks3ckc.sstvaf/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 paket SSTV-AF, 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 dari folder data aplikasi:

   adb pull /sdcard/Android/data/radio.ks3ckc.sstvaf/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? "Menala ke 14.230, sebuah stasiun mulai mengirim Scottie 1." Tindakan konkret secara berurutan. Tak perlu mendeskripsikan aplikasi — cukup apa yang Anda ketuk.
2. Apa yang Anda harapkan terjadi? "Saya berharap gambar terlukis dengan bersih."
3. Apa yang sebenarnya terjadi? "Gambar masuk miring dan warnanya bergeser ke kiri." Jika ada yang muncul di layar — toast galat, antarmuka beku, waterfall aneh — deskripsikan. Tangkapan layar sangat berharga.
4. Seberapa sering? Setiap kali? Hanya di satu mode? Hanya setelah ponsel tidur? 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

- SSTV-AF version: (Settings → About, or the release tag you installed)
- Source:          GitHub APK / 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 SSTV-AF crash total, Android menyimpan laporan crash terpisah. Dua tempat untuk dilihat:

• Jika Anda memakai build dengan pelaporan crash, ikut sertakan diri sekali ke laporan anonim dan kami akan melihat jejak tumpukan otomatis. 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.230 MHz

Yang tak ada di sana: kunci API Cloudlog atau Wavelog, 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.