🥇 Подготовка на SDL2 проект за стартиране на android

Здравейте на всички. Днес ще разгледаме как да подготвим проект с библиотеката sdl2 за разработка на игра за android.

Първо трябва да изтеглите Android Studio, да я инсталирате и всичко необходимо за разработка в тази среда. Например, аз използвам Kde Neon и в тази система има файл /etc/environment, който съществува и в ubuntu. Там трябва да зададете следните променливи.

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

Също така трябва да изтеглите NDK от официалния сайт, да го разархивирате в домашната директория и да го преименувате на NDK. След това трябва да изтеглите библиотеката SDL2 от сайта libsdl.org. За да използвате sdl2 за android, е важно да не го компилирате за компютър, защото тогава няма да се компилира за android. За да се компилира проектът, трябва да създадете проект в android studio, какъвто и да е, за да приемете лиценза, иначе при компилиране на SDL2 ще поискате лиценз.

За да четете файлове в android от assets, трябва да използвате функции SDL_RWops. Ето пример за използване в код, свързан с шрифта. В този случай не можем да използваме FT_New_Face, а вместо това ще използваме FT_New_Memory_Face, за да използваме вече прочетените данни.

#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

Също така създадох файл заглавен файл за включване на заглавията на SDL2. NO_SDL_GLEXT е необходим, за да премине компилацията успешно за 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

И така, проектът е готов, шейдерите са подготвени за Opengl Es 3.0. Сега трябва да създадете android-project. За целта разархивираме архива SDL2. Отиваме в build-scripts и изпълняваме така.

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

Ще се появи такова съобщение.

За да изградите и инсталирате на устройство за тестване, изпълнете следното:
cd /home/cf/programs/SDL2-2.0.10/build/com.xverizex.test
./gradlew installDebug

Отиваме в com.xverizex.test. Влизаме в com.xverizex.test/app/jni/src. Копираме своя проект на играта. И променяме файла Android.mk, в моя случай той изглежда така.

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

# Добавете вашите източникови файлове тук...
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)

Както може би вече сте забелязали, добавям и библиотека Freetype2. Намерих готова версия на github за android, но тя не работеше, трябваше да направя някои корекции. Също така създаваме каталог app/src/main/assets. В него поставяме нашите ресурси (шрифтове, спрайтове, 3D модели).

Сега ще настроим Freetype2 за Android. Изтеглете от моя github Връзка, и копирайте каталога Freetype2 в каталога app/jni/. Всичко е готово. Сега стартирайте в com.xverizex.test командата ./gradlew installDebug. За да може да добавите играта към android, отладката трябва да е включена. За целта, отидете в настройки, отидете в «Система», отидете в «За таблета» и натиснете около шест пъти опцията «Номер на версията». След това се върнете назад и ще се появи опция за разработчици. Влезте и активирайте, също така активирайте опцията «Отладка по USB». Сега трябва да получите ключ за таблета. За целта инсталирайте програмата adb. Стартирайте в конзолата adb shell, и на таблета ще се появи ключ, който трябва да бъде приет. Готово, сега игрите могат да се зареждат на таблета.

Източник: habr.com

Подготовка на SDL2 проект за стартиране на Android