Sviluppare un gioco per Android – SDL example

Introduzione

In questa puntata vedremo come compilare SDL 2.0 per Android e come eseguire una piccola demo sugli eventi touch. Questo non vuol dire che tutto il lavoro successivo sarà localizzato intorno a lei, piuttosto è solo un esempio per farvi scoprire le potenzialità dell’NDK utilizzando una famosa libreria per scrivere giochi e/o programmi multipiattaforma.

Devo sottolineare il fatto che la libreria utilizzata in questo esempio è ancora sotto intenso sviluppo e non completa (sopratutto per quanto riguarda la nuova documentazione), ma visto che molte funzioni sono simili alla versione 1.2 credo che chi l’ha già utilizzata si troverà a proprio agio. Oltre a questo, chi già avesse seguito gli articoli su pygame, si ritroverà molti dei concetti logici affrontati in quei momenti, visto che si parlava comunque di SDL (ne approfitto per segnalarvi che è stato effettuato anche il porting su Android : http://pygame.renpy.org/).

SDL non è comunque un prodotto troppo acerbo per essere provato, guardate per esempio Negative Space per Android o Eufloria per Windows e iOS; per essere una libreria tutt’ora in costruzione questi due primi prodotti non sembrano niente male (sopratutto Eufloria), quindi penso valga la pena spendere qualche parola, così chi è veramente interessato potrà approfondire a sua discrezione.

La libreria di base comprende la gestione dello schermo, degli eventi e funzioni base per renderizzare sul video oltre ad alcune per gestire il timer.

SDL 2.0

Per prima cosa, controllate di aver già installato mercurial nel vostro pc, così da poter scaricare la libreria dove preferite attraverso il comando apposito da terminale (o cmd per gli utenti windows):

hg clone http://hg.libsdl.org/SDL

Una volta sincronizzata la cartella della libreria procedete come segue :

1. Copiate la cartella nominata android-project dove preferite. Rinominate la cartella a vostro piacimento, visto che sarà il nuovo progetto.
2. All’interno del vostro nuovo progetto copiate tutta la cartella SDL scaricata con mercurial in nomeprogetto/jni.
3. Sostituite dentro la cartella nomeprogetto/jni/SDL/include il file SDL_config.h con SDL_config_android.h . Per farlo potete anche rinominare i file o copiare il contenuto di SDL_config_android.h all’interno di SDL_config.h .
4. Modificate il file local.properties nella cartella del progetto aggiungendo la cartella di installazione del vostro SDK di Android :
   sdk.dir=C:\\Android\\android-sdk
5. Nella cartella jni/src del progetto create un file di nome main.cpp e modificate l’Android.mk presente in questa cartella aggiungendolo nei LOCAL_SRC_FILES al posto di YourSourceHere.c e di $(SDL_PATH)/src/main/android/SDL_android_main.cpp . Riempite il file main.cpp con il codice sottostante.
6. Aggiornate il progetto da linea di comando dopo aver cancellato il file build.xml :
   android update project -t android-10 -p .
7. Successivamente, dopo aver copiato il main che trovate di seguito (se non lo avete ancora fatto), eseguite ndk-build e ant debug install per installarlo sul vostro device o sull’emulatore che dovete rispettivamente collegare o avviare.

Ecco il codice dell’esempio in cpp. Questo non è niente altro che il testgesture.c già presente tra gli esempi SDL nella cartella test, modificato in piccole parti.

Osservazioni

Da notare le ultime fuzioni che estendono quelle già presenti nel sorgente java di SDL che si trova in nomeprogettosrc/org/libsdl/app. In particolare nell’ultima viene fatta l’inizializzazione della libreria tramite il comando SDL_Android_Init . Da quel momento in poi, è possibile utilizzare la libreria SDL in tutte le sue parti (alcune librerie sono esterne e vanno aggiunte al progetto e sono sdl image,mixer,net,rtf e ttf. Per questo esempio non sono necessarie) senza modificare il nostro codice a seconda della piattaforma (il processo di init della libreria può essere differente a seconda dell’OS utilizzato).

Il funzionamento del programma è molto semplice : si collezionano gli eventi che a noi interessano (SDL_FINGERDOWN, SDL_FINGERUP, SDL_MULTIGESTURE, SDL_FINGERMOTION) in un buffer (events) che verrà successivamente analizzato durante la fase di rendering (funzione DrawScreen). A seconda della lunghezza del buffer utilizzata vedremo sullo schermo la storia degli eventi da noi creati, che sono rappresentati creando dei quadrati sul punto in cui è stato effettuato il tocco dello schermo.

Questo test prevede anche l’utilizzo del multigesture, che in questo caso fa ingrandire e rimpicciolire una “figura” a forma di occhio a seconda dei nostri gesti con due dita.

Come potete vedere la struttura del loop è identica a quelle viste nelle guide su pygame, con un ciclo principale ed un altro annidato per gli eventi con i dovuti accorgimenti per gestire i vari input (ricordate che questo file viene utilizzato come test delle librerie, non si sta implementando niente di particolare) .

Conclusioni

Con questa base è possibile aggiungere features come il supporto per openGL ES ed il rendering accelerato. Se avete dei progetti già scritti in SDL potreste provare a riportarli su questo nuovo dispositivo.

Come ho già detto l’articolo è solo a titolo dimostrativo, non approfondirò al momento i molti altri aspetti inerenti a questa libreria. Piuttosto mi premeva il fatto di lasciarvi qualcosa di nuovo tra le mani, anche se è molto difficile andare oltre a semplici dimostrazioni per questioni di tempo.

Alcuni titoli come Doom o Return to castle Wolfenstein per Android utilizzano sempre SDL e visto il recente interesse per videogiochi multipiattaforma credo che sarà sempre più interessante imparare ad utilizzare una libreria del genere.

Sarei curioso di conoscere i vostri pareri riguardo SDL e i traguardi da essa raggiunti. Vi aspetto dunque nei commenti e nei prossimi articoli.