Aggiornare le impostazioni della build

Le sezioni seguenti descrivono come integrare la libreria di 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 sulla tua macchina e averlo verificato nel sistema di controllo del codice sorgente, apporta le modifiche elencate nelle sezioni seguenti alle impostazioni di build del tuo progetto.

Prima di iniziare

Dovresti integrare la libreria del pacing dei frame Android prima di integrare la libreria del diapason di ottimizzazione. Se lo fai, la libreria di Tuning Fork può registrare automaticamente la durata frame; non è necessario chiamare esplicitamente le funzioni di spunta personalmente.

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:

1. Aggiungi gamesdk/include al percorso di inclusione del compilatore.

2. 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).

3. Aggiungi -ltuningfork_static al comando del linker (e -lswappy_static se hai integrato la libreria di pacing dei frame Android).

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

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

Libreria condivisa

I passaggi nella sezione relativa alla libreria statica collegano in modo statico a una versione della libreria di 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:

1. Aggiungi gamesdk/include al percorso di inclusione del compilatore.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Aggiungi -ltuningfork al comando del linker (e -lswappy se hai integrato la libreria di pacing dei frame Android).

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

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

Il collegamento statico offre un ingombro di codice molto più ridotto, in quanto non è necessario 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 di CMake. Include un file di utilità, gamesdk/samples/gamesdk.cmake, che esegue i controlli finali, aggiunge il compilatore appropriato include i percorsi e genera una destinazione che puoi usare per collegare la libreria.

Per utilizzare questa utilità:

1. Includi nel tuo file CMakeLists.txt questo file: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Richiama la funzione add_gamesdk_target con la cartella contenente il gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. In target_link_libraries per la tua libreria nativa, aggiungi tuningfork come dipendenza (e swappy se hai integrato la libreria di pacing dei frame Android): target_link_libraries(native-lib swappy tuningfork ...)

Nota: il percorso dell'SDK per il gioco utilizzato per include e add_gamesdk_target può essere assoluto (ad esempio /home/yourusername/gamesdk o C:\Android\gamesdk) o relativo al file CMakeLists.txt.

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