更新构建设置

以下部分介绍如何将 Tuning Fork 库集成到您的工具链中以及如何使用库提供的函数。该库在 AGDK 库中以静态或共享库的形式提供。

在您将SDK 下载到您的机器并将其检入您的源代码控制系统后，对项目的构建设置进行以下部分中列出的更改。

开始之前

您应该在集成 Tuning Fork 库之前集成Android 帧速率调节库。如果您这样做，Tuning Fork 库可以自动记录帧时间；无需显式调用 tick 函数。

有关更多信息，请参阅以下集成指南

• 将 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添加到您的链接器命令中（如果您集成了 Android 帧速率调节库，则还需添加-lswappy_static）。

4. 将INTERNET权限添加到您的AndroidManifest.xml文件中

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

共享库

静态库部分中的步骤会静态链接到为给定的 ABI、API 级别、NDK 和 STL 组合编译的 Tuning Fork 库版本。如果您的设置中没有可用的组合，则可以改为链接到共享库

1. 将gamesdk/include添加到您的编译器包含路径中。

2. 在您的链接器库路径中添加以下形式的路径

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. 将-ltuningfork添加到您的链接器命令中（如果您集成了 Android 帧速率调节库，则还需添加-lswappy）。

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. 使用包含 gamesdk 的文件夹调用add_gamesdk_target函数：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源文件。