O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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 no SDK do Android Game.

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.0_cpp_static_Release).

  3. Adicione -lgamesdk ao comando do vinculador.

  4. Adicione a permissão INTERNET ao seu 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 -lgamesdk ao comando do vinculador.

  4. Adicione a permissão INTERNET ao seu 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 gamesdk como uma dependência: target_link_libraries(native-lib gamesdk ...)

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