أعطنا السجل،
وسنتمكّن من إصلاحه.

1ماذا في السجل

يحتفظ FT8AF بملف نصي متجدّد اسمه debug.log في دليل بيانات تطبيقه. يلتقط أشياء مثل:

• أحداث توصيل / فصل USB وأيّ جهاز CAT تطابق
• محاولات الاتصال التلقائي وأي إخفاقات
• إطارات CAT التسلسلية المرسَلة إلى الجهاز والمستلَمة منه
• تغييرات النطاق والتردد
• أحداث دورة الحياة عند بدء التطبيق وإيقافه

إنه نص عادي، آمن للقراءة، ولا يتضمّن كلمات مرور أو مفاتيح API للرفع. راجع قسم الخصوصية أدناه إن أردت تصفّحه قبل مشاركته.

2افتح قفل وضع التصحيح

أسهل طريقة لسحب السجل تستخدم شاشة تصحيح داخل التطبيق — بلا حاسوب، وبلا مدير ملفات، وبلا أذونات مجلد Android-data. الشاشة مخفية افتراضيًا، وتفتح قفلها مثل خيارات مطوّري أندرويد: انقر كتلة الإصدار سبع مرات.

1. افتح علامة التبويب Settings في FT8AF.
2. مرّر إلى الأسفل تمامًا — قسم ABOUT.
3. انقر FAQ & Support. يُفتح مربع About، عارضًا إصدار التطبيق ووصفًا يبدأ بـ "FT8, made easy."
4. انقر نص الوصف ذاك سبع مرات متتالية. بعد النقرة السابعة، يُشغَّل وضع التصحيح ويستمرّ عبر عمليات التشغيل.
5. أغلق مربع About. يظهر الآن صف Debug جديد في قسم ABOUT، أسفل FAQ & Support مباشرةً.

3افتح Debug & شارك

انقر صف Debug الجديد. يُفتح عارض سجل بملء الشاشة، يتتبّع آخر بضع مئات من سطور debug.log مباشرةً — يتحدّث كل بضع ثوانٍ ويمرّر تلقائيًا إلى الأسفل.

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

من شريط الأدوات العلوي:

Share

يفتح ورقة مشاركة أندرويد مع debug.log مرفقًا كملف نصي (سطر الموضوع "FT8AF debug.log"). اختر Gmail لإرساله إلينا مباشرةً بالبريد، أو أي تطبيق يتعامل مع المرفقات — Drive وOutlook وSlack وSignal وTelegram وتطبيق Files في النظام، كلها تعمل.

Clear

يحذف السجل الحالي. مفيد إن أردت البدء من نظافة قبل إعادة إنتاج خلل — اضغط Clear فحسب، واخرج من المربع، وأعِد إنتاج المشكلة، وعُد ثم شارك. السجل الأقصر يسهّل علينا رصد الأحداث ذات الصلة.

Logcat: ON / OFF

حين يكون ON، يلحق العارض أيضًا مخرجات logcat الأخيرة من عملية التطبيق نفسها — مفيد حين لا يُلتقط عطل أو خلل صوتي بالكامل في debug.log. ينطلق ذيل logcat معك حين تنقر Share.

4بديل: تطبيق Files

إن تعذّر عليك لسبب ما الوصول إلى شاشة Debug داخل التطبيق — بناء قديم، أو لم ينجح فتح القفل، أو تفضّل ببساطة مدير الملفات — فإن ملف السجل يعيش أيضًا على القرص في:

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

1. افتح تطبيق Files (أو ملفاتي) على هاتفك.
2. انتقل إلى التخزين الداخلي → Android → data. على بعض الأجهزة يخفي أندرويد هذا المجلد افتراضيًا؛ انقر قائمة النقاط الثلاث وفعّل إظهار الملفات المخفية أو مجلدات النظام.
3. افتح المجلد المسمّى com.bg7yoz.ft8cn، ثم files. ينبغي أن ترى debug.log بداخله.
4. اضغط مطوّلًا على debug.log وانقر مشاركة.

5بديل: ADB

للمطوّرين الذين لديهم حاسوب وأداة adb الخاصة بأندرويد:

1. على هاتفك، فعّل خيارات المطوّرين → تصحيح أخطاء USB.
2. وصّل الهاتف بالحاسوب عبر USB، واقبل مطالبة تفويض التصحيح.
3. من طرفية، تأكّد من أن الهاتف مرئي:

   adb devices -l

4. اسحب السجل:

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

   في الإعدادات متعددة الأجهزة، استهدف الهاتف صراحةً بـ -s <serial>.

6اكتب المشكلة

تقرير الخلل المفيد صغير — ثلاث أو أربع فقرات قصيرة تكفي. النمط الذي ينجح دائمًا:

1. ماذا فعلت؟ «وصّلت جهازي FT-891، ونقرت CQ على 20m.» أفعال محدّدة بالترتيب. لا حاجة لوصف التطبيق — فقط ما نقرته.
2. ماذا توقّعت أن يحدث؟ «توقّعت أن يدخل الجهاز في الإرسال وأن يبدأ التطبيق بإرسال نغمات على 14.074.»
3. ماذا حدث فعلًا؟ «بقي شريط TX على LISTENING. لا PTT ولا نغمات.» إن ظهر شيء على الشاشة — رسالة خطأ، أو واجهة متجمّدة، أو شلّال غريب — صِفه. لقطة الشاشة تساوي ذهبًا.
4. بأيّ تكرار؟ في كل مرة؟ فقط بعد أن ينام الهاتف؟ فقط على 6m؟ كل ما يمكنك تحديده يضيّق البحث.
5. أرفِق السجل. اسحب debug.log مباشرةً بعد إعادة إنتاج المشكلة — أحدث السطور أنفعها.

7قالب المشكلة

انسخ هذا في مشكلة جديدة واملأ الفراغات:

## 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 تمامًا، يحتفظ أندرويد بتقرير تعطّل منفصل. موضعان للنظر فيهما:

• إن حصلت عليه من Google Play، فوافِق مرة واحدة على إبلاغ التعطّل المجهول، وسنرى تتبّع المكدّس تلقائيًا. لا حاجة لأن تفعل شيئًا — لكن إضافة «أرسلت للتوّ تقرير تعطّل من الجهاز X نحو <الوقت>» إلى المشكلة تساعدنا على مطابقته.
• إن كان لديك ADB، فإن سجل النظام المباشر يحتوي عادةً تتبّع التعطّل مباشرةً بعد حدوثه:

  adb logcat -d > logcat.txt

  أرفِق logcat.txt إضافةً إلى debug.log.

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

ما ليس فيه: مفاتيح API الخاصة بـ Cloudlog أو QRZ، أو كلمات مرور حساباتك، أو الصور، أو جهات الاتصال، أو الموقع. أما إشارة ندائك ومربع شبكتك فهما موجودان، لأنهما يعرّفان محطتك — لكنهما على أي حال معلومتان عامتان للهواة المرخّصين.

إن أردت تصفّحه أو إخفاء أجزاء منه قبل الإرسال، فالملف نص عادي بترميز UTF-8. أيّ محرّر نصوص سيفتحه.