Падрыхтоўка 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

Зьявіцца такое паведамленьне.

To build and install to a device for testing, run the following:
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

# Add your application source files here...
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 гэтую гульню, у android павінна быць уключана адладка. Для гэтага трэба перайсці ў налады, перайсці ў "Сістэма", перайсці ў "Аб планшэце" і націснуць каля шасці разоў опцыю "Нумар зборкі". Потым перайсці назад і з'явіцца опцыя для распрацоўшчыкаў. Заходзім і ўключаем, таксама ўключаем опцыю "Адладка па USB". Цяпер трэба атрымаць ключ для планшэта. Для гэтага які ўсталёўваецца праграму adb. Запускаем у кансолі adb shell, і ў планшэце з'яўляецца ключ, які трэба прыняць. Усё, зараз гульні можна загружаць на планшэт.

Крыніца: habr.com

Дадаць каментар