Aggiorna le impostazioni di build per Oboe

Ci sono due modi per incorporare la Raccolta di oboe nel tuo progetto.

• Integrare Oboe con Gradle e CMake

• Scarica l'SDK Android Game e integra Oboe manualmente

Integrare Oboe con Gradle e CMake

Queste istruzioni sono per i progetti che utilizzano il plug-in Android per Gradle versione 4.1.0 o successive con dipendenze native con CMake.

Se il tuo progetto utilizza la versione 4.0 del plug-in Android per Gradle o ndk-build anziché CMake, la procedura è leggermente diversa. Vedi Utilizzo delle dipendenze native.

Aggiorna build.gradle

Per aggiungere Oboe alla tua app mentre utilizzi il plug-in Android per Gradle 4.1.0 o versioni successive, aggiungi le seguenti aggiunte al file build.gradle dell'app.

1. Aggiungi la dipendenza oboe alla sezione dependencies. Se necessario, sostituisci 1.5.0 con la versione stabile più recente di Oboe:

   dependencies {
       implementation 'com.google.oboe:oboe:1.5.0'
   }
   

2. Attiva l'opzione prefab nella sezione buildFeatures.

   android {
       buildFeatures {
           prefab true
       }
   }
   

3. Configura l'app per l'utilizzo dello STL condiviso:

   android {
       defaultConfig {
           externalNativeBuild {
               cmake {
                   arguments "-DANDROID_STL=c++_shared"
               }
           }
       }
   }
   

Aggiorna CMakeLists.txt

Per aggiungere Oboe sono necessarie due aggiunte al file CMakeLists.txt dell'app.

1. Aggiungi il seguente comando find_package:

   find_package (oboe REQUIRED CONFIG)
   

2. Aggiungi oboe::oboe all'elenco delle librerie passate al comando target_link_libraries associato all'eseguibile principale.

Integrare l'SDK Android Game

1. Scarica la libreria e controllala nel tuo sistema di controllo del codice sorgente.

2. Apporta le seguenti modifiche alle impostazioni di build del tuo progetto.

Libreria statica

Quando esegui l'integrazione con l'SDK Android Game, ti colleghi in modo statico a una versione della libreria Oboe compilata per la combinazione ABI, livello API, NDK e STL specificata:

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
   

   Ad esempio: gamesdk/libs/arm64-v8a_API24_NDK18_cpp_static_Release

3. Aggiungi -loboe_static al comando del linker.

Non è necessario raggruppare la libreria condivisa liboboe.so, il che significa che i collegamenti statici hanno un ingombro di codice molto ridotto.

Libreria condivisa

Se la combinazione ABI, livello API, NDK e STL richiesta per una libreria statica non è disponibile per le tue impostazioni, puoi eseguire il collegamento alla libreria condivisa:

1. Segui i passaggi 1 e 2 della sezione precedente (Informazioni sulla libreria statica) per aggiornare il percorso di inclusione del compilatore e utilizzare il file di intestazione appropriato.

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

   gamesdk/libs/architectureAPIapiLevelNDKndkVersion_stlVersion_Release/lib/oboe
   

3. Add -loboe -lOpenSLES to your linker command.

Using CMake (static library only)

If you're using CMake, see the gamesdk/samples/bouncyball/app/CMakeLists.txt file in the downloaded SDK for an example CMake configuration. It includes a utility file called gamesdk/samples/gamesdk.cmake, which performs final checks, adds the proper compiler include paths, and generates a target that you can use to link the library.

To use the gamesdk.cmake utility:

1. Include this file in your CMakeLists.txt:

   // Use a relative or absolute path. For example, /home/yourusername/gamesdk
   // or C:\Android\gamesdk.
   include("path/to/gamesdk/samples/gamesdk.cmake")
   

2. Richiama la funzione add_gamesdk_target con la cartella contenente l'SDK del gioco:

   // Use a relative or absolute path.
   add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
   

3. In target_link_libraries per la libreria nativa, aggiungi oboe come dipendenza:

   // The casing of OpenSLES is important.
   target_link_libraries(native-lib oboe OpenSLES ...) 
   

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

Passaggi successivi: usare l'oboe

Per riprodurre o registrare audio con l'oboe, crea e attiva uno o più stream audio e utilizza i callback per scambiare l'audio tra i dispositivi di input/output audio e la tua app. Consulta la pagina relativa all'uso di Oboe.