Android+SDL: Будь мужиком, пиши на C!

Я люблю C.
Я любою джаву не меньше, но это совсем не то чувство первой любви, которое я испытываю к C.

Я никогда не работал с SDL, но мне кажется, что он очень удобен для написания игр. По крайней мере я бы купился на его кросс-платформенность. Тем более, что теперь в списке его платформ еще и Android.

Установка

Я использовал версию из репозитория (SDL 2.0):

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

Далее необходимо несколько изменить структуру папок, чтобы получился Android-проект.

1) Копируем папку SDL/android-project в, скажем, sdl-demo (это наша папка с SDL проектом)
2) Копируем саму папку SDL в sdl-demo/jni (получаем sdl-demo/jni/SDL)
3) Редактируем jni/src/Android.mk, заменив YourSourceHere.c на список файлов вашего проекта (для простоты — только main.c)
4) Создадим этот самый main.c (путь к нему: sdl-demo/jni/src/main.c).
5) Теперь native-часть нашего проекта должна собираться.

Вот как это было у меня:

$ cp -r SDL/android-project sdl-demo
$ cp -r SDL sdl-demo/jni
$ sed -i 's/YourSourceHere.c/main.c/' sdl-demo/jni/src/Android.mk
$ cat > sdl-demo/jni/src/main.c << EOF
int SDL_main(int argc, char *argv[]) {
  return 0;
}
EOF
$ cd sdl-demo/jni
$ ndk-build
Compile thumb  : SDL2 <= SDL_error.c
Compile thumb  : SDL2 <= SDL_assert.c
Compile thumb  : SDL2 <= SDL_log.c
Compile thumb  : SDL2 <= SDL.c
....
Compile thumb  : SDL2 <= SDL_androidkeyboard.c
StaticLibrary  : libstdc++.a
SharedLibrary  : libSDL2.so
Install        : libSDL2.so => libs/armeabi/libSDL2.so
Compile++ thumb  : main <= SDL_android_main.cpp
Compile thumb  : main <= main.c
SharedLibrary  : libmain.so
Install        : libmain.so => libs/armeabi/libmain.so

Доработать напильником

И хотя libSDL готова, этого еще недостаточно чтобы заставить ее работать под Android. Дело в том, что SDL для Android — это кружево из native-функций, и все они вызываются из Java-класса SDLActivity (см. sdl-demo/src/org/libsdl/app/SDLActivity.java).

Так вот, общая схема работы такая: запустить отдельный поток, а в нем SDL_main().
А после выхода из SDL_main().. не делать ничего. Хотя, логично было бы завершить Activity.

Это можно сделать руками. В просто случае это runOnUiThread()+finish(). Но я сделал через статические методы, по аналогии с COMMAND_CHANGE_TITLE:

static int COMMAND_CHANGE_TITLE = 1;
static int COMMAND_QUIT = 2; // <-- НАША КОМАНДА: ЗАВЕРШИТЬ ACTIVITY
...
Handler commandHandler = new Handler() {
        public void handleMessage(Message msg) {
            if (msg.arg1 == COMMAND_CHANGE_TITLE) {
                setTitle((String)msg.obj);
            } else if (msg.arg1 == COMMAND_QUIT) { // <-- ДОБАВИМ НАШУ КОМАНДУ
		finish(); 
            }
        }
};
...
public static void finishActivity() {
        mSingleton.sendCommand(COMMAND_QUIT, null); // <-- ОБЕРТКА ДЛЯ ВЫЗОВА COMMAND_QUIT
}
...
class SDLMain implements Runnable {
    public void run() {
        // Runs SDL_main()
        SDLActivity.nativeInit();
        SDLActivity.finishActivity(); // <-- ДОБАВИМ ВЫЗОВ finishActivity
        //Log.v("SDL", "SDL thread terminated");
    }
}
...

Понимаете о чем я?

Теперь можно обновить проект, если надо, и собрать его целиком:

$ android update project <ваши опции, напр. -t 1 -p .>
$ ant debug

Пример

Теперь вы можете писать приложения на SDL в main.c. Вот что получилось у меня:

#include "SDL.h"
#include <android/log.h>

#define LOG(...) __android_log_print(ANDROID_LOG_DEBUG, "sdldemo", __VA_ARGS__)

int SDL_main(int argc, char *argv[]) {
	SDL_Window *window = NULL;
	SDL_Renderer *renderer = NULL;
	SDL_Texture *bitmapTex = NULL;
	SDL_Surface *bitmapSurface = NULL;

	int running = 1;

	LOG("started");

	SDL_Init(SDL_INIT_VIDEO);

	window = SDL_CreateWindow("SDL Hello World",
			SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
			640, 480, SDL_WINDOW_SHOWN);

	renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);

	bitmapSurface = SDL_LoadBMP("data/test.bmp");
	bitmapTex = SDL_CreateTextureFromSurface(renderer, bitmapSurface);
	SDL_FreeSurface(bitmapSurface);

	while (running) {
		SDL_Event event;

		SDL_RenderClear(renderer);
		SDL_RenderCopy(renderer, bitmapTex, NULL, NULL);
		SDL_RenderPresent(renderer);

		while (SDL_PollEvent(&event)) {
			if (event.type == SDL_KEYDOWN && 
				event.key.keysym.scancode == SDL_SCANCODE_AC_BACK) {
				LOG("pressed back button, terminating");
				running = 0;
			}
		}
	}

	LOG("finished");

	SDL_DestroyTexture(bitmapTex);
	SDL_DestroyRenderer(renderer);
	SDL_DestroyWindow(window);
	SDL_Quit();
	return 0;
}

Данный пример я по кускам спёр в разных уголках интернета, но в целом он понятен: создали окно (640х480 — это логические размеры, физические берутся из onSurfaceChanged()). Потом делаем рендерер, и загружаем текстуру. Текстура загружается из «assets/data/test.bmp».

Затем в цикле рисуем текстуру с помощью рендерера, и ждем следующего события. Особым образом обрабатываем нажание на кнопку «Back» — завершаем наш цикл. А потом чистим все ресурсы.

Итоги

Собираем, запускаем. На телефоне выглядит примерно так:

SDL для Android: наш hello world

Теперь можно учить SDL и писать игры. Хотя путь еще долгий — хочется SDL_ttf, SDL_image, чтобы работать с комфортом. Но это уже совсем другая история.

Кстати, overhead от использования SDL ни много ни мало — 200-300 Кб.

Все исходники (около 6 мегабайт, SDL много весит, и так удалил тесты и папку контроля версий): https://rapidshare.com/files/4157028483/sdl-android.tar.gz
Лучше, пожалуй, какой-то скрипт для развертывания SDL-проекта написать.

UPD: Ссылка на rapidshare безнадежно устарела. Сделал заново по инструкциям для свежего SDL: https://dl.dropboxusercontent.com/u/5689099/sdl-demo.tar.gz