Le seguenti sezioni descrivono come integrare la libreria di Tuning Fork nella strumentochain e come utilizzare le funzioni fornite dalla libreria. La libreria è disponibile come libreria statica o condivisa nelle librerie AGDK.
Dopo aver scaricato l'SDK sulla tua macchina e averlo controllato nel tuo sistema di controllo del codice sorgente, apporta le modifiche elencate nelle sezioni seguenti alle impostazioni della build del tuo progetto.
Prima di iniziare
Devi integrare la libreria del pacing dei frame Android prima di integrare la libreria del diapason. Se lo fai, la libreria di Tuning Fork può registrare automaticamente la durata frame; non è necessario chiamare esplicitamente le funzioni di spunta manualmente.
Per saperne di più, consulta le seguenti guide all'integrazione:
- Integrare il pacing dei frame Android nel renderer OpenGL
- Integrare il pacing dei frame Android nel renderer Vulkan
Libreria statica
Per collegare il tuo progetto alla libreria statica:
- Aggiungi
gamesdk/include
ai percorsi di inclusione del compilatore. Aggiungi un percorso del seguente modulo nei percorsi della libreria dei 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
).Aggiungi
-ltuningfork_static
al comando linker (e-lswappy_static
se hai integrato la libreria di pacing del frame Android).Aggiungi l'autorizzazione
INTERNET
al fileAndroidManifest.xml
:<uses-permission android:name="android.permission.INTERNET" />
Libreria condivisa
I passaggi nella sezione relativa alla libreria statica si collegano in modo statico a una versione della libreria Tuning Fork compilata per la combinazione ABI, livello API, NDK e STL specificata. Se la combinazione non è disponibile per le tue impostazioni, puoi creare un collegamento alla Libreria condivisa:
- Aggiungi
gamesdk/include
ai percorsi di inclusione del compilatore. Aggiungi un percorso del seguente modulo nei percorsi della libreria dei linker:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
Aggiungi
-ltuningfork
al comando linker (e-lswappy
se hai integrato la libreria di pacing del frame Android).Aggiungi l'autorizzazione
INTERNET
al fileAndroidManifest.xml
:<uses-permission android:name="android.permission.INTERNET" />
Il collegamento statico offre un ingombro molto ridotto in quanto non è necessario
unire la libreria condivisa di libtuningfork.so
.
Utilizzare CMake (solo libreria statica)
Se utilizzi CMake, consulta il file gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt
per un esempio di configurazione di CMake. Include un file di utilità, gamesdk/samples/gamesdk.cmake
, che esegue i controlli finali, aggiunge il compilatore appropriato include percorsi e genera una destinazione che puoi utilizzare per collegare la libreria.
Per utilizzare questa utilità, procedi nel seguente modo:
- Includi questo file nel tuo file
CMakeLists.txt
:include("path/to/gamesdk/samples/gamesdk.cmake")
- Richiama la funzione
add_gamesdk_target
con la cartella contenente il gamesdk:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- In
target_link_libraries
per la libreria nativa, aggiungituningfork
come dipendenza (eswappy
se hai integrato la libreria di pacing del frame Android):target_link_libraries(native-lib swappy tuningfork ...)
Per un utilizzo avanzato di CMake, consulta il gamesdk.cmake
file di origine.