diff options
Diffstat (limited to 'backends/platform/symbian/README')
| -rw-r--r-- | backends/platform/symbian/README | 70 |
1 files changed, 35 insertions, 35 deletions
diff --git a/backends/platform/symbian/README b/backends/platform/symbian/README index 1ed9c6faf6..0f9df338c3 100644 --- a/backends/platform/symbian/README +++ b/backends/platform/symbian/README @@ -1,20 +1,20 @@ ScummVM - ScummVM ported to EPOC/SymbianOS - + Copyright (C) 2003-2005 Andreas 'Sprawl' Karlsson Copyright (C) 2007 Lars 'AnotherGuest' Persson Copyright (C) 2007 Jurgen 'SumthinWicked' Braam Copyright (C) 2007 ScummVM Team - - $Id$ - - + + $Id$ + + About ScummVM -------------- The original ports (uptil 0.7.1) were made by Andreas Karlsson and Lars Persson. The main transition to 0.8.0CVS and all relevant changes were done by Jurgen Braam. Jurgen and Lars have successfully transfered all needed changes into CVS, with additional helpful tools for Symbian OS - + Release version: 0.10.0 * This version is only supported on Symbian OS 9 devices due to compiler constraints for older devices. (That means UIQ3 and S60V3 devices) * Updated to SDL version 1.2.11 (previous version used was 1.2.8) @@ -30,13 +30,13 @@ Games supported Building ScummVM ---------------------- +--------------------- Nescessary components --------------------- Building ScummVM yourself using the UIQ 2.1/Nokia S60 SDK/Nokia S80 SDK/Nokia S90 SDK framework is not an easy task! - Lets just say the framework needs quite some time to set up and takes a while - to get used to. If you choose to continue you will need the following items: + Lets just say the framework needs quite some time to set up and takes a while + to get used to. If you choose to continue you will need the following items: - UIQ 2.1 SDK (To build for UIQ2 devices); http://www.symbian.com/developer/sdks_uiq.asp @@ -49,13 +49,13 @@ Building ScummVM - ECompXL, an EPOC application compression library http://www.yipton.demon.co.uk/ecompxl/latest/readme.html (To build for UIQ devices) - - - libsdl, Simple Directmedia Layer, a cross-platform multimedia library + + - libsdl, Simple Directmedia Layer, a cross-platform multimedia library http://www.libsdl.org/ (see note about ESDL below) - libmad, a high-quality MPEG audio decoder - http://www.underbit.com/products/mad/ - + http://www.underbit.com/products/mad/ + - zlib, a massively spiffy yet delicately unobtrusive compression library http://www.zlib.net/ @@ -63,60 +63,60 @@ Building ScummVM - libogg, the free media file container format http://www.xiph.org/ogg/ - + - libvorbis, the free audio codec http://www.vorbis.com/ - + - flac, the Free Lossless Audio Codec http://flac.sourceforge.net/ - + - libmpeg2, a free MPEG-2 video stream decoder http://libmpeg2.sourceforge.net/ Compiling ScummVM ----------------- - - ECompXL (Only needed for UIQ2): + + ECompXL (Only needed for UIQ2): this is a tool that will compress your executable with GZIP and glue it to a predefined loader app. The app will uncompress your application at runtime and run it without you even knowing it. A really interesting byproduct - of this method is that the general restriction of not having any writeable + of this method is that the general restriction of not having any writeable static data (WSD) for Symbian APP executables no longer applies. This makes the life of an EPOC porter a lot easier! To install this tool you need to add its \bin path to your PATH above the sybmian epocs32\tools path, so that ECompXL's - PETRAN.EXE will be the executable that is started. + PETRAN.EXE will be the executable that is started. - - SDL: the latest version of SDL at this point in time is 1.2.12. This version + + SDL: the latest version of SDL at this point in time is 1.2.12. This version works great for compiling on other platforms. - - zlib: the zlib-x.x.x.tar.gz does not come with UIQ .mpp build files, that's why - I added them for you in epoc-zlib.zip. Extract in <DevRoot>/zlib/ which will + + zlib: the zlib-x.x.x.tar.gz does not come with UIQ .mpp build files, that's why + I added them for you in epoc-zlib.zip. Extract in <DevRoot>/zlib/ which will create the epoc dir. In <DevRoot>/zlib/epoc/ go: > bldmake bldfiles > abld build libmad: the libmad-x.x.x.tar.gz does not come with UIQ .mpp build files, that's - why I added them for you in epoc-libmad.zip. Extract in <DevRoot>/libmad/ which + why I added them for you in epoc-libmad.zip. Extract in <DevRoot>/libmad/ which will create the epoc dir. In <DevRoot>/libmad/epoc/ go: > bldmake bldfiles > abld build - ScummVM: + ScummVM: In <DevRoot>\scummvm\backends\platform\symbian\ go: - a) Edit and update the BuildPackageUpload_LocalSettings.pl for the kind of build (SDK installed etc) and variants + a) Edit and update the BuildPackageUpload_LocalSettings.pl for the kind of build (SDK installed etc) and variants you want to build. - b) Run BuildPackageUpload_AllVersions.pl to build all the targets/variants that you have configured. + b) Run BuildPackageUpload_AllVersions.pl to build all the targets/variants that you have configured. A detailed log will be placed in the symbian folder with Build.err.log and Build.out.log but it also depends on the configuration you select. - - Now you should have yourself a nice ScummVM_xxx.sis installer package in the packages folder for use + + Now you should have yourself a nice ScummVM_xxx.sis installer package in the packages folder for use on your phone. Please note that for development it will be a lot faster if you transfer the SCUMMVM.APP/Scummvm.EXE file directly to your !:\system\apps\ScummVM\ dir! Platforms can be one of: ARMi, ARM4, THUMB, WINS, WINSCW, GCCE. The SE P900 uses the ARMi platform, - which is a combined ARM4/THUMB programming mode. Configurations can be one of: + which is a combined ARM4/THUMB programming mode. Configurations can be one of: UREL or UDEB. @@ -130,11 +130,11 @@ Greetz & such - the entire ScummVM Dev team for making a kicka$$ program - the folks in #scummvm @ irc.freenode.net for their help, confort and support - everybody else who wants to give me 'the look' for not including them here :P - + it's been swell, gotta go now, - + greetz, SumthinWicked & Anotherguest - + |