После того, как вы загрузили библиотеку на свой компьютер и зарегистрировали ее в своей системе контроля версий, внесите следующие изменения в настройки сборки вашего проекта.
Статическая библиотека
Выполните следующие шаги, чтобы связать свой проект со статической библиотекой:
- Добавьте
gamesdk/include
в пути включения вашего компилятора. - Включите
swappy/swappyVk.h
для интеграции с Vulkan. В большинстве случаев заголовочный файл содержит все функции, необходимые для интеграции библиотеки в ваш движок. Добавьте путь следующей формы в пути к вашей библиотеке компоновщика:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
Например:
gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
Добавьте
-lswappy_static
в команду компоновщика.
Общая библиотека
Вышеупомянутые шаги статически связаны с версией библиотеки Frame Pacing, скомпилированной для данной комбинации ABI, уровня API, NDK и STL. Если комбинация недоступна для ваших настроек, вы можете вместо этого связать ее с общей библиотекой:
- Выполните шаги 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")
- Вызовите функцию
add_gamesdk_target
с папкой, содержащей gamesdk:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk )
- В
target_link_libraries
для вашей собственной библиотеки добавьтеswappy
в качестве зависимости:target_link_libraries(native-lib swappy ...)
Дополнительные сведения об использовании CMake см. в исходном файле gamesdk.cmake
.