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

В следующих разделах описывается, как интегрировать библиотеку 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 , который выполняет финальные проверки, добавляет правильные пути к include-файлам компилятора и генерирует целевой объект, который можно использовать для подключения библиотеки.

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

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 .