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

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

مكتبة ثابتة

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

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 الملف المصدر.