Förberedelse av SDL2-projekt för att köras på android

Hej alla. Idag ska vi titta på hur man förbereder ett projekt med hjälp av sdl2-biblioteket för att köra ett spel på Android.

Först måste vi ladda ner Android Studio, installera den och allt som krävs i denna utvecklingsmiljö. Till exempel har jag just nu Kde Neon, och i detta system finns en fil /etc/environment, samma fil finns även i ubuntu. Där måste vi ange följande variabler.

ANDROID_HOME=/home/username/Android/Sdk
ANDROID_NDK_HOME=/home/username/ndk

Vi måste också ladda ner NDK från den officiella webbplatsen, packa upp den i hemkatalogen och döpa om den till NDK. Därefter behöver vi ladda ner sdl2-biblioteket från sidan libsdl.org. För att använda sdl2 för Android är det viktigt att inte kompilera det för datorn, eftersom det då inte kommer att kompileras för Android. För att projektet ska kompilera måste vi skapa ett projekt i Android Studio, vilket som helst, för att godkänna licensen, annars kommer SDL2 att begära en licens vid kompilering.

För att läsa filer i Android från assets behöver vi använda SDL_RWops-funktioner. Här är ett exempel på användning i kod som arbetar med typsnitt. I detta fall kan vi inte använda FT_New_Face, utan istället kommer vi att använda FT_New_Memory_Face för att använda redan lästa data.

#ifdef __ANDROID__
        snprintf ( path, 254, "fonts/%s", file );
        SDL_RWops *rw = SDL_RWFromFile(path, "r" );
        char *memory = ( char * ) calloc ( rw->hidden.androidio.size, 1 );
        SDL_RWread(rw, memory, 1, rw->hidden.androidio.size );

        FT_New_Memory_Face(*this->ft_library, ( const FT_Byte  * )memory, rw->hidden.androidio.size, 0, &this;->face );
        SDL_RWclose(rw);
        free ( memory );
#else
        snprintf ( path, 254, "%s/fonts/%s", DEFAULT_ASSETS, file );
        if ( access ( path, F_OK ) ) {
                fprintf ( stderr, "not found font: %sn", path );
                exit ( EXIT_FAILURE );
        }
        struct stat st;
        stat ( path, &st; );
        FILE *rw = fopen ( path, "r" );
        char *memory = ( char * ) calloc ( st.st_size, 1 );
        fread ( memory, 1, st.st_size, rw );

        FT_New_Memory_Face ( *this->ft_library, ( const FT_Byte * ) memory, st.st_size, 0, &this;->face );
        fclose ( rw );
        free ( memory );
#endif

Jag har också skapat en headerfil för att inkludera SDL2-rubriker. NO_SDL_GLEXT behövs för att kompileringen ska lyckas för Android.

#ifdef __ANDROID__
#include "SDL.h"
#include "SDL_video.h"
#include "SDL_events.h"
#define NO_SDL_GLEXT 
#include "SDL_opengl.h"
#include "SDL_opengles2.h"
#else
#include <SDL2/SDL.h>
#include <SDL2/SDL_video.h>
#include <SDL2/SDL_opengl.h>
#include <SDL2/SDL_opengles2.h>
#endif

Så projektet är klart, shaderarna är klara för OpenGL ES 3.0. Nu måste vi skapa android-projektet. För detta packar vi upp SDL2-arkivet. Vi går in i build-scripts. Och kör så här.

./androidbuild.sh com.xverizex.test main.cpp

Ett meddelande som detta kommer att visas.

För att bygga och installera på en enhet för testning, kör följande:
cd /home/cf/programs/SDL2-2.0.10/build/com.xverizex.test
./gradlew installDebug

Vi går till com.xverizex.test. Gå in i com.xverizex.test/app/jni/src. Kopiera ditt spelprojekt. Och ändra filen Android.mk, i mitt fall ser den ut så här.

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := main

SDL_PATH := ../SDL
FREETYPE_PATH := ../Freetype2

LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include $(LOCAL_PATH)/$(FREETYPE_PATH)/include

# Lägg till dina applikationskällfiler här...
LOCAL_SRC_FILES := ./engine/lang.cpp ./engine/actor.cpp ./engine/sprite.cpp ./engine/shaders.cpp ./engine/box.cpp ./engine/menubox.cpp ./engine/load_manager.cpp ./engine/main.cpp ./engine/font.cpp ./engine/model.cpp ./engine/button.cpp ./theme.cpp ./level_manager.cpp ./menu/menu.cpp

LOCAL_SHARED_LIBRARIES := SDL2 Freetype2

LOCAL_LDLIBS := -lGLESv1_CM -lGLESv2 -llog 

include $(BUILD_SHARED_LIBRARY)

Som du kanske redan har noterat, inkluderar jag även biblioteket Freetype2. Jag hittade en färdig version på github för android, men den fungerade inte, något behövde ändras. Skapa också katalogen app/src/main/assets. Dit lägger vi våra resurser (typsnitt, sprites, 3D-modeller).

Nu konfigurerar vi Freetype2 för Android. Ladda ner från min github. Länk, och kopiera katalogen Freetype2 till katalogen app/jni/. Allt är klart. Nu kör vi kommandot ./${client_name}.installDebug i com.xverizex.test. För att kunna lägga till spelet i android måste debug-läget aktiveras. Gå till inställningarna, välj 'System', gå till 'Om surfplattan' och tryck ungefär sex gånger på alternativet 'Byggnummer'. Gå tillbaka och ett alternativ för utvecklare kommer att visas. Gå in där och aktivera den samt aktivera alternativet 'USB-debbugering'. Nu måste vi få en nyckel för surfplattan. För detta installerar vi programmet adb. Starta adb shell i konsolen, och en nyckel dyker upp på surfplattan som måste accepteras. Klart, nu kan spel laddas ner till surfplattan.

Källa: habr.com