البدء السريع لأداة فحص وحدة معالجة الرسومات من Android

يصف هذا الموضوع كيفية إجراء تحديد مواصفات النظام و تحديد مواصفات إطار العمل على تطبيق Android باستخدام أداة Android GPU Inspector (AGI).

تم تصميم دليل البدء السريع هذا للمطوّرين الذين هم على دراية بتطوير الرسومات على نظام التشغيل Android.

متطلبات الكمبيوتر

يجب أن يستوفي الكمبيوتر الذي يُشغِّل AGI المتطلبات التالية:

يجب توفُّر أحد أنظمة التشغيل التالية:
- نظام التشغيل Windows: إصدار Windows 7 أو إصدار أحدث
- نظام التشغيل macOS: إصدار El Capitan (10.11) أو الإصدارات الأحدث منه.
- نظام التشغيل Linux: يلزم توفّر Java 64 بت JDK أو JRE 8 (أو إصدار أحدث)، وننصحك باستخدام Ubuntu Trusty Tahr (14.04 أو إصدار أحدث).
أداة سطر أوامر adb.

تنزيل أداة AGI وتثبيتها

يمكنك تنزيل أداة AGI وتثبيتها لنظام التشغيل الذي تستخدمه.

متطلبات تطبيق Android

يصف هذا القسم متطلبات تطبيق Android الذي يتم تحليله:

يجب أن يكون تطبيق Android قابلاً للتصحيح، ويجب ضبط السمة "تصحيح الأخطاء" في ملف بيان التطبيق على نظام التشغيل Android على true. تتيح هذه السمة الأدوات المناسبة من برنامج تشغيل الرسومات. بالنسبة إلى تطبيقات Vulkan، تمكّن هذه السمة AGI من إضافة طبقة Vulkan الخاصة بها عند بدء تشغيل التطبيق.
```
<application [...] android:debuggable="true">
```

إذا كان تطبيقك يستخدم Vulkan في الأصل، ستتطلّب AGI أيضًا ما يلي:

يجب تفعيل طبقات التحقق من Vulkan في تطبيقك. إذا لم يتم تفعيلهما، يمكنك تشغيل الأوامر التالية لفرض تشغيل تطبيقك باستخدام طبقات التحقق المضمّنة في ملف AGI AP (com.google.android.gapid.<abi>):

app_package=<YOUR APP PACKAGE NAME HERE>
abi=arm64v8a # Possible values: arm64v8a, armeabi-v7a, x86

adb shell settings put global enable_gpu_debug_layers 1
adb shell settings put global gpu_debug_app ${app_package}
adb shell settings put global gpu_debug_layer_app com.google.android.gapid.${abi}
adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation

عند الانتهاء من التحليل، يمكنك إيقاف طبقات التحقق هذه باستخدام الأوامر التالية:

adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app

يجب ألا يبلغ تطبيقك عن أي تحذيرات أو أخطاء عند تشغيله مع تفعيل طبقات التحقق من Vulkan. أصلِح أي خطأ في عملية التحقّق من Vulkan قبل إنشاء الملفات التعريفية.
إذا كنت تستخدم برامج تشغيل تجريبية لوحدة معالجة الرسومات، عليك تضمين البيانات الوصفية التالية في علامة <application> في بيان Android:
```
<meta-data
          android:name="com.android.graphics.developerdriver.enable"
          android:value="true" />
```

متطلبات جهاز Android

تفرض AGI متطلبات أجهزة Android التالية:

جهاز Android متوافق يعمل بنظام التشغيل الإصدار 11 من نظام التشغيل Android أو إصدار أحدث
كابل USB.
يجب تفعيل تصحيح أخطاء adb وإتاحة الوصول إلى الجهاز من خلال adb. فعِّل الخيار تثبيت عبر USB.

التحقّق من الجهاز

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

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

تتم عملية التحقق من الصحة مرة واحدة للجهاز، ويتم تخزين النتائج مؤقتًا لاستخدامها في المستقبل لـ AGI. ومع ذلك، سيجري AGI عملية التحقق مرة أخرى في حال تغيّر إعداد الجهاز، على سبيل المثال إذا تم تحديث برنامج تشغيل وحدة معالجة الرسومات أو إصدار Android.

