Ci sono due modi per incorporare la Raccolta di oboe nel tuo progetto.
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.
Aggiungi la dipendenza
oboe
alla sezionedependencies
. Se necessario, sostituisci1.5.0
con la versione stabile più recente di Oboe:dependencies { implementation 'com.google.oboe:oboe:1.5.0' }
Attiva l'opzione
prefab
nella sezionebuildFeatures
.android { buildFeatures { prefab true } }
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.
Aggiungi il seguente comando
find_package
:find_package (oboe REQUIRED CONFIG)
Aggiungi
oboe::oboe
all'elenco delle librerie passate al comandotarget_link_libraries
associato all'eseguibile principale.
Integrare l'SDK Android Game
Scarica la libreria e controllala nel tuo sistema di controllo del codice sorgente.
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:
- Aggiungi
gamesdk/include
al percorso di inclusione del compilatore. 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
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:
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.
Aggiungi un percorso del seguente modulo nei percorsi della libreria dei linker:
gamesdk/libs/architectureAPIapiLevelNDKndkVersion_stlVersion_Release/lib/oboe
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:
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")
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)
In
target_link_libraries
per la libreria nativa, aggiungioboe
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.