在您 下载库 到您的机器上并将其检入您的源代码控制系统后,请对您的项目构建设置进行以下更改。
静态库
执行以下步骤将您的项目链接到静态库
- 将
gamesdk/include
添加到您的编译器包含路径。 - 包括
swappy/swappyVk.h
用于与 Vulkan 集成。在大多数情况下,头文件包含将库集成到您的引擎所需的所有函数。 在您的链接器库路径中添加以下形式的路径
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
例如:
gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
将
-lswappy_static
添加到您的链接器命令中。
共享库
上述步骤会针对为给定 ABI、API 级别、NDK 和 STL 组合编译的 Frame Pacing 库版本进行静态链接。如果您的设置中没有此组合,则可以改为链接共享库
- 按照上一节中的步骤 1 和 2 更新您的编译器包含路径并使用相应头文件。
在您的链接器库路径中添加以下形式的路径
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
将
-lswappy
添加到您的链接器命令中。
静态链接将为您提供更小的代码占用空间,因为您无需捆绑 libswappy.so
共享库。
使用 CMake(仅限静态库)
如果您使用的是 CMake,请参阅 下载库 中的 gamesdk/samples/bouncyball/app/CMakeLists.txt
文件以获取 CMake 配置示例。它包含一个实用程序文件 gamesdk/samples/gamesdk.cmake
,该文件执行最终检查、添加适当的编译器包含路径以及生成一个可用于链接库的目标。
要使用此实用程序,请执行以下操作
- 在您的 CMakeLists.txt 中包含此文件:
include("path/to/gamesdk/samples/gamesdk.cmake")
- 使用包含 gamesdk 的文件夹调用
add_gamesdk_target
函数:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- 在您的原生库的
target_link_libraries
中,添加swappy
作为依赖项:target_link_libraries(native-lib swappy ...)
有关 CMake 的高级用法,请参阅 gamesdk.cmake
源文件。