更新 build 设置

将库下载到计算机上并将其签入源代码控制系统后,请对项目的构建设置进行以下更改。

静态库

请按照以下步骤将项目关联到静态库:

  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 添加至链接器命令。

共享库

以上步骤会静态链接到为给定 ABI、API 级别、NDK 和 STL 组合而编译的 Frame Pacing 库版本。如果设置不支持此类组合,您可以改为链接到共享库:

  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. 针对包含 gamesdk 的文件夹调用 add_gamesdk_target 函数:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. 在您的原生库的 target_link_libraries 中,添加 swappy 作为依赖项: target_link_libraries(native-lib swappy ...)

如需查看 CMake 的高级用法,请参阅 gamesdk.cmake 源文件