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

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

مكتبة ثابتة

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

1. أضِف gamesdk/include إلى مسارات التضمين في برنامج التجميع.
2. تضمين swappy/swappyVk.h لدمجها مع Vulkan في معظم الحالات، يحتوي ملف العناوين على جميع الدوال التي تحتاج إليها لدمج المكتبة في محركك.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   على سبيل المثال: gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release

4. أضِف -lswappy_static إلى أمر الربط.

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

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

1. اتّبِع الخطوتَين 1 و2 من القسم السابق لتعديل مسارات تضمين برنامج التجميع واستخدِم ملف العنوان المناسب.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
   

3. أضِف -lswappy إلى أمر الربط.

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

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

إذا كنت تستخدم CMake، يمكنك الاطّلاع على ملف gamesdk/samples/bouncyball/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 الخاص بالمكتبة المجمّعة من رموز برمجية أصلية، أضِف swappy كعنصر تابع: target_link_libraries(native-lib swappy ...)

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