GameActivity   Parte di Android Game Development Kit.

GameActivity è una libreria Jetpack progettata per aiutare i giochi Android a elaborare i comandi del ciclo dell'app, gli eventi di input e l'inserimento di testo nel codice C/C++ dell'applicazione. GameActivity è un discendente diretto di NativeActivity e condivide un'architettura simile:

alt_text

Come illustrato nel diagramma precedente, GameActivity esegue le seguenti funzioni:

  • Interazione con il framework Android tramite il componente lato Java.
  • Passaggio di comandi del ciclo dell'app, eventi di input e testo di input al lato nativo.
  • Modellazione del codice sorgente C/C++ in tre componenti logici:
    • Le funzioni JNI di GameActivity, che supportano direttamente la funzionalità Java di GameActivity e mettono in coda gli eventi in native_app_glue.
    • native_app_glue, che viene eseguito principalmente nel proprio thread nativo (diverso dal thread principale dell'applicazione) ed esegue le attività con il relativo looper.
    • Il codice di gioco dell'applicazione, che esegue il polling e l'elaborazione degli eventi in coda all'interno di native_app_glue ed esegue il codice di gioco all'interno del thread native_app_glue.

Con GameActivity, puoi concentrarti sullo sviluppo del gioco principale ed evitare di dedicare troppo tempo al codice JNI.

Se hai già familiarità con NativeActivity, le principali differenze tra GameActivity e NativeActivity sono le seguenti:

  • GameActivity viene visualizzato in un SurfaceView, il che semplifica notevolmente l'interazione dei giochi con altri componenti della UI.
  • Per gli eventi di input tramite tocco e tasto, GameActivity ha un'implementazione completamente nuova con l'interfaccia android_input_buffer, separata da InputQueue utilizzata da NativeActivity.
  • GameActivity è una classe derivata di AppCompatActivity, che ti consente di utilizzare senza problemi altri componenti Jetpack. ActionBar, Fragment e altri sono tutti disponibili.
  • GameActivity aggiunge la funzionalità di inserimento di testo integrando la libreria GameTextInput.
  • Le app derivate da GameActivity devono creare tutte e tre le parti del codice C/C++ in un'unica libreria. D'altra parte, le funzioni JNI di NativeActivity fanno parte del framework (vengono sempre caricate dal sistema operativo). Pertanto, solo native_app_glue e il codice C/C++ dell'applicazione devono essere integrati in un'unica libreria.
  • NativeActivity fa parte del framework Android e segue il suo ciclo di rilascio (in genere annuale). GameActivity fa parte della libreria Jetpack, che ha un ciclo di rilascio molto più frequente (in genere ogni due settimane). Le nuove funzionalità e le correzioni di bug possono arrivare molto più rapidamente.

Località di uscita

La libreria GameActivity è disponibile nei seguenti canali:

Il codice C/C++ viene fornito come codice sorgente in tutti i canali di rilascio, utilizzando il formato Prefab. GameActivity versione 1.2.2 aggiunge una libreria statica alla distribuzione. A partire da questa versione, ti consigliamo di utilizzare la libreria statica anziché il codice sorgente.

Contenuti della libreria Jetpack

Con la libreria Jetpack, GameActivity viene rilasciata con un AAR. Questo report AAR contiene i seguenti componenti principali:

  • Un file JAR per il codice Java
  • La libreria statica C/C++ game-activity_static è inclusa in GameActivity versione 1.2.2 e successive.
  • Codice sorgente C/C++ (nella cartella /prefab)

Le istruzioni di integrazione collegate a questa pagina presuppongono che tu possa utilizzare Prefab nel tuo sistema di build; in caso contrario, puoi copiare il codice sorgente pacchettizzato nella cartella prefab/modules/game-activity/include nel tuo sistema di build ed eseguire i passaggi di integrazione necessari. Una struttura di file simile esiste per le release in androidx per la libreria Android Jetpack. Per impostazione predefinita, gradle decomprime gli AAR nella directory della cache (~/.gradle/caches/…). Puoi trovare il codice sorgente C/C++ cercando prefab/modules/game-activity/include e selezionando la posizione nella versione di release prevista.

Per istruzioni sull'integrazione utilizzando la libreria Jetpack, consulta Inizia a utilizzare GameActivity.

Contenuti del codice sorgente AOSP

AOSP contiene sempre il codice sorgente più recente. Segui le istruzioni di build per creare le tue release o integrare direttamente l'origine nel tuo ambiente di build. Il codice sorgente C/C++ viene salvato in una struttura di file simile alla libreria Jetpack.

Guide all'integrazione

Segui queste guide per integrare GameActivity nelle tue applicazioni:

Risorse aggiuntive

Per scoprire di più su GameActivity, consulta le seguenti risorse:

Feedback

Per segnalare bug o richiedere nuove funzionalità per GameActivity, utilizza l'Issue Tracker di GameActivity.