وإذا كان الجهاز مُدرجًا على أنّه جهاز متوافق، يمكنك أن تتوقّع أن تجتاز ميزة AGI عملية التحقق. وإذا لم يكن الجهاز مدرجًا، فمن المرجح أن يكون برنامج تشغيل وحدة معالجة الرسومات الخاص به غير متوافق مع AGI.

إذا كان جهازك متوافقًا ولكن تعذّر التحقق منه

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

في حال استيفاء جميع المتطلبات، يمكنك الإبلاغ عن مشكلة في مستودع GitHub الذي يصف السلوك.

إذا لم يكن جهازك متوافقًا

نعمل مع شركائنا من المصنّعين الأصليين للأجهزة لإتاحة عمل المزيد من الأجهزة. يمكنك الإبلاغ عن مشكلة في مستودع جيت هب لطلب الدعم لأحد الأجهزة.

تسجيل بيانات التحليل

توضّح الأقسام التالية كيفية الحصول على بيانات إنشاء الملفات التعريفية، وفتح ملف التتبّع الناتج حتى تتمكّن من تحليل النتائج.

ضبط إعدادات Android

قبل بدء إنشاء الملفات التعريفية، يجب ضبط إعدادات الجهاز والتطبيقات المتوافقة على Android، والتي تحدد التطبيق والجهاز الملف الشخصي.

باستخدام كابل USB، وصِّل جهاز Android بجهاز الكمبيوتر.
شغِّل AGI على جهاز الكمبيوتر.

في المرة الأولى التي تُشغِّل فيها أداة AGI، ستعرِض شاشة الترحيب التي تطلب منك الانتقال إلى مسار ملف Adb التنفيذي. تحفظ AGI هذه الإعدادات في ملف .agic في مجلد HOME. إذا كنت قد قمت بذلك بالفعل، فيمكنك تخطي هذه الخطوة.

الشكل 1: شاشة الترحيب.
أدخِل المسار إلى ملف adb التنفيذي في الحقل Path to adb. إن مربعات الاختيار التي تلي هذا الحقل اختيارية.
انقر على البدء لعرض شاشة الإطلاق.

الشكل 2: شاشة التشغيل الرئيسية لأداة فحص وحدة معالجة الرسومات Android GPU.
في شاشة الإطلاق، انقر على التقاط بيانات تتبُّع جديدة. ويؤدي ذلك إلى عرض مربّع الحوار التقاط بيانات تتبُّع جديدة. وبدلاً من ذلك، يمكنك النقر على الزر التقاط بيانات تتبُّع الملف الشخصي للنظام.

الشكل 3: مربّع حوار التقاط تتبُّع جديد.
في قسم الجهاز والنوع، اختَر جهاز Android الذي تريد تحديد ملف شخصي له. إذا لم يكن يظهر في قائمة الجهاز، انقر على سهم إعادة التحميل لتحديث القائمة.
في قسم التطبيق، اختَر التطبيق الذي تريد إنشاء ملف شخصي له. إذا كان هناك نشاط واحد فقط في الحزمة، فيمكنك تحديد الحزمة بدلاً من النشاط.

يتضمن AGI نموذجًا من تطبيق Vulkan. لاستخدام نموذج التطبيق بدلاً من تطبيقك الخاص، نفِّذ الخطوات التالية:
1. انقر على الزر ... بجانب الحقل التطبيق.
  
  يؤدي ذلك إلى عرض مربّع الحوار اختيار تطبيق لتتبُّعه الذي يعرض قائمة بالتطبيقات التي يمكن تتبُّعها على الجهاز المحدّد.
2. في مربع النص Filter، اكتب gapid لعرض التطبيقات التي تحتوي على gapid فقط في اسم الحزمة.
3. وسِّع الحزمة واختَر com.google.android.gapid.VkSampleActivity، ثم انقر على OK (حسنًا).
  
  يعيدك ذلك إلى مربع الحوار Capture A New Trace (التقاط بيانات تتبُّع جديدة)، مع ملء حقل التطبيق بالتطبيق الذي اخترته.
في قسم Application (التطبيق)، اترك الحقول الأخرى فارغة.
انقر على حسنًا.

أصبحت الآن جاهزًا لاستخدام AGI في تحديد مواصفات النظام والإطار.

إنشاء ملف شخصي للنظام

لوضع ملف شخصي للنظام، يمكنك تنفيذ الخطوات التالية:

