تنظیمات ساخت خود را به روز کنید

پس از اینکه کتابخانه را در دستگاه خود دانلود کردید و آن را در سیستم کنترل منبع خود بررسی کردید، تغییرات زیر را در تنظیمات ساخت پروژه خود اعمال کنید.

کتابخانه ایستا

مراحل زیر را برای پیوند دادن پروژه خود به کتابخانه استاتیک انجام دهید:

  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، سطح API، 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 را ببینید.