Обновите настройки сборки

В следующих разделах описывается, как интегрировать библиотеку Tuning Fork в вашу цепочку инструментов и как использовать функции, предоставляемые библиотекой. Библиотека доступна как статическая или общая библиотека в библиотеках AGDK.

После того, как вы загрузили SDK на свой компьютер и зарегистрировали его в своей системе управления версиями, внесите изменения, перечисленные в следующих разделах, в настройки сборки вашего проекта.

Прежде чем начать

Прежде чем интегрировать библиотеку Tuning Fork, вам следует интегрировать библиотеку Android Frame Pacing . Если вы сделаете это, библиотека Tuning Fork сможет автоматически записывать время кадра; нет необходимости самостоятельно вызывать функции галочки явно.

Дополнительные сведения см. в следующих руководствах по интеграции:

• Интегрируйте Android Frame Pacing в свой рендерер OpenGL.
• Интегрируйте Android Frame Pacing в свой рендерер Vulkan.

Статическая библиотека

Чтобы связать ваш проект со статической библиотекой, сделайте следующее:

1. Добавьте gamesdk/include в пути включения вашего компилятора.

2. Добавьте путь следующей формы в пути к вашей библиотеке компоновщика:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Посмотрите gamesdk/libs и выберите тот, который лучше всего подходит для вашей цепочки инструментов (например, gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release ).

3. Добавьте -ltuningfork_static в команду компоновщика (и -lswappy_static если вы интегрировали библиотеку Android Frame Pacing).

4. Добавьте разрешение INTERNET в файл AndroidManifest.xml :

   <uses-permission android:name="android.permission.INTERNET" />
   

Общая библиотека

Действия в разделе статической библиотеки статически связываются с версией библиотеки Tuning Fork, скомпилированной для заданной комбинации ABI, уровня API, NDK и STL. Если комбинация недоступна для ваших настроек, вы можете вместо этого связать ее с общей библиотекой:

1. Добавьте gamesdk/include в пути включения вашего компилятора.

2. Добавьте путь следующей формы в пути к вашей библиотеке компоновщика:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Добавьте -ltuningfork в команду компоновщика (и -lswappy , если вы интегрировали библиотеку Android Frame Pacing).

4. Добавьте разрешение INTERNET в файл AndroidManifest.xml :

   <uses-permission android:name="android.permission.INTERNET" />
   

Статическое связывание позволяет значительно сократить объем кода, поскольку вам не нужно связывать общую библиотеку libtuningfork.so .

Использование CMake (только статическая библиотека)

Если вы используете CMake, см. файл gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt где приведен пример конфигурации CMake. Он включает в себя служебный файл gamesdk/samples/gamesdk.cmake , который выполняет окончательные проверки, добавляет правильные пути включения компилятора и генерирует целевой объект, который можно использовать для связывания библиотеки.

Чтобы использовать эту утилиту, сделайте следующее:

1. Включите этот файл в файл CMakeLists.txt : include(" path/to/gamesdk /samples/gamesdk.cmake")
2. Вызовите функцию add_gamesdk_target с папкой, содержащей gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk )
3. В target_link_libraries для вашей собственной библиотеки добавьте tuningfork в качестве зависимости (и swappy если вы интегрировали библиотеку Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

Дополнительные сведения об использовании CMake см. в исходном файле gamesdk.cmake .