في شاشة إطلاق AGI، انقر على Cpture a new track (التقاط مسار جديد) لعرض مربّع الحوار Capture System Profile (التقاط ملف تعريف النظام).
في قائمة النوع، اختَر الملف الشخصي للنظام.
في قسم البدء والمدة، اضبط البدء في على يدوي، والمدة على 2.
في القسم خيارات التتبُّع، انقر على إعداد. يعرض هذا قائمة بخيارات التحليل.

الشكل 4: خيارات التحليل في مربع الحوار التقاط ملف تعريف النظام.
اختَر بيانات التوصيف التي تريد تسجيلها.
في القسم وحدة معالجة الرسومات، انقر على اختيار.

وسيؤدي هذا إلى عرض قائمة بالعدّادات لاختيارها.

الشكل 5: جارٍ اختيار العدّادات.
انقر على تلقائي لتحديد مجموعة العدّادات التلقائية، ثم انقر على حسنًا لعرض خيارات التحليل.
انقر على حسنًا للعودة إلى مربّع الحوار الرئيسي التقاط ملف تعريف النظام.
في قسم الإخراج، اختَر دليل الإخراج لتخزين ملفات التتبُّع التي تم إنشاؤها أثناء التحليل. يجب ملء حقل اسم الملف تلقائيًا، ولكن يمكنك أيضًا تعديله.
انقر على حسنًا. يؤدي هذا إلى بدء تشغيل التطبيق المحدد على جهاز Android، وعرض نافذة منبثقة مع زر ابدأ.
انقر على الزر Start (بدء) لبدء تسجيل بيانات التحليل، وانتظر بضع ثوانٍ حتى تنتهي العملية.
انقر على فتح التتبُّع. ويكون العرض الأولي الذي يتم عرضه مشابهًا لطريقة العرض systrace.

الشكل 6: واجهة مستخدم محلّل النظام.

بالإضافة إلى البيانات المتاحة في systrace، يعرض AGI أيضًا معلومات أداء وحدة معالجة الرسومات. لمزيد من المعلومات حول عرض بيانات تحليل النظام، راجع عرض الملف الشخصي لنظام AGI.

للحصول على معلومات حول الإعدادات الإضافية، يُرجى الاطّلاع على خيارات تحليل النظام.

تحديد إطار

لتحديد إطار فردي من تطبيقك، يمكنك تنفيذ الخطوات التالية:

في شاشة بدء AGI، انقر على Capture a new track (التقاط تتبُّع جديد) لعرض مربّع الحوار Capture A New Trace (التقاط بيانات تتبُّع جديدة). ويمكنك بدلاً من ذلك النقر على الزر التقاط بيانات تتبُّع ملف تعريف الإطار.
في قائمة النوع، اختَر Vulkan أو OpenGL على ANGLE بناءً على واجهة برمجة تطبيقات الرسومات التي يستخدمها تطبيقك. تأكد من اختيار الإجراء الصحيح، وإلا لن تلتقط AGI أي أوامر رسومات.
في قسم البدء والمدة، اضبُط البدء في على يدوي. إذا نقرت على الزر التقاط تتبع ملف تعريف الإطار، تكون هذه الخطوة قد اكتملت بالفعل.
في قسم الإخراج، اختَر دليل الإخراج لتخزين ملفات التتبُّع. من المفترض أن يتم ملء حقل اسم الملف تلقائيًا، ولكن يمكنك أيضًا تعديله.
اختياري: تنتج بعض التطبيقات عملية مختلفة لمعالجة جميع الرسومات. لتسجيل هذه العملية، حدِّد اسمها.
انقر على حسنًا. يؤدي هذا إلى تشغيل تطبيقك على جهاز Android، وعرض نافذة منبثقة مع زر ابدأ.
انقر على الزر Start (ابدأ) وانتظر بضع ثوانٍ حتى تكتمل عملية التحليل.
انقر على فتح صفحة التتبُّع للاطّلاع على بيانات إنشاء الملفات التعريفية. للحصول على معلومات حول كل جزء في واجهة مستخدم أداة تحليل الإطارات، راجع نظرة عامة على تحديد إعدادات الإطارات.

للحصول على معلومات حول الإعدادات الإضافية، يُرجى الاطّلاع على خيارات تحديد مواصفات الإطارات.