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

بخش‌های زیر نحوه ادغام کتابخانه Tuning Fork در زنجیره ابزار و نحوه استفاده از توابع ارائه شده توسط کتابخانه را توضیح می‌دهند. این کتابخانه به صورت یک کتابخانه ثابت یا اشتراکی در کتابخانه های AGDK موجود است.

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

قبل از شروع

قبل از ادغام کتابخانه Tuning Fork باید کتابخانه Android Frame Pacing را ادغام کنید. اگر این کار را انجام دهید، کتابخانه Tuning Fork می تواند به طور خودکار زمان فریم را ضبط کند. نیازی به فراخوانی صریح توابع تیک وجود ندارد.

برای اطلاعات بیشتر به راهنمای ادغام زیر مراجعه کنید:

• Android Frame Pacing را در رندر OpenGL خود ادغام کنید
• Android Frame Pacing را در رندر 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" />
   

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

مراحل در بخش کتابخانه ایستا به طور ایستا با نسخه ای از کتابخانه Tuning Fork که برای ترکیب ABI، سطح API، NDK و STL کامپایل شده است، پیوند دارند. اگر این ترکیب برای تنظیمات شما در دسترس نیست، می‌توانید در عوض به کتابخانه مشترک پیوند دهید:

1. مسیرهای شامل gamesdk/include به کامپایلر خود اضافه کنید.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. -ltuningfork به دستور پیوند دهنده خود اضافه کنید (و -lswappy اگر کتابخانه Android Frame Pacing را یکپارچه کرده باشید).

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

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

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

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

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

توجه: مسیر gamesdk مورد استفاده برای include و add_gamesdk_target می‌تواند مطلق باشد (به عنوان مثال /home/yourusername/gamesdk یا C:\Android\gamesdk ) یا نسبت به فایل CMakeLists.txt .

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