تعمل أداة سطح المكتب "وحدة التحكم" على التقاط ناتج وحدة التحكم، تمامًا كما هو الأمر حاليًا في Qt Creator من تطبيق AppStudio باستخدام أداة تعمل على سطح مكتب. كما هو الأمر في حدة تحكم Qt Creator، يمكنك استخدام أداة وحدة التحكم مع تطبيق يعمل على نفس الجهاز، إلا أنها يمكن أن تتلقى الناتج من جهاز آخر على نفس الشبكة. ويُعد ذلك مثاليًا لالتقاط ناتج وحدة التحكم من جهاز iOS أو Android، وعرضه على سطح المكتب.
عند تشغيل تطبيق AppStudio على جهاز Android وتعطل التطبيق، يمكنك استرداد ملفات سجل النظام التي تم إنشاؤها لإجراء التشخيصات واستكشاف الأخطاء وإصلاحها. هذا يتطلب استخدام أدوات Android SDK. لمزيد من المعلومات، راجع مقالة قاعدة المعارف كيفية تصدير سجل الأعطال (logcat) من جهاز Android.
تمكين أداة "وحدة التحكم"
عند بدء تشغيل ArcGIS AppStudio الإصدار 1.2 أو إصدار لاحق، سترى زر وحدة التحكم في شريط الأدوات أعلى التطبيق. هذا يفتح أداة وحدة التحكم.
ملاحظة:
لا حاجة إلى تسجيل الدخول للوصول إلى هذه الأداة.
إضافةً إلى تفاصيل الكمبيوتر المُضيف، تظهر هذه الصفحة فارغةً في بادئ الأمر نظرًا للحاجة إلى توجيه التطبيق إلى وحدة تحكم قبل إخراج المعلومات إليها. ولا يمكن القيام بذلك في تطبيق AppStudio إلا بتمكين تسجيل الدخول.
تمكين تسجيل الدخول في AppStudio Player
في التطبيقات قيد التطوير أو التطبيقات المؤسسية، يوجد لدى AppStudio Player توافُق مدمج مع وحدة التحكم. لتمكين تسجيل الدخول في المشغل, افتح القائمة الجانبية واضغط على خيار الاتصال بوحدة التحكم عن بُعد. بعد ذلك يجب عليك الاختيار من بين ثلاث طرق مختلفة للاتصال بجهازك.
- مسح رمز الاستجابة السريعة QR يُعد عمليًا عند تشغيل التطبيقات في AppStudio Player على أجهزة الجوال. قبل مسح الكود، حدد عنوان IP في أداة وحدة التحكم. ونظرًا لأنه قد يحتوي النظام الذي يُشغل وحدة تحكم AppStudio على أكثر من عنوان IP مُعيّن له، سيتم إنشاء رمز الاستجابة السريعة QR للعنوان المحدد من القائمة المنسدلة، وسيظهر بجانبه. عند النقر على كود QR، يتم عرض إصدار أكبر، وهو ما يُعد مفيدًا إذا تعذّر على الجهاز مسح الكود الأصغر. امسح كود QR المنشأ ضوئيًا بأي حجم لإكمال الاتصال.
- يتيح لك الاتصال عبر الشبكة اختيار وحدة تحكم AppStudio تعمل في الوقت الحالي لإكمال الاتصال.
- إدخال عنوان IP يعمل على فتح صفحة جديدة حيث يمكنك إدخال عنوان IP والمنفذ يدويًا، مثل syslog://10.112.25.174:514. حدد التالي للاتصال بوحدة التحكم.
باستخدام كل هذه الوسائل، ترسل كل الإجراءات التي تنفذها في AppStudio Player رسائل إلى وحدة التحكم في سطح المكتب المحدد.
تسجيل الرسائل بوحدة التحكم
بمجرد اتصال AppStudio Player بأداة وحدة التحكم، سيتم تعبئة حقل مواقع ناتج السجل بتفاصيل الجهاز المتصل تلقائيًا.
ستبدأ وحدة التحكم الموجودة على سطح المكتب المحدد في عرض المعلومات التشخيصية على الفور من كل من AppStudio Player والتطبيق الذي يعمل فيه. يتم تمييز الرسائل من المشغل والتطبيق في عمود التطبيق. ستتلقى وحدة التحكم المعلومات حتى يتم تعطيل تسجيل الدخول إلى AppStudio Player أو النقر على توقف في وحدة التحكم.
تسجيل الدخول إلى وحدات التحكم الأخرى على الإنترنت
تستخدم أداة "وحدة التحكم" بروتوكول syslog وهو وسيلة متوافقة ومدعومة على نطاق واسع لتسجيل المعلومات ضمن شبكة أو على الإنترنت. وهو ما يعني أنه يمكنك استخدام إمكانات تسجيل الدخول لـ AppStudio Player والتطبيقات التي تدعم وحدة التحكم لإرسال الرسائل إلى وحدات تحكم syslog الأخرى، مثل Loggly.
ولتنفيذ ذلك، أدخل عنوان URL أو IP لموقع syslog إلى المربع النصي ناتج التسجيل. قد تريد أيضًا إدخال بيانات معرف المستخدم. أدخل ذلك في المربع النصي بيانات المستخدم. لمعرفة المزيد عن معلومات معرف المستخدم وLoggly، راجع وثائق Loggly.
احفظ رسائل وحدة التحكم المسجلة في ملف
يمكن أيضًا لأداة "وحدة التحكم" تصدير الرسائل المستقبلة في ملف السجل يمكن الرجوع إليه لاحقًا أو إرساله إلى الآخرين. لتنفيذ ذلك، انقر على زر حفظ في وحدة التحكم إما أثناء التسجيل أو بعده. يظهر مربع حوار لاختيار اسم ووجهة الملف، وتحفظ النتائج كملف .log.
أضف توافق وحدة تحكم إلى التطبيق
يمكنك إضافة إمكانية إنتاج رسائل وحدة التحكم إلى التطبيق. وعلى الأقل، سيتيح لتطبيقك سطر الكود التالي إخراج رسائل وحدة التحكم إلى ملف سجل خارجي في الموقع الافتراضي على الجهاز:
AppFramework.logging.enabled = true;
ملاحظة:
لضمان إمكانية إنشاء هذا الملف عند تشغيل التطبيق على جهاز Android، في الإعدادات، في علامة تبويب إمكانات قم بالتأكيد على تحديد تخزين خارجي.
لمزيد من الأمثلة التفصيلية عن كيفية تنفيذ التسجيل، راجع قالب AppStudio Player المؤسسي الذي يوفره AppStudio.