Memperbarui setelan build Anda

Bagian berikut menjelaskan cara mengintegrasikan library Tuning Fork ke dalam toolchain dan cara menggunakan fungsi yang disediakan library. Library tersedia sebagai library statis atau library bersama di Library AGDK.

Setelah mendownload SDK ke mesin dan memeriksanya ke sistem kontrol sumber, lakukan perubahan yang tercantum di bagian berikut pada setelan build project Anda.

Sebelum memulai

Anda harus mengintegrasikan library Android Frame Pacing sebelum mengintegrasikan library Tuning Fork. Jika melakukannya, library Tuning Fork dapat merekam waktu frame secara otomatis; tidak perlu memanggil fungsi titik skala secara eksplisit.

Lihat panduan integrasi berikut untuk informasi selengkapnya:

• Mengintegrasikan Android Frame Pacing ke dalam perender OpenGL
• Mengintegrasikan Android Frame Pacing ke dalam perender Vulkan

Library statis

Untuk menautkan project ke library statis, lakukan hal berikut:

1. Tambahkan gamesdk/include ke jalur penyertaan compiler.

2. Tambahkan jalur dari formulir berikut di jalur library linker Anda:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Cari dalam gamesdk/libs, lalu pilih satu yang paling sesuai dengan toolchain Anda (misalnya, gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. Tambahkan -ltuningfork_static ke perintah linker (dan -lswappy_static jika Anda mengintegrasikan library Android Frame Pacing).

4. Tambahkan izin INTERNET ke file AndroidManifest.xml:

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

Library bersama

Langkah-langkah di bagian library statis secara statis menautkan ke versi library Tuning Fork yang dikompilasi untuk kombinasi ABI, API level, NDK, dan STL tertentu. Jika kombinasi tidak tersedia untuk setelan, Anda dapat menautkan ke pustaka bersama:

1. Tambahkan gamesdk/include ke jalur penyertaan compiler.

2. Tambahkan jalur dari formulir berikut di jalur library linker Anda:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Tambahkan -ltuningfork ke perintah linker (dan -lswappy jika Anda mengintegrasikan library Android Frame Pacing).

4. Tambahkan izin INTERNET ke file AndroidManifest.xml:

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

Penautan statis memberi Anda jejak kode yang jauh lebih kecil karena Anda tidak perlu memaketkan pustaka bersama libtuningfork.so.

Menggunakan CMake (khusus library statis)

Jika menggunakan CMake, lihat file gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt untuk contoh konfigurasi CMake. Rilis ini mencakup file utilitas, gamesdk/samples/gamesdk.cmake, yang melakukan pemeriksaan akhir, menambahkan jalur penyertaan compiler yang sesuai, dan menghasilkan target yang dapat digunakan untuk menautkan library.

Untuk menggunakan utilitas ini, lakukan hal berikut:

1. Sertakan file ini dalam file CMakeLists.txt Anda: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Panggil fungsi add_gamesdk_target dengan folder yang berisi gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. Di target_link_libraries untuk library native, tambahkan tuningfork sebagai dependensi (dan swappy jika Anda mengintegrasikan Android Frame Pacing ): target_link_libraries(native-lib swappy tuningfork ...)

Catatan: Jalur ke gamesdk yang digunakan untukinclude dan add_gamesdk_target dapat bersifat mutlak (misalnya, /home/yourusername/gamesdk atau C:\Android\gamesdk) atau relatif terhadap file CMakeLists.txt.

Untuk penggunaan CMake lanjutan, lihat gamesdk.cmake file sumber.