Aggiornare le impostazioni della build

Le sezioni che seguono descrivono come integrare la libreria Tuning Fork nella toolchain e come utilizzare le funzioni fornite dalla libreria. La libreria è disponibile come libreria statica o condivisa nelle librerie AGDK.

Dopo aver scaricato l'SDK sul tuo computer e averlo archiviato nel sistema di controllo del codice sorgente, apporta le modifiche elencate nelle sezioni seguenti alle impostazioni di build del progetto.

Prima di iniziare

Devi integrare la libreria Android Frame Pacing prima di integrare la libreria Tuning Fork. Se lo fai, la libreria Tuning Fork può registrare automaticamente il tempo del frame; non è necessario chiamare esplicitamente le funzioni di tick.

Per ulteriori informazioni, consulta le seguenti guide all'integrazione:

• Integrare Android Frame Pacing nel renderer OpenGL
• Integrare Android Frame Pacing nel renderer Vulkan

Libreria statica

Per collegare il progetto alla libreria statica:

1. Aggiungi gamesdk/include ai percorsi di inclusione del compilatore.

2. Aggiungi un percorso del seguente formato nei percorsi della libreria del linker:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Cerca in gamesdk/libs e scegli quello più adatto alla tua toolchain (ad esempio gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. Aggiungi -ltuningfork_static al comando del linker (e -lswappy_static se hai integrato la libreria Android Frame Pacing).

4. Aggiungi l'autorizzazione INTERNET al file AndroidManifest.xml:

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

Libreria condivisa

I passaggi nella sezione Libreria statica collegano staticamente una versione della libreria Tuning Fork compilata per la combinazione di ABI, livello API, NDK e STL specificata. Se la combinazione non è disponibile per le tue impostazioni, puoi invece eseguire il collegamento alla libreria condivisa:

1. Aggiungi gamesdk/include ai percorsi di inclusione del compilatore.

2. Aggiungi un percorso del seguente formato nei percorsi della libreria del linker:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Aggiungi -ltuningfork al comando del linker (e -lswappy se hai integrato la libreria Android Frame Pacing).

4. Aggiungi l'autorizzazione INTERNET al file AndroidManifest.xml:

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

Il collegamento statico ti offre un footprint del codice molto più piccolo, in quanto non devi raggruppare la libreria condivisa libtuningfork.so.

Utilizzo di CMake (solo libreria statica)

Se utilizzi CMake, consulta il file gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt per un esempio di configurazione CMake. Include un file di utilità, gamesdk/samples/gamesdk.cmake, che esegue i controlli finali, aggiunge i percorsi di inclusione del compilatore corretti e genera una destinazione che puoi utilizzare per collegare la libreria.

Per utilizzare questa utilità:

1. Includi questo file nel tuo file CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Chiama la funzione add_gamesdk_target con la cartella contenente gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. Nel file target_link_libraries della tua libreria nativa, aggiungi tuningfork come dipendenza (e swappy se hai integrato la libreria Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

Per un utilizzo avanzato di CMake, consulta il file di origine gamesdk.cmake.