تم تقديم دعم "التحسين المستند إلى الملف الشخصي" في AGDE الإصدار 22.2.71.
تحديد موقع إعدادات PGO
افتح إعدادات مشروعك من Solution Explorer.
الشكل 1: نافذة Visual Studio Solution Explorer
تأكَّد من ضبط نظامك الأساسي على أحد إعدادات Android (على سبيل المثال، Android-arm64-v8a).
في اللوحة اليمنى، حدد خصائص التهيئة > الإعدادات العامة: ابحث عن مجموعة المواقع المسماة PGO.
الشكل 2: مربّع حوار "خصائص المشروع".
تفعيل عمليات الإنشاء التي تعتمد على PGO
أضِف إعدادًا جديدًا يسمى تم قياسها إلى مشروعك. تستند هذه النتيجة إلى بالتهيئة التي تستخدمها أثناء التطوير للاختبار، والتي ينبغي أن تكون على التصميم التقليدي والمحسّن (مع إمكانية تصحيح الأخطاء الميزات المتقدمة طالما أنك تحتفظ بإعدادات تحسين برنامج التجميع).
انقر على مدير الإعداد... في مربّع حوار صفحة الموقع.
الشكل 3: مربّع حوار "مدير الإعداد"
في مربع حوار مدير الإعداد، حدد الحل النشط. القائمة المنسدلة "الضبط" واختر <جديد...>.
الشكل 4: إنشاء إعدادات إصدار جديد
... وإنشاء إعدادات جديدة تعتمد على PGO
الشكل 5: مربّع الحوار "إعدادات الحلّ الجديدة".
لتفعيل عملية الإنشاء في وضع "PGO-Machineed" (أداة PGO) لكي تتمكّن من إنشاء ملف شخصي للّعبة، اختَر مزوَّدة بآلات موسيقية من قائمة خيارات وضع التحسين الإرشادي للملف الشخصي.
الشكل 6: مربّع حوار "خصائص المشروع"، مع إبراز إعدادات PGO
بالنسبة إلى إعداد الملفات الشخصية للتحسين الموجَّهة للملف الشخصي، أدخِل المسار الذي يؤدي إلى
المجلّد لكتابة ملف بيانات ملف الإخراج الأولي على جهاز Android.
وعادةً ما تكون هذه القيمة مثل /data/data/<package
name>/cache/، حيث يكون <package name> هو الاسم الكامل للحزمة
حزمة APK – على سبيل المثال، com.google.sample.tunnel.
لمزيد من المعلومات التفصيلية حول كيفية عمل ذلك، راجع قناة ذات الصلة.
كتابة بيانات الملف الشخصي التي يتم قياسها باستخدام PGO على جهازك
وعادةً ما تتم كتابة بيانات PGO على الجهاز عن طريق نظام قياس PGO عندما الخروج من العملية. في أجهزة Android، لا يتم إغلاق التطبيقات، ويتم إنهاؤها دائمًا. هذا النمط تعني أنه يتم استخدام القيمة الافتراضية "كتابة إلى القرص" لا يتم تشغيل وظيفة معينة أبدًا، مما يتطلب لكتابة بيانات PGO يدويًا.
يجب أن يتصل تطبيقك بـ __llvm_profile_write_file صراحةً لكتابة
وبيانات الملف الشخصي. لا يتوفر هذا الرمز إلا عند إنشاء أداة PGO
لتسهيل ذلك، ننصحك باستخدام النمط التالي عند
إعادة توجيه الإعلان بصوت __llvm_profile_write_file.
#ifdef PGO_INSTRUMENT
extern "C" int __llvm_profile_write_file(void);
#else
extern "C" int __llvm_profile_write_file(void) { return 0; }
#endif
يؤدي استدعاء هذه الدالة إلى كتابة بيانات الملف الشخصي في المجلد الذي حددته سابقًا.
إجراء تشغيل الملف الشخصي
لإنشاء الملف الشخصي، عليك تشغيل ملف APK الذي تم إنشاؤه باستخدام أداة PGO على
الجهاز المستهدف. بعد أن تمارس التعليمات البرمجية وفقًا لرضاك،
أدى إلى الاتصال بدالة __llvm_profile_write_file، فسيعمل تطبيقك على
وكتابة بيانات الملف الشخصي إلى التخزين.
في هذه المرحلة، انسخ الملفات الشخصية مرة أخرى من الجهاز لاستخدامها بواسطة برنامج التجميع.
جارٍ تحضير بيانات الملف الشخصي لاستخدامها في برنامج التجميع
عند استخدام أداة سطر الأوامر llvm-profdata بشكل منفصل، يتم شحنها كجزء
يتم استخدام Clang/LLVM في Android NDK لإعداد ملفات بيانات الملف الشخصي لاستخدامها.
بواسطة برنامج التجميع أثناء إجراء تحسين الإصدار باستخدام ملف شخصي.
ينفذ AGDE هذه الخطوة تلقائيًا نيابة عنك من خلال دمج أي ملف شخصي معًا وملفات البيانات التي أضفتها إلى مشروعك، واستخدامها عند إعداد وضع التحسين المستند إلى الملف الشخصي في صفحات الموقع على المشروع تم ضبطها على محسَّنة.
إنشاء مشروعك مع تفعيل ميزة "التحسين المستند إلى الملف الشخصي"
والآن بعد أن أخذت ملفك(ملفاتك) الشخصي، وأضفته إلى مشروعك، بإمكان برنامج التجميع هذه استخدام هذه البيانات لتحسين عملية إنشاء موقعك.
يمكنك إنشاء إعدادات مشروع جديدة لإصدار PGO-Optimized Build بحيث لا تصمم في هذا الوضع عند الحاجة.
الشكل 7: إنشاء إعدادات جديدة لبنية محسَّنة ضمن PGO
تحديد إعداد وضع التحسين المستند إلى الملف الشخصي في موقع المشروع محسَّنة.
الشكل 8: ضبط وضع تحسين PGO على "محسَّن".
انسخ الملفات من الجهاز وأضفها إلى مشروعك في "الحل" المستكشف. يختار برنامج التجميع ملفات بيانات الملف الشخصي هذه في المرة التالية في إنشاء تهيئة PGO-Optimized، واستخدامها لضبط كيفية عمل المحول البرمجي إلى تحسين التعليمة البرمجية.
يمكنك نسخ ملفات بيانات الملف الشخصي إلى مشروعك من الجهاز باستخدام ADB، أو باستخدام "مستكشف أجهزة Android".
استخدام ميزة "التحسين المستند إلى الملف الشخصي" خارج AGDE
إذا كنت تستخدم نظام إصدار غير متوافق مع AGDE، قد تحتاج إلى
وتحرير التصميم مباشرة. كلانغ
المستندات
يغطي مفاتيح التبديل اللازمة – -fprofile-generate،
-fprofile-use
إذا كنت تستخدم محرك برمجيات وسيطة في لعبتك، راجِع المستندات. للمحرك للاطّلاع على طريقة تفعيل PGO (إذا كان متاحًا).