بعد تنزيل المكتبة على جهازك وفحصها في نظام التحكم في المصدر، يمكنك إجراء التغييرات التالية على إعدادات تصميم مشروعك.
مكتبة ثابتة
قم بالخطوات التالية لربط مشروعك بالمكتبة الثابتة:
- أضِف
gamesdk/include
إلى مسارات التضمين في برنامج التجميع. - يمكنك تضمين
swappy/swappyVk.h
لدمجها مع Vulkan. في معظم الحالات، يحتوي ملف العنوان على جميع الدوال التي تحتاجها لدمج المكتبة في محركك. أضِف مسار النموذج التالي في مسارات مكتبة الروابط:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
على سبيل المثال:
gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
أضِف
-lswappy_static
إلى أمر linker.
المكتبة المشتركة
ترتبط الخطوات المذكورة أعلاه بشكل ثابت بإصدار من مكتبة Frame Pacing المجمّعة لمجموعة محددة من واجهات التطبيق الثنائية (ABI) ومستوى واجهة برمجة التطبيقات وNDK وSTL. إذا كانت التركيبة غير متاحة لإعداداتك، يمكنك بدلاً من ذلك الربط بالمكتبة المشتركة:
- اتبع الخطوتين 1 و2 من القسم السابق لتحديث برنامج التجميع البرمجي للمسارات واستخدم ملف الرأس المناسب.
أضِف مسار النموذج التالي في مسارات مكتبة الروابط:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
أضِف
-lswappy
إلى أمر linker.
سيمنحك الربط الثابت مساحة رمز أقل بكثير لأنّك لست بحاجة إلى تجميع مكتبة libswappy.so
المشتركة.
استخدام CMake (المكتبة الثابتة فقط)
إذا كنت تستخدم CMake، راجِع ملف gamesdk/samples/bouncyball/app/CMakeLists.txt
في المكتبة التي تم تنزيلها
للحصول على مثال على إعدادات CMake. وهو يتضمن ملف الأداة gamesdk/samples/gamesdk.cmake
الذي ينفذ عمليات التحقق النهائية ويضيف مسارات المحول البرمجي الصحيحة لتضمين المسارات وينشئ هدفًا يمكنك استخدامه لربط المكتبة.
لاستخدام هذه الأداة، قم بما يلي:
- تضمين هذا الملف في CMakeLists.txt:
include("path/to/gamesdk/samples/gamesdk.cmake")
- استدعِ الدالة
add_gamesdk_target
مع المجلد الذي يحتوي على ملف game SDK:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- في
target_link_libraries
لمكتبتك الأصلية، أضِفswappy
كقائمة تابعة:target_link_libraries(native-lib swappy ...)
للاستخدام المتقدم لتطبيق CMake، راجِع ملف المصدر gamesdk.cmake
.