빌드 설정 업데이트

다음 섹션에서는 Tuning Fork 라이브러리를 도구 모음에 통합하는 방법 및 라이브러리에서 제공하는 함수를 사용하는 방법을 설명합니다. 이 라이브러리는 Android 게임 SDK에서 정적 라이브러리 또는 공유 라이브러리로 사용할 수 있습니다.

머신에 SDK를 다운로드하고 소스 제어 시스템에 체크인한 후 다음 섹션에 나열된 변경사항을 프로젝트의 빌드 설정에 적용합니다.

시작하기 전에

Tuning Fork 라이브러리를 통합하기 전에 Android Frame Pacing 라이브러리를 통합해야 합니다. 이렇게 하면 Tuning Fork 라이브러리가 프레임 시간을 자동으로 기록할 수 있습니다. 틱 함수를 직접 명시적으로 호출할 필요가 없습니다.

자세한 내용은 다음 통합 가이드를 참고하세요.

정적 라이브러리

프로젝트를 정적 라이브러리에 연결하려면 다음 단계를 따르세요.

  1. 컴파일러 포함 경로에 gamesdk/include를 추가합니다.
  2. 링커 라이브러리 경로에 다음 형식의 경로를 추가합니다.

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
    

    gamesdk/libs를 찾아서 도구 모음에 가장 적합한 라이브러리(예: gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release)를 선택합니다.

  3. 링커 명령어(및 Android Frame Pacing 라이브러리를 통합한 경우 -lswappy_static)에 -ltuningfork_static을 추가합니다.

  4. 다음과 같이 AndroidManifest.xml 파일에 INTERNET 권한을 추가합니다.

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

공유 라이브러리

정적 라이브러리 섹션의 단계는 지정된 ABI, API 수준, NDK 및 STL 조합에 관해 컴파일된 Tuning Fork 라이브러리 버전과 정적으로 연결됩니다. 설정에 조합을 사용할 수 없다면 대신 공유 라이브러리에 연결할 수 있습니다.

  1. 컴파일러 포함 경로에 gamesdk/include를 추가합니다.
  2. 링커 라이브러리 경로에 다음 형식의 경로를 추가합니다.

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
    
  3. 링커 명령어(및 Android Frame Pacing 라이브러리를 통합한 경우 -lswappy)에 -ltuningfork를 추가합니다.

  4. 다음과 같이 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가 포함되어 있습니다.

이 유틸리티를 사용하려면 다음 단계를 따르세요.

  1. CMakeLists.txt 파일에 이 파일 포함: include("path/to/gamesdk/samples/gamesdk.cmake")
  2. gamesdk가 포함된 폴더를 사용하여 add_gamesdk_target 함수 호출: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. 네이티브 라이브러리의 target_link_libraries에서 tuningfork를 종속 항목으로 추가합니다.(Android Frame Pacing 라이브러리를 통합한 경우에는 swappy): target_link_libraries(native-lib swappy tuningfork ...)

CMake의 고급 사용법은 gamesdk.cmake 소스 파일을 참고하세요.