برنامج تصحيح الأخطاء

يمكنك تصحيح الأخطاء في مشروعك باستخدام Visual Studio Debugger (LLDB) عند استخدام إضافة تطوير الألعاب لنظام Android

تشغيل برنامج تصحيح الأخطاء

لكي تتمكّن من تشغيل برنامج تصحيح الأخطاء، يجب أن تكون قادرًا على إنشاء ونشر وتشغيل اللعبة على Android. راجِع القسم تشغيل النموذج لمعرفة التفاصيل.

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

يستغرق تشغيل برنامج تصحيح الأخطاء مدة تتراوح بين 10 ثوانٍ ودقيقة واحدة أو أكثر. اعتمادًا على حجم التطبيق وعدد الرموز التي يحتاج إليها ليتم تحميله عند بدء التشغيل. يستغرق الأمر وقتًا أطول عند التوصيل بجهاز جديد هو المرة الأولى التي يضطر فيها برنامج تصحيح الأخطاء إلى تنزيل بعض مكتبات Android من الجهاز إلى الجهاز المضيف. إذا استغرقت أكثر من دقيقة واحدة في أول دقيقة، بضع محاولات باستخدام جهاز جديد، ففكِّر في إلغاء جلسة تصحيح الأخطاء ثم إعادة تشغيله.

عند تشغيل برنامج تصحيح الأخطاء بهذه الطريقة، تبدأ اللعبة خلال مرحلة في انتظار برنامج تصحيح الأخطاء ولن ينفّذ أيًّا من رموز لعبتك حتى اتصال برنامج تصحيح الأخطاء. يتيح لك هذا أيضًا تصحيح أخطاء قسم التهيئة في لعبتك.

يمكنك العثور على مزيد من المعلومات حول ميزات محدّدة في برنامج تصحيح الأخطاء في Visual Studio من خلال قراءة وثائق Visual Studio.

إرفاق العملية

إذا كنت تريد تصحيح أخطاء لعبة قيد التشغيل حاليًا على جهاز مادي أو افتراضي يمكنك إرفاق برنامج تصحيح الأخطاء بالعملية من Visual Studio.

في Visual Studio، تأكَّد من فتح حل Android و:

1. انتقِل إلى قائمة تصحيح الأخطاء واختَر إرفاق بالمعالجة....
2. من القائمة المنسدلة النقل، اختَر إضافة تطوير ألعاب Android.
3. من القائمة المنسدلة المؤهل، اختَر جهاز Android.
4. حدد عملية اللعبة من قائمة العمليات المتاحة انقر على إرفاق.

تنفيذ أوامر LLDB.Shell

بعد تفعيل جلسة تصحيح الأخطاء، استخدِم نافذة الأوامر في Visual Studio أوامر LLDB.Shell.

تنسيق الأمر:

LLDB.Shell [command]

مثال:

>LLDB.Shell expr myIntVariable = 9
Status:  Success
Output Message:
(int) $2 = 9

تصور البيانات

محددات التنسيق

يمكنك تغيير التنسيق الذي يتم فيه عرض القيمة في السيارات، نوافذ Locals وWatch ومتغيرة DataTip باستخدام محددات التنسيقات.

يمكن العثور على محددات التنسيق في نهاية التعبيرات. تبدأ بفاصلة متبوعة بسلسلة قصيرة. على سبيل المثال، محدّد ,x في _myInt,x تعبيرًا على تنسيق myInt كقيمة سداسية عشرية صغيرة.

يمكن استخدام محددات التنسيق مباشرةً في نافذة مشاهدة أو في نوافذ Autos وLocals وDataTip من خلال إضافتها إلى Natvis والتعبيرات. يمكنك الاطّلاع على Natvis للحصول على مزيد من المعلومات.

قائمة محددات الدعم

ناتفيس

يتيح لك إطار عمل Natvis تخصيص طريقة عرض Visual Studio الأنواع الأصلية في نوافذ متغير برنامج تصحيح الأخطاء. على سبيل المثال، استخدم Natvis تخصيص الشاشات لنوافذ المشاهدة والأماكن المحلية ونصائح حول البيانات.

ميزة Natvis مفعَّلة تلقائيًا ولكن يمكن إيقافها من Visual Studio عن طريق ضبط الأدوات > الخيارات > إضافة تطوير ألعاب Android > ناتفيس قُم بـ غير مفعَّل.

تحميل ملفات Natvis

تحمِّل Visual Studio ملفات Natvis من المواقع الثلاثة المدرجة أدناه يعيد تحميلها في كل مرة تبدأ فيها جلسة تصحيح الأخطاء. يجب أن تتقيّد الملفات مخطط Visual Studio 2017 Natvis.

• .natvis ملفات التي تشكل جزءًا من مشروع تم تحميله أو عنصر حل من المستوى الأعلى.
• الدليل الخاص بالمستخدم (%USERPROFILE%\Documents\Visual Studio 2017\Visualizers)
• الدليل على مستوى النظام (%VSINSTALLDIR%\Common7\Packages\Debugger\Visualizers)

إعادة تحميل ملفات Natvis

