User Tools

Site Tools


development:compiling:porting

This is an old revision of the document!


Porting guidelines

EasyRPG Player is quite portable application but you will probably encounter some problems in your porting adventure. This article will sum up the common pitfalls you will encounter:

Library porting

EasyRPG needs at least the following libraries.

  • liblcf (see next section)
  • freetype
  • pixman
  • libpng
  • zlib

More dependencies are required when you use the SDL2 backend. This will be explained later.

Cross compiling is usually straight forward for any library via the typical commands:

./configure –prefix=$PREFIX –host=$TARGET_HOST –disable-shared –enable-static && make && make install

zlib is an exception:

CHOST=$TARGET_HOST ./configure –static –prefix=$PREFIX

You should in general know how to do this and fill $PREFIX and $TARGET_HOST with the correct values. Otherwise this article is not suitable for you ;)

pixman supports fast code paths for many platforms. If your platform supports any SIMD you should turn on the appropriate flags during compile time (check the help output).

Porting liblcf

liblcf is the parser for RPG Maker 2000/2003 files. Make sure the liblcf version matches the same git tag the Player uses (or use the git version if you compile Player from git).

liblcf uses the the following libraries:

  • iconv or ICU
  • expat (optional)

iconv or ICU are required for converting the text strings to Unicode. ICU is recommended over iconv because it supports automatic codepage detection and will make the life of the user much simpler.

Porting ICU

Cross compiling ICU is a bit tricky, get version 56.1 (important!) and do the following steps:

To save 20 MB of library size replace the icudata with ours: icudata

Copy icudt56l.dat into icu/source/data/in/

Duplicate now the folder icu and name it icu-native. The further steps assume now that you have these two folders.

ICU needs a native compilation first because it needs an executable to generate the data lib:

cd icu-native/source ./configure –enable-static –enable-shared=no –enable-tests=no –enable-samples=no –enable-dyload=no –enable-tools –enable-extras=no –enable-icuio=no –with-data-packaging=static make export ICU_CROSS_BUILD=$PWD

Now cross compile ICU:

cd icu/source ./configure –with-cross-build=$ICU_CROSS_BUILD –enable-strict=no –enable-static –enable-shared=no –enable-tests=no –enable-samples=no –enable-dyload=no –enable-tools=no –enable-extras=no –enable-icuio=no –host=$TARGET_HOST –with-data-packaging=static –prefix=$PREFIX make make install

Porting SDL

If the target platform is supported by SDL2 you are lucky. You just compile SDL2 and SDL2_mixer now and you are done.

[to be extended]

development/compiling/porting.1460884059.txt.gz · Last modified: 2016/04/17 09:07 (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki