تعديل إعدادات الإصدار

توضّح الأقسام التالية كيفية دمج مكتبة Tuning Fork في سلسلة أدواتك وكيفية استخدام الدوال التي توفّرها المكتبة. تتوفّر المكتبة كمكتبة ثابتة أو مشترَكة في "مكتبات AGDK".

بعد تنزيل حزمة SDK على جهازك وتسجيلها في نظام التحكّم بالمصادر، عليك إجراء التغييرات المدرَجة في الأقسام التالية على إعدادات الإصدار في مشروعك.

قبل البدء

يجب دمج مكتبة Android Frame Pacing قبل دمج مكتبة Tuning Fork. وفي حال إجراء ذلك، يمكن لمكتبة Tuning Fork تسجيل وقت عرض اللقطة تلقائيًا، ولن تحتاج إلى استدعاء دوال القياس بنفسك.

يُرجى الاطّلاع على أدلة الدمج التالية للحصول على مزيد من المعلومات:

• دمج ميزة "مزامنة اللقطات" في Android في أداة العرض OpenGL
• دمج Android Frame Pacing في أداة العرض Vulkan

مكتبة ثابتة

لربط مشروعك بالمكتبة الثابتة، اتّبِع الخطوات التالية:

1. أضِف gamesdk/include إلى مسارات التضمين في برنامج التجميع.

2. أضِف مسارًا بالشكل التالي في مسارات مكتبة الرابط:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   ابحث في gamesdk/libs واختَر الأداة الأنسب لسلسلة الأدوات التي تستخدمها (على سبيل المثال، gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. أضِف -ltuningfork_static إلى أمر الربط (و-lswappy_static إذا كنت قد أضفت مكتبة Android Frame Pacing).

4. أضِف إذن INTERNET إلى ملف AndroidManifest.xml:

   <uses-permission android:name="android.permission.INTERNET" />
   

المكتبة المشتركة

تربط الخطوات الواردة في قسم المكتبة الثابتة بشكل ثابت إصدارًا من مكتبة Tuning Fork تم تجميعه لواجهة التطبيق الثنائية (ABI) ومستوى واجهة برمجة التطبيقات وNDK وSTL المحدّدة. إذا لم يكن هذا الخيار متاحًا لإعداداتك، يمكنك بدلاً من ذلك الربط بالمكتبة المشتركة:

1. أضِف gamesdk/include إلى مسارات التضمين في برنامج التجميع.

2. أضِف مسارًا بالشكل التالي في مسارات مكتبة الرابط:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. أضِف -ltuningfork إلى أمر الربط (و-lswappy إذا كنت قد أضفت مكتبة Android Frame Pacing).

4. أضِف إذن INTERNET إلى ملف AndroidManifest.xml:

   <uses-permission android:name="android.permission.INTERNET" />
   

يمنحك الربط الثابت مساحة أصغر بكثير للرمز البرمجي لأنّك لن تحتاج إلى تجميع المكتبة المشتركة libtuningfork.so.

استخدام CMake (مكتبة ثابتة فقط)

إذا كنت تستخدم CMake، اطّلِع على ملف gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt للحصول على مثال لإعداد CMake. ويتضمّن ملف أداة مساعدة، gamesdk/samples/gamesdk.cmake، ينفّذ عمليات التحقّق النهائية، ويضيف مسارات التضمين المناسبة للمترجم، وينشئ هدفًا يمكنك استخدامه لربط المكتبة.

لاستخدام هذه الأداة، اتّبِع الخطوات التالية:

1. أدرِج هذا الملف في ملف CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
2. استدعِ الدالة add_gamesdk_target مع المجلد الذي يحتوي على gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. في ملف target_link_libraries الخاص بالمكتبة الأصلية، أضِف tuningfork كعنصر تابع (وswappy إذا كنت قد أضفت مكتبة Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

ملاحظة: يمكن أن يكون مسار gamesdk المستخدَم في include وadd_gamesdk_target إما مطلقًا (على سبيل المثال، /home/yourusername/gamesdk أو C:\Android\gamesdk) أو نسبيًا بالنسبة إلى ملف CMakeLists.txt.

للحصول على معلومات حول الاستخدام المتقدّم لـ CMake، يُرجى الاطّلاع على ملف المصدر gamesdk.cmake.