다음 섹션에서는 Tuning Fork 라이브러리를 도구 모음에 통합하는 방법 및 라이브러리에서 제공하는 함수를 사용하는 방법을 설명합니다. 라이브러리는 AGDK 라이브러리에서 정적 또는 공유 라이브러리로 사용할 수 있습니다.
머신에 SDK를 다운로드하고 소스 제어 시스템에 체크인한 후 다음 섹션에 나열된 변경사항을 프로젝트의 빌드 설정에 적용합니다.
시작하기 전에
Tuning Fork 라이브러리를 통합하기 전에 Android Frame Pacing 라이브러리를 통합해야 합니다. 이렇게 하면 Tuning Fork 라이브러리가 프레임 시간을 자동으로 기록할 수 있습니다. 틱 함수를 직접 명시적으로 호출할 필요가 없습니다.
자세한 내용은 다음 통합 가이드를 참고하세요.
정적 라이브러리
프로젝트를 정적 라이브러리에 연결하려면 다음 단계를 따르세요.
- 컴파일러 포함 경로에
gamesdk/include를 추가합니다. 링커 라이브러리 경로에 다음 형식의 경로를 추가합니다.
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
gamesdk/libs를 찾아서 도구 모음에 가장 적합한 라이브러리(예:gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release)를 선택합니다.링커 명령어(및 Android Frame Pacing 라이브러리를 통합한 경우
-lswappy_static)에-ltuningfork_static을 추가합니다.다음과 같이
AndroidManifest.xml파일에INTERNET권한을 추가합니다.<uses-permission android:name="android.permission.INTERNET" />
공유 라이브러리
정적 라이브러리 섹션의 단계는 지정된 ABI, API 수준, NDK 및 STL 조합에 관해 컴파일된 Tuning Fork 라이브러리 버전과 정적으로 연결됩니다. 설정에 조합을 사용할 수 없다면 대신 공유 라이브러리에 연결할 수 있습니다.
- 컴파일러 포함 경로에
gamesdk/include를 추가합니다. 링커 라이브러리 경로에 다음 형식의 경로를 추가합니다.
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
링커 명령어(및 Android Frame Pacing 라이브러리를 통합한 경우
-lswappy)에-ltuningfork를 추가합니다.다음과 같이
AndroidManifest.xml파일에INTERNET권한을 추가합니다.<uses-permission android:name="android.permission.INTERNET" />
정적 연결을 사용하면 libtuningfork.so 공유 라이브러리를 번들로 묶을 필요가 없기 때문에 코드 공간이 훨씬 더 줄어듭니다.
CMake 사용(정적 라이브러리만 해당)
CMake를 사용하는 경우 CMake 구성 예를 보려면 gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt 파일을 참고합니다. 여기에는 최종 검사를 실행하고, 적절한 컴파일러 포함 경로를 추가하며, 라이브러리를 연결하는 데 사용할 수 있는 타겟을 생성하는 유틸리티 파일인 gamesdk/samples/gamesdk.cmake가 포함되어 있습니다.
이 유틸리티를 사용하려면 다음 단계를 따르세요.
CMakeLists.txt파일에 이 파일 포함:include("path/to/gamesdk/samples/gamesdk.cmake")- gamesdk가 포함된 폴더를 사용하여
add_gamesdk_target함수 호출:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk) - 네이티브 라이브러리의
target_link_libraries에서tuningfork를 종속 항목 (Android Frame Pacing을 통합한 경우swappy) 생성합니다.target_link_libraries(native-lib swappy tuningfork ...)
CMake의 고급 사용법은 gamesdk.cmake 소스 파일을 참고하세요.