Después de descargar la biblioteca en tu máquina y de incluirla en el sistema de control de código fuente, realiza los cambios siguientes en la configuración de compilación del proyecto.
Biblioteca estática
Sigue estos pasos para vincular tu proyecto a la biblioteca estática:
- Agrega
gamesdk/include
a las rutas de inclusión de tu compilador. - Incluye
swappy/swappyVk.h
para la integración con Vulkan. En la mayoría de los casos, el archivo de encabezado contiene todas las funciones que necesitas para integrar la biblioteca al motor. Agrega una ruta de acceso con el siguiente formato en las rutas de acceso de tu biblioteca de vinculadores:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
Por ejemplo:
gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
Agrega
-lswappy_static
a tu comando de vinculador.
Biblioteca compartida
Los pasos anteriores se vinculan estáticamente a una versión de la biblioteca de Frame Pacing que se compiló para la combinación determinada de ABI, nivel de API, NDK y STL. Si la combinación no está disponible para tu configuración, puedes vincularla a la biblioteca compartida:
- Sigue los pasos 1 y 2 de la sección anterior para actualizar las rutas de inclusión de tu compilador y usar el archivo de encabezado adecuado.
Agrega una ruta de acceso con el siguiente formato en las rutas de acceso de tu biblioteca de vinculadores:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
Agrega
-lswappy
a tu comando de vinculador.
La vinculación estática te brindará una huella de código mucho más pequeña, ya que no necesitarás empaquetar la biblioteca compartida libswappy.so
.
Cómo usar CMake (solo biblioteca estática)
Si usas CMake, consulta el archivo gamesdk/samples/bouncyball/app/CMakeLists.txt
de la biblioteca descargada para obtener un ejemplo de configuración de CMake. En él, se incluye un archivo de utilidad, gamesdk/samples/gamesdk.cmake
, que realiza las comprobaciones finales, agrega las rutas correctas de inclusión del compilador y genera un destino que puedes usar para vincular la biblioteca.
Para implementar esta utilidad, haz lo siguiente:
- Incluye este archivo en tu CMakeLists.txt:
include("path/to/gamesdk/samples/gamesdk.cmake")
. - Llama a la función
add_gamesdk_target
con la carpeta que contiene el gamesdk:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
. - En tu
target_link_libraries
de la biblioteca nativa, agregaswappy
como una dependencia:target_link_libraries(native-lib swappy ...)
.
Para un uso avanzado de CMake, consulta el archivo fuente gamesdk.cmake
.