المقدمة
نظرة عامة
عند حدوث مشكلة أثناء الاختبار الداخلي أو نشر هواتف IP التي تعمل بنظام أندرويد لدى العملاء، قد يحتاج فريق الدعم الفني إلى تقديم معلومات تصليح الأخطاء لاستكشاف المشكلات وتحليلها. يوضح هذا الدليل كيفية جمع ملفات التشخيص المطلوبة.
الموديلات المدعومة
GP32i, BX7A, BF600S, BJ7A, Bi56A
المتطلبات الأساسية
1. قم بتحضير هاتف IP يعمل بنظام أندرويد، ومحرق أقراص USB، ومبدل PoE أو مصدر طاقة تيار مستمر. قم بتوصيل الهاتف بالمبدل.
2. قم بتحضير جهاز كمبيوتر للتصليح، وقم بتوصيله بنفس المبدل. تأكد من أن الكمبيوتر والهاتف يمكنهما التواصل مع بعضهما البعض عبر الشبكة.
مخطط توصيل الجهاز والكمبيوتر
قم بتوصيل هاتف IP الذي يعمل بنظام أندرويد (نستخدم الموديل A32i كمثال هنا) بالمبدل، وقم بتوصيل الكمبيوتر بنفس المبدل. تأكد من أن الشبكة بين الكمبيوتر والجهاز قابلة للوصول. يُوضح مثيل التوصيل في الشكل 1.
الشكل 1. مخطط توصيل الجهاز والكمبيوتر
طرق استكشاف الأخطاء وإصلاحها
بناءً على نوع المشكلة، قد تكون هناك حاجة إلى أنواع مختلفة من معلومات التشخيص للتحليل. توضح الأقسام التالية الملفات التي يجب تقديمها في ظروف مختلفة.
الحالات العامة
في معظم الحالات، يجب جمع ثلاثة ملفات وتقديمها لفريق البحث والتطوير:
1. ملف سجل تصليح الأخطاء النظامي (Debug Syslog)
سجل الدخول إلى واجهة الويب للهاتف وانتقل إلى النظام > صفحة الدعم، ثم ابحث عن سجل النظام.
قم بتكوين الإعدادات التالية:
1) قم بتمكين سجل النظام
2) قم بتعيين عنوان الخادم على عنوان IP للكمبيوتر المحلي
3) قم بتعيين منفذ الخادم على 514
4) قم بتعيين مستوى سجل النظام على تصليح الأخطاء
5) قم بتمكين تصدير السجل
6) بعد إعادة إنتاج المشكلة، انقر على تصدير السجل لتحميل ملف سجل النظام
الشكل 2. تصدير سجل تصليح الأخطاء النظامي
2. حزمة تصليح الأخطاء
تحتوي حزمة تصليح الأخطاء على السجلات المخزنة مؤقتًا والمعلومات التشغيلية وتفاصيل البرامج الثابتة وغيرها من بيانات التشخيص الداخلية للهاتف. يمكن تصديرها من واجهة الويب.
انتقل إلى النظام > أداة الدعم، وابحث عن خيار تصدير معلومات تصليح الأخطاء بنقرة واحدة، ثم انقر على تصدير. قد تستغرق هذه العملية حوالي دقيقة واحدة لإكمالها.
الشكل 3. تصدير حزمة تصليح الأخطاء
3. ملف التقاط حزم الشبكة
يسجل ملف التقاط الحزم حزم الشبكة المرسلة والمستلمة، ويمكن استخدامه للتحليل في أدوات مثل Wireshark.
لالتقاط حركة مرور الشبكة:
1) انقر على ابدأ وانتظر حتى تبدأ صفحة الويب عملية التقاط
2) أعد إنتاج المشكلة
3) بعد إعادة إنتاج المشكلة، انقر على إيقاف
4) افتح صفحة تنزيل المتصفح لتحديد ملف حزم الشبكة الملتقطة
الشكل 4. التقاط حزم الشبكة
الحالات الخاصة
بعد تقديم الملفات الثلاثة المذكورة أعلاه، قد تظل هناك حاجة إلى معلومات إضافية في بعض المواقف.
عند طلب فريق البحث والتطوير
بعد مراجعة سجل تصليح الأخطاء النظامي وحزمة تصليح الأخطاء وملف التقاط الحزم، قد يطلب فريق البحث والتطوير سجلات أندرويد في الوقت الفعلي لدعم التحليل الأعمق. يوضح القسم التالي كيفية جمع سجلات أندرويد في الوقت الفعلي باستخدام أداة ADB.
سجل أندرويد في الوقت الفعلي
يصدر نظام أندرويد باستمرار سجلات التشغيل أثناء عمل الهاتف. يمكن لهذه السجلات مساعدة المهندسين في تحديد المشكلات وتحليلها.
1. تثبيت أداة ADB على الكمبيوتر
يمكنك تنزيل أداة ADB المناسبة لنظام التشغيل الخاص بك من الرابط:
https://developer.android.google.cn/studio/releases/platform-tools
بعد التثبيت، أضف مسار تثبيت ADB إلى متغيرات بيئة النظام. في نظام ويندوز، انتقل إلى هذا الكمبيوتر > الخصائص > إعدادات النظام المتقدمة > متقدم > متغيرات البيئة، ثم أضف المسار المطلق لدليل ADB إلى متغير Path.
الشكل 5. إضافة مسار ADB
افتح نافذة موجه الأوامر على الكمبيوتر وادخل الأمر adb. إذا تم تشغيل الأمر بنجاح، فهذا يعني أن ADB قد تم تثبيته بشكل صحيح.
الشكل 6. نجاح تثبيت ADB
2. تمكين تصليح الأخطاء عبر USB على الهاتف
بالنسبة لبرامج أندرويد الثابتة الصادرة بعد 1 ديسمبر 2020، يتم تعطيل تصليح الأخطاء عبر ADB افتراضيًا ويجب تمكينه يدويًا.
أدخل محرق أقراص USB في الهاتف، ثم انتقل إلى الإعدادات > حول الجهاز وانقر على رقم إصدار البرنامج الثابت خمس مرات لتمكين وضع المطور.
الشكل 7. تمكين وضع المطور
ثم انتقل إلى الإعدادات > النظام > خيارات المطور وقم بتشغيل تصليح الأخطاء عبر USB.
الشكل 8. تمكين تصليح الأخطاء عبر USB
3. تغيير مستوى سجل تصليح الأخطاء
عادةً ما يتم تعيين مستوى سجل الهاتف الافتراضي على إشعار، والذي يسجل فقط المعلومات الأساسية. لالتقاط سجلات أكثر تفصيلاً، قم بتغيير مستوى السجل إلى تتبع.
انتقل إلى إعدادات الهاتف > صيانة النظام > الأدوات، وقم بتعيين مستوى السجل على تتبع.
الشكل 9. تغيير مستوى السجل
4. التقاط السجلات في الوقت الفعلي
استخدم أوامر ADB التالية:
adb connect 172.18.8.28
استبدل 172.18.8.28 بعنوان IP الفعلي للهاتف. يقوم هذا الأمر بالاتصال بالهاتف عبر الشبكة.
adb devices
يقوم هذا الأمر بسرد الأجهزة المتصلة ويتيح لك التحقق مما إذا كان الهاتف متصلاً بنجاح.
adb logcat -G 16M
يقوم هذا الأمر بزيادة حجم مخزن السجل حتى يمكن تخزين المزيد من محتوى السجل.
adb logcat > logcat-202111051708.log
يقوم هذا الأمر بحفظ إخراج السجل في الوقت الفعلي في ملف على الكمبيوتر. تنسيق التسمية الموصى به هو: سنة + شهر + يوم + ساعة + دقيقة + ثانية + .log
الشكل 10. التقاط السجلات في الوقت الفعلي
بعد الانتهاء من تسجيل السجلات، قم بتشغيل الأمر:
adb disconnect 172.18.8.28
يقوم هذا الأمر بفصل الكمبيوتر عن الهاتف. يمكنك بعد ذلك العثور على ملف السجل في الوقت الفعلي الذي تم إنشاؤه في الدليل المقابل على جهاز الكمبيوتر الخاص بك.
الشكل 11. مسار ملف السجل في الوقت الفعلي
المشكلات المتعلقة بالشاشة
إذا كانت المشكلة متعلقة بشاشة العرض LCD أو سلوك العرض، فيجب تقديم ملف لقطة شاشة أيضًا.
سجل الدخول إلى واجهة الويب للهاتف وانتقل إلى النظام > صفحة الدعم، ثم ابحث عن لقطة شاشة. انقر على حفظ الصورة لتحميل لقطة الشاشة وحفظها.
الشكل 12. حفظ لقطة شاشة
