更新您的构建设置

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

静态库

执行以下步骤以将您的项目链接到静态库

  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 组合编译的帧速率库版本。如果您的设置中没有可用的组合,则可以链接到共享库

  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源文件