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

بخش‌های زیر نحوه ادغام کتابخانه «چنگال کوک» را در زنجیره ابزار و نحوه استفاده از عملکردهایی که کتابخانه ارائه می‌دهد شرح می‌دهد. کتابخانه به‌عنوان کتابخانه ایستا یا مشترک در «کتابخانه‌های AGDK» دردسترس است.

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

قبل‌از شروع

باید کتابخانه «گام‌بندی قاب Android» را قبل‌از ادغام کتابخانه «چنگال کوک» ادغام کنید. اگر این کار را انجام دهید، کتابخانه چنگال کوک می‌تواند زمان قاب را به‌طور خودکار ضبط کند؛ نیازی نیست که خودتان توابع تیک را به‌طور صریح فراخوانی کنید.

برای اطلاعات بیشتر، راهنماهای یکپارچه‌سازی زیر را ببینید:

• ادغام کردن «تراز کردن قاب Android» در رندرکننده OpenGL
• ادغام کردن «گام‌سازی قاب Android» در رندرکننده Vulkan

کتابخانه ثابت

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

1. ‫gamesdk/include را به مسیرهای گنجاندن کامپایلر اضافه کنید.

2. مسیر زیر را به مسیرهای کتابخانه پیونددهنده خود اضافه کنید:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   در gamesdk/libs جستجو کنید و موردی را که بهترین تناسب را با زنجیره ابزار شما دارد انتخاب کنید (برای مثال، gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. ‫-ltuningfork_static را به دستور پیونددهنده خود اضافه کنید (و -lswappy_static اگر کتابخانه Android Frame Pacing را ادغام کرده‌اید).

4. اجازه INTERNET را به فایل AndroidManifest.xml خود اضافه کنید:

   <uses-permission android:name="android.permission.INTERNET" />
   

کتابخانه مشترک

مراحل بخش کتابخانه ایستا به‌صورت ایستا با نسخه کتابخانه «چنگال تنظیم» که برای ترکیب ABI، سطح API،‏ NDK، و STL داده‌شده همگردانی شده است پیوند می‌دهد. اگر این ترکیب برای تنظیمات شما دردسترس نیست، می‌توانید به‌جای آن به کتابخانه مشترک پیوند دهید:

1. ‫gamesdk/include را به مسیرهای گنجاندن کامپایلر اضافه کنید.

2. مسیر زیر را به مسیرهای کتابخانه پیونددهنده خود اضافه کنید:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. ‫-ltuningfork را به دستور پیونددهنده خود اضافه کنید (و -lswappy را اگر کتابخانه «گام‌بندی چارچوب Android» را ادغام کرده‌اید).

4. اجازه INTERNET را به فایل AndroidManifest.xml خود اضافه کنید:

   <uses-permission android:name="android.permission.INTERNET" />
   

پیونددهی ایستا ردپای کد بسیار کوچکتری به شما می‌دهد زیرا نیازی نیست کتابخانه مشترک libtuningfork.so را دسته‌بندی کنید.

استفاده از CMake (فقط کتابخانه ایستا)

اگر از CMake استفاده می‌کنید، برای نمونه‌ای از پیکربندی CMake، فایل gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt را ببینید. این فایل شامل فایل کمکی، 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 برای کتابخانه بومی‌تان، tuningfork را به‌عنوان وابستگی اضافه کنید (و اگر کتابخانه «تراز قاب Android» را ادغام کرده‌اید، swappy را اضافه کنید): target_link_libraries(native-lib swappy tuningfork ...)

برای استفاده پیشرفته از CMake، فایل منبع gamesdk.cmake را ببینید.