Le seguenti sezioni descrivono come integrare la libreria Tuning Fork nella tua toolchain e come usare le funzioni fornite dalla libreria. La è disponibile come libreria statica o condivisa nelle librerie AGDK.
Dopo aver scaricato l'SDK sul tuo computer nel tuo sistema di controllo del codice sorgente, apporta le modifiche elencate le seguenti sezioni alle impostazioni di build del progetto.
Prima di iniziare
Dovresti integrare la libreria Android Frame Pacing. prima di integrare la libreria Tuning Fork. In questo caso, La libreria Tuning Fork può registrare automaticamente la durata dei frame; non c'è devi chiamare in modo esplicito le funzioni di spunta.
Per saperne di più, consulta le seguenti guide all'integrazione:
- Integrare il pacing frame Android nel renderer OpenGL
- Integrare il pacing frame Android nel renderer Vulkan
Libreria statica
Per collegare il tuo progetto alla libreria statica, segui questi passaggi:
- Aggiungi
gamesdk/include
ai percorsi di inclusione del compilatore. Aggiungi un percorso del modulo seguente nei percorsi della libreria di linker:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
Cerca in
gamesdk/libs
e scegli quello più adatto alla tua toolchain (per esempio,gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
).Aggiungi
-ltuningfork_static
al comando linker (e-lswappy_static
se hai integrato la libreria Android Frame Pacing).Aggiungi l'autorizzazione
INTERNET
al tuo fileAndroidManifest.xml
:<uses-permission android:name="android.permission.INTERNET" />
Libreria condivisa
Collega in modo statico i passaggi nella sezione Libreria statica rispetto a una versione della libreria Tuning Fork compilata per l'ABI specificata, Combinazione di livello API, NDK e STL. Se la combinazione non è disponibile per le tue impostazioni, puoi collegarti alla libreria condivisa con questi link:
- Aggiungi
gamesdk/include
ai percorsi di inclusione del compilatore. Aggiungi un percorso del modulo seguente nei percorsi della libreria di linker:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
Aggiungi
-ltuningfork
al comando linker (e-lswappy
se hai integrato la libreria Android Frame Pacing).Aggiungi l'autorizzazione
INTERNET
al tuo fileAndroidManifest.xml
:<uses-permission android:name="android.permission.INTERNET" />
Il collegamento statico ti offre un ingombro di codice molto ridotto in quanto non è necessario
Raggruppare la libreria condivisa libtuningfork.so
.
Utilizzo di CMake (solo libreria statica)
Se utilizzi CMake, consulta
gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt
file per vedere un esempio
CMake della configurazione. Include un file di utilità,
gamesdk/samples/gamesdk.cmake
, che esegue i controlli finali, aggiunge i token corretti
il compilatore include percorsi e genera una destinazione che puoi utilizzare per collegare
libreria.
Per utilizzare questa utilità, procedi nel seguente modo:
- Includi questo file nel file
CMakeLists.txt
:include("path/to/gamesdk/samples/gamesdk.cmake")
- Richiama la funzione
add_gamesdk_target
con la cartella contenente gamesdk:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- In
target_link_libraries
per la tua libreria nativa, aggiungituningfork
come (eswappy
se hai integrato il pacing del frame Android libreria):target_link_libraries(native-lib swappy tuningfork ...)
Per un utilizzo avanzato di CMake, consulta il file di origine gamesdk.cmake
.