Wiki / バグの報告

ログを送ってください、
そうすれば直せます。

FT8AF は実行のたびに構造化されたイベントログを書き出します — CAT シリアル通信、USB 接続イベント、自動接続の試行、バンドの変更。フィールドのバグの大半はそこに記録されます。スマホから取り出し、GitHub の issue に放り込めば完了です。

1ログに何があるか

FT8AF は、アプリのデータディレクトリに debug.log という名のローリングなテキストファイルを保持します。次のようなものを記録します：

  • USB の接続 / 取り外しイベントと、どの CAT デバイスが一致したか
  • 自動接続の試行と、あれば失敗
  • 無線機に送受信した CAT シリアルフレーム
  • バンドと周波数の変更
  • アプリの起動・停止時のライフサイクルイベント

これはプレーンテキストで、読んでも安全で、パスワードやアップロード API キーは含みません。共有する前に目を通したい場合は、下の プライバシー セクションをご覧ください。

2デバッグモードを解除

ログを取り出す最も簡単な方法は、アプリ内のデバッグ画面を使います — コンピューター不要、ファイルマネージャー不要、Android-data フォルダーの権限も不要。この画面は既定で隠れており、Android の開発者向けオプションと同じ要領で解除します：バージョンブロックを 7 回タップします。

  1. FT8AF で Settings タブを開きます。
  2. 一番下までスクロールします — ABOUT セクション。
  3. FAQ & Support をタップします。About ダイアログが開き、アプリのバージョンと "FT8, made easy." で始まる説明が表示されます。
  4. その説明文を 7 回連続でタップ します。7 回目のタップの後、デバッグモードがオンになり、起動をまたいで保持されます。
  5. About ダイアログを閉じます。ABOUT セクションの FAQ & Support のすぐ下に、新しい Debug 行が現れます。
Settings · AboutDebug unlocked
FT8AFv1.2 · build 2026.06.02
FAQ & Support›
DebugView / share debug.log · ›
解除後 — Debug 行が ABOUT セクションに現れます。デバッグモードがオンになると、再びオフにするまでオンのままです（オフにするには説明をさらに 7 回タップ）。

3Debug を開いて & 共有

新しい Debug 行をタップします。全画面のログビューアーが開き、debug.log の直近の数百行をライブで表示します — 数秒ごとに更新され、自動で一番下までスクロールします。

Debug · 412 linesTailing
Share Clear Logcat: OFF 
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
Debug 画面。 Share をタップすると、debug.log がすでに添付された Android の共有シートが開きます。Gmail、Outlook、Drive、Files — 送りたいものを選んでください。

上部のツールバーから：

Share
debug.log をテキストファイルとして添付した Android の共有シートを開きます（件名は "FT8AF debug.log"）。私たちに直接メールするには Gmail を、あるいは添付を扱える任意のアプリ — Drive、Outlook、Slack、Signal、Telegram、システムの Files アプリ、すべて使えます。
Clear
現在のログを削除します。バグを再現する前にまっさらから始めたいときに便利 — Clear を押し、ダイアログを出て、問題を再現し、戻って共有するだけ。短いログのほうが、私たちが関連イベントを見つけやすくなります。
Logcat: ON / OFF
ON のとき、ビューアーはアプリ自身のプロセスからの直近の logcat 出力も追加します — クラッシュや音声のバグが debug.log に十分捉えられていないときに便利。logcat の末尾は Share をタップしたときに一緒に付いていきます。

私たちに直接送ってください。

共有シートが現れたら、メールアプリを選び、その issue に取り組んでいる人宛てにしてください — オペレーターは K1AF と N0RC です（アドレスは QRZ に）。さらに良いのは：先に GitHub の issue を開き、それからお好みのメールやクラウドドライブのショートカットでログを共有し、リンクや添付を issue のスレッドに貼って公開のままにすることです。

4代替：Files アプリ

何らかの理由でアプリ内の Debug 画面にたどり着けない場合 — 古いビルド、解除がうまくいかない、単にファイルマネージャーを使いたい — ログファイルはディスク上の次の場所にもあります：

