Как изменить настройки сборки

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

После того как вы скачаете 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. Он включает служебный файл 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.