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

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

مكتبة ثابتة

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

  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 إلى أمر الربط.

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

ترتبط الخطوات المذكورة أعلاه بشكل ثابت مع إصدار مكتبة وتيرة الإطار بالنسبة إلى مزيج 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.