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

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

مكتبة ثابتة

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

  1. أضِف gamesdk/include إلى مسارات التضمين في برنامج التجميع.
  2. ضمِّن swappy/swappyGL.h لدمجها مع OpenGL ES. في معظم الحالات، يحتوي ملف العنوان على جميع الدوال التي تحتاجها لدمج المكتبة في المحرّك.
  3. أضِف مسار النموذج التالي في مسارات مكتبة الروابط:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
    

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

  4. أضِف -lswappy_static إلى أمر linker.

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

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

  1. اتبع الخطوتين 1 و2 من القسم السابق لتحديث برنامج التجميع البرمجي للمسارات واستخدم ملف الرأس المناسب.
  2. أضِف مسار النموذج التالي في مسارات مكتبة الروابط:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
    
  3. أضِف -lswappy إلى أمر linker.

سيمنحك الربط الثابت مساحة رمز أقل بكثير لأنّك لست بحاجة إلى تجميع مكتبة 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 مع المجلد الذي يحتوي على ملف game SDK: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. في target_link_libraries لمكتبتك الأصلية، أضِف swappy كقائمة تابعة: target_link_libraries(native-lib swappy ...)

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