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

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

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

قبل البدء

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

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

• دمج ميزة "معدل سرعة الإطارات" في Android في عارض OpenGL
• دمج ميزة "معدل سرعة إطارات Android" في عارض 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" />
   

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

ترتبط الخطوات الموجودة في قسم المكتبة الثابتة بشكل ثابت مقابل نسخة من مكتبة "الشوكة الرنانة" التي تم تجميعها لتركيبة ABI وAPI و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 في Android): target_link_libraries(native-lib swappy tuningfork ...)

للاستخدام المتقدم لتطبيق CMake، راجِع ملف المصدر gamesdk.cmake.