Atualizar configurações de compilação

As seções a seguir descrevem como integrar a biblioteca Tuning Fork ao seu conjunto de ferramentas e como usar as funções que a biblioteca oferece. Ela está disponível como uma biblioteca estática ou compartilhada nas bibliotecas do AGDK.

Depois de fazer o download do SDK na sua máquina e verificar se ele consta no sistema de controle de origem, faça as alterações listadas nas seções a seguir nas configurações de compilação do seu projeto.

Antes de começar

É necessário integrar a biblioteca Android Frame Pacing antes de integrar a biblioteca Tuning Fork. Ao fazer isso, a biblioteca Tuning Fork poderá gravar automaticamente o tempo para a renderização de frame. Não será preciso chamar manualmente as funções de marcação.

Consulte os seguintes guias de integração para ver mais informações:

Biblioteca estática

Para vincular seu projeto à biblioteca estática, faça o seguinte:

  1. Adicione gamesdk/include aos caminhos de inclusão do compilador.
  2. Adicione um caminho no seguinte formato aos caminhos da biblioteca do vinculador:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
    

    Procure em gamesdk/libs e escolha aquele mais adequado ao seu conjunto de ferramentas (por exemplo, gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

  3. Adicione -ltuningfork_static ao comando do vinculador (e -lswappy_static, se você tiver integrado a biblioteca Android Frame Pacing).

  4. Adicione a permissão INTERNET ao arquivo AndroidManifest.xml:

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

Biblioteca compartilhada

As etapas na seção da biblioteca estática são vinculadas de forma estática a uma versão da biblioteca Tuning Fork compilada para a combinação de ABI, nível de API, NDK e STL determinada. Se a combinação não estiver disponível para suas configurações, você poderá vincular à biblioteca compartilhada:

  1. Adicione gamesdk/include aos caminhos de inclusão do compilador.
  2. Adicione um caminho no seguinte formato aos caminhos da biblioteca do vinculador:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
    
  3. Adicione -ltuningfork ao comando do vinculador (e -lswappy se você tiver integrado a biblioteca Android Frame Pacing).

  4. Adicione a permissão INTERNET ao arquivo AndroidManifest.xml:

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

A vinculação estática oferece um tamanho de código muito menor, já que não é necessário agrupar a biblioteca compartilhada libtuningfork.so.

Como usar o CMake (somente para a biblioteca estática)

Se você estiver usando o CMake, consulte o arquivo gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt para ver um exemplo de configuração do CMake. Ela inclui um arquivo utilitário, gamesdk/samples/gamesdk.cmake, que executa verificações finais, adiciona os caminhos de inclusão do compilador adequados e gera um destino que pode ser usado para vincular a biblioteca.

Para usar esse utilitário, siga estas etapas:

  1. Inclua este arquivo no seu arquivo CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
  2. Chame a função add_gamesdk_target com a pasta que contém o gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. Em target_link_libraries da biblioteca nativa, adicione tuningfork como uma dependência (e swappy se você integrou a biblioteca Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

Para uso avançado do CMake, consulte o arquivo de origem gamesdk.cmake.