/Android/data/com.bg7yoz.ft8cn/files/debug.log
  1. スマホで Files（または My Files）アプリを開きます。
  2. 内部ストレージ → Android → data へ移動します。一部の端末では Android がこのフォルダーを既定で隠します。三点メニューをタップして 隠しファイルを表示 または システムフォルダー を有効にしてください。
  3. com.bg7yoz.ft8cn という名のフォルダーを開き、次に files を開きます。中に debug.log が見えるはずです。
  4. debug.log を長押しして 共有 をタップします。

Android 11+ では Files で /Android/data がブロックされることがあります。

最近の Android で data フォルダーに com.bg7yoz.ft8cn が見えない場合は、Material Files や Solid Explorer のようなサードパーティのファイルマネージャーを Play Store からインストールしてください — どちらもアプリのデータフォルダーを読めます。あるいはもっと簡単に：上のアプリ内 Debug 画面を使えば、これを完全に回避できます。

5代替：ADB

コンピューターと Android の adb ツールを持つ開発者向け：

  1. スマホで 開発者向けオプション → USB デバッグ を有効にします。
  2. スマホを USB でコンピューターに接続し、デバッグ認可のプロンプトを承認します。
  3. ターミナルから、スマホが見えていることを確認します： 
    adb devices -l
  4. ログを取り出します： 
    adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/files/debug.log .
    複数端末の構成では、-s <serial> でスマホを明示的に指定してください。

6issue を書く

役立つバグ報告は小さいものです — 短い段落 3 つか 4 つで十分。いつも効くパターン：

  1. 何をしましたか？ 「FT-891 を差し込み、20m で CQ をタップ。」具体的な操作を順番に。アプリを説明する必要はありません — タップしたものだけで。
  2. 何が起こると思っていましたか？ 「無線機が送信に入り、アプリが 14.074 でトーンを送り始めると思っていました。」
  3. 実際には何が起こりましたか？ 「TX ストリップが LISTENING のままでした。PTT もトーンもなし。」画面に何か現れたら — エラートースト、固まった UI、おかしなウォーターフォール — それを説明してください。スクリーンショットは金の価値があります。
  4. どのくらいの頻度ですか？ 毎回？スマホがスリープした後だけ？6m だけ？絞り込めることは何でも探索範囲を狭めます。
  5. ログを添付してください。 問題を再現した直後に debug.log を取り出します — 最新の行が最も役立ちます。

7issue テンプレート

これを新しい issue にコピーして、空欄を埋めてください：

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

8アプリがクラッシュした場合

FT8AF が完全にクラッシュすると、Android は別のクラッシュレポートを保持します。確認する場所は 2 つ：

  • Google Play から入手した場合は、一度だけ匿名のクラッシュレポートにオプトインすれば、スタックトレースを自動で確認できます。何もする必要はありません — ただ issue に「<時刻> 頃に端末 X からクラッシュレポートを送りました」と添えると、突き合わせに役立ちます。
  • ADB が使えるなら、ライブのシステムログにはたいてい、クラッシュ直後にそのトレースが含まれています： 
    adb logcat -d > logcat.txt
    debug.log に加えて logcat.txt も添付してください。

9プライバシー

デバッグログはただのテキストです。アプリの動作イベントを記録するもので、あなたの個人データではありません。次のような行が見えます：

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

そこに ない もの：Cloudlog や QRZ の API キー、アカウントのパスワード、写真、連絡先、位置情報。あなたのコールサインとグリッドは、局を識別するので あります — とはいえ、それらはどのみち免許を持つアマチュアにとって公開情報です。

送る前に目を通したり伏せ字にしたりしたい場合、ファイルはプレーンな UTF-8 テキストです。どんなテキストエディターでも開けます。

時間を割いてくれてありがとう。

本物のフィールドレポート — 「この無線機、このケーブル、このバンド、こうなった」 — こそが、このフォークを良くする方法です。2 回のバグ退治と 58 件以上の修正は、まさにあなたがこれから提出するような報告から始まりました。73。