يمكنك إعادة تحميل ملفات Natvis خلال جلسة تصحيح الأخطاء من خلال تقييم .natvisreload في نافذة الأوامر أو نافذة المشاهدة

نموذج ملف Natvis

يتضمن نموذج ملف Natvis هذا جميع العلامات والسمات المتوفرة حاليًا

<?xml version="1.0" encoding="utf-8"?>
<AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">

  <Type Name="demo::Vector&lt;*&gt;">
    <AlternativeType Name="MySimilarVectorType&lt;*&gt;"/>

    <!-- Included to show the <SmartPointer> feature is supported. -->
    <SmartPointer Optional="true" Usage="Minimal">ptr</SmartPointer>

    <!-- Included to show the <DisplayString> feature is supported. -->
    <DisplayString Condition="_size == 0" Optional="true">()</DisplayString>
    <DisplayString Condition="_size == 1">(x={_items[0]})</DisplayString>
    <DisplayString Condition="_size == 2">(x={_items[0]}, y={_items[1]})</DisplayString>
    <DisplayString Condition="_size == 3">(x={_items[0]}, y={_items[1]}, z={_items[2]})</DisplayString>
    <DisplayString>[Size={_size,x}] (x={_items[0]}, y={_items[1]}, z={_items[2]}, ...)</DisplayString>

    <!-- Included to show the <StringView> feature is supported. -->
    <StringView Condition="true" Optional="true">_stringViewText</StringView>

    <Expand HideRawView="false">
      <!-- Included to show the <Item> feature is supported. -->
      <Item Name="X" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 1" Optional="true">_items[0]</Item>
      <Item Name="Y" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 2" Optional="true">_items[1]</Item>
      <Item Name="Z" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 3" Optional="true">_items[2]</Item>

      <!-- Included to show the <ArrayItems> feature is supported. -->
      <ArrayItems Condition="_size >= 4" Optional="true">
        <Size Condition="true" Optional="true">_size</Size>
        <ValuePointer Condition="true">_items</ValuePointer>
      </ArrayItems>

      <!-- Included to show the <IndexListItems> feature is supported. -->
      <IndexListItems Condition="true" Optional="true">
        <Size Condition="true" Optional="true">_listSize</Size>
        <ValueNode Condition="true">_list[%i]</ValueNode>
      </IndexListItems>

      <!-- Included to show the <LinkedListItems> feature is supported. -->
      <LinkedListItems Condition="true" Optional="true">
        <Size Optional="true">_listSize</Size>
        <HeadPointer>_head</HeadPointer>
        <NextPointer>_next</NextPointer>
        <ValueNode>_value</ValueNode>
      </LinkedListItems>

      <!-- Included to show the <ExpandedItem> feature is supported. -->
      <ExpandedItem Condition="true" Optional="true">_childVar</ExpandedItem>

      <!-- Included to show the <Synthetic> feature is supported. -->
      <Synthetic Name="[Size]" Condition="true" Optional="true">
        <DisplayString>_size</DisplayString>
        <Expand HideRawView="true">
          <!-- Any supported <Expand> sub-tags. -->
        </Expand>
      </Synthetic>

      <!-- Included to show the <TreeItems> feature is supported. -->
      <TreeItems Condition="true" Optional="true">
        <Size>_treeSize</Size>
        <HeadPointer>_head</HeadPointer>
        <LeftPointer>_left</LeftPointer>
        <RightPointer>_right</RightPointer>
        <ValueNode>_value</ValueNode>
      </TreeItems>

      <!-- Included to show format specifiers are supported. -->
      <Item Name="[Hex Dump at {_index,x}]">myInt[_index],x</Item>
    </Expand>
  </Type>
</AutoVisualizer>

تأليف ملفات Natvis

تتيح لك Visual Studio تأليف ملفات Natvis. لمزيد من المعلومات عن تخصيص نوافذ متغير برنامج تصحيح الأخطاء، يُرجى مراجعة MSDN:

تصحيح أخطاء ملفات Natvis

في بعض الحالات، ستظهر الأخطاء على أنّها قيمة متغيّر (على سبيل المثال، في نوافذ Auto ومشاهدة وما إلى ذلك). مثلاً: <error: use of undeclared identifier 'missingVar'>

يمكنك الوصول إلى مزيد من التفاصيل حول الخطأ من خلال فتح GoogleAndroid.log. من شريط أدوات إضافة تطوير ألعاب Android.

القيود المعروفة

• إذا لم تكن علامتك أو السمة مُدرَجة في نموذج الملف أعلاه، المدعومة حاليًا. تتجاهل Visual Studio العلامات والسمات غير المتوافقة، يمكنك تركها في ملف Natvis الحالي وسيظل الملف صالحًا، طالما فإنها تستخدم مخططنا.

• إنّ السمة Usage غير متوافقة مع المخطّط، على الرغم من أنّ المخطط يطلبها. <SmartPointer> ومع ذلك، لا يقيّد LLDB الوصول إلى عوامل التشغيل في C++، بحيث يمكن تحديد أي عامل تشغيل مطلوب في C++ بدلاً من ذلك.