SYMBIAN: Update symbian/README

This commit is contained in:
Fiodar Stryzhniou 2021-08-01 18:55:03 +03:00 committed by Eugene Sandulenko
parent 09645004ec
commit 70db437f0d

View File

@ -1,11 +1,11 @@
ScummVM - ScummVM ported to EPOC/SymbianOS
Copyright (C) 2008-2021 ScummVM Team
Copyright (C) 2013-2020 Fedor Strizhniou aka zanac
Copyright (C) 2013-2021 Fiodar Stryzhniou aka zanac
Copyright (C) 2003-2013 Lars 'AnotherGuest' Persson
Copyright (C) 2002-2008 Jurgen 'SumthinWicked' Braam
Copyright (C) 2003-2005 Andreas 'Sprawl' Karlsson
Using parts of snprintf.c by
@ -18,83 +18,90 @@ the "GNU General Public License" can be chosen at your discretion.
The chosen license then applies solely and in its entirety.
Both licenses come with this Kit."
About ScummVM
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/SVN, with additional helpful tools for Symbian OS
Jurgen and Lars have successfully transfered all needed changes into CVS/SVN, with additional helpful tools for Symbian OS.
Current port maintained by Fiodar Stryzhniou.
Release History:
Release version: 2.2.0
* Symbian port now split in five parts, ScummVM 1, ScummVM and so on to keep the exe size down.
For engines layout see ScummVM in OS help menu
Release version: 1.7.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
Release version: 2.3.0
* Symbian port now split in nine parts, ScummVM 1, ScummVM and so on to keep the exe size amd memory pressure down.
For engines layout see ScummVM in OS help menu.
* Git builds (not frequently updated) can be found at https://sourceforge.net/projects/scummvms60git/
Release version: 1.6.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
Release version: 2.2.0.1
* Symbian port now split in five parts, ScummVM 1, ScummVM and so on to keep the exe size down.
For engines layout see ScummVM in OS help menu.
Release version: 1.7.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
Release version: 1.6.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
Release version: 1.5.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
Release version: 1.4.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
* See main readme for general ScummVM improvements, major update
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
* See main readme for general ScummVM improvements, major update.
Release version: 1.3.1
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
* See main readme for general ScummVM improvements, major update
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
* See main readme for general ScummVM improvements, major update.
Release version: 1.3.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
* See main readme for general ScummVM improvements, major update
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
* See main readme for general ScummVM improvements, major update.
Release version: 1.2.1
* Symbian port now split in two parts, ScummVM 1 and ScummVM 2 to keep the exe size down.
ScummVM 1 contains the following engines:
scumm queen groovie saga drascula
touche parallaction cine
cruise made tucker
scumm, queen, groovie, saga, drascula, touche,
parallaction, cine, cruise, made, tucker.
ScummVM 2 contains the following engines:
agos sky gob
kyra lure agi tinsel
sword1 sword2 draci sci teenagent
agos, sky, gob, kyra, lure, agi, tinsel, sword1, sword2, draci, sci, teenagent.
* See main readme for general ScummVM improvements, minor update.
* See main readme for general ScummVM improvements, minor update
Release version: 1.2.0
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used)
* See main readme for general ScummVM improvements, major update
* Nothing significant in the Symbian port, except SDL improvements (new SDL version used).
* See main readme for general ScummVM improvements, major update.
Release version: 1.1.0
* Nothing significant in the Symbian port, except SDL improvements.
* See main readme for general ScummVM improvements, minor update
* See main readme for general ScummVM improvements, minor update.
Release version: 1.0.0
* Nothing significant in the Symbian port, except SDL improvements.
* See main readme for general ScummVM improvements, minor update
* See main readme for general ScummVM improvements, minor update.
Release version: 0.13.1
* Nothing significant in the Symbian port, except SDL improvements.
* See main readme for general ScummVM improvements, minor update
* See main readme for general ScummVM improvements, minor update.
Release version: 0.13.1
* Nothing significant in the Symbian port, except SDL improvements
* Nothing significant in the Symbian port, except SDL improvements.
Release version: 0.13.0
* Nothing significant in the Symbian port, except SDL improvements
* Nothing significant in the Symbian port, except SDL improvements.
Release version: 0.12.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.13 (previous version used was 1.2.2)
* Information about S60 devices can be found here https://wiki.scummvm.org/index.php/SymbianOS_S60
* Information about UIQ devices can be found here https://wiki.scummvm.org/index.php/SymbianOS_UIQ
* Best source of general information is the ScummVM forum, https://forums.scummvm.org
* SVN builds (not frequently updated) can be found at http://www.anotherguest.se
* Updated to SDL version 1.2.13 (previous version used was 1.2.2).
* Information about S60 devices can be found here https://wiki.scummvm.org/index.php/SymbianOS_S60.
* Information about UIQ devices can be found here https://wiki.scummvm.org/index.php/SymbianOS_UIQ.
* Best source of general information is the ScummVM forum, https://forums.scummvm.org.
* SVN builds (not frequently updated) can be found at http://www.anotherguest.se.
Games supported
---------------
The Symbian port of ScummVM supports all games. Some games might not run properly due to screenresolution or memory constraints.
Minimum free memory requirement is about 12MB to be able to start and run ScummVM, this is enough for most older games, but newer more resource hungry games, might require more.
Minimum free memory requirement is about 12MB to be able to start and run ScummVM, this is enough for most older games,
but newer more resource hungry games, might require more.
Building ScummVM
---------------------
@ -105,6 +112,9 @@ Building ScummVM
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:
- GCC 5.x and above for best perfomance(UIQ 3 and S60v3). Build it by yourself.
https://github.com/fedor4ever/GCC-4-Symbian/tree/master
- UIQ 3.x SDK (To build for UIQ3 devices)(Build scripts in SDK need tweaking in order to build scummvm since Symbian OS GCCE never builds as large projects as ScummVM before)
- UIQ 2.1 SDK (To build for UIQ2 devices);
http://www.symbian.com/developer/sdks_uiq.asp
@ -118,6 +128,12 @@ Building ScummVM
- ECompXL, an EPOC application compression library
http://www.yipton.demon.co.uk/ecompxl/latest/readme.html (To build for UIQ devices)
- Python 2.7
https://www.python.org/downloads/
- required libraries can be found here
https://sourceforge.net/projects/scummvms60git/files/libs/
- libsdl, Simple Directmedia Layer, a cross-platform multimedia library
http://www.libsdl.org/ (see note about ESDL below)
@ -126,7 +142,6 @@ Building ScummVM
- zlib, a massively spiffy yet delicately unobtrusive compression library
http://www.zlib.net/
- latest version of active perl (included with Symbian SDK does not work with the build scripts)
- libogg, the free media file container format
http://www.xiph.org/ogg/
@ -136,7 +151,11 @@ Building ScummVM
These are probably too heavy-duty for your phone:
- flac, the Free Lossless Audio Codec
http://flac.sourceforge.net/
https://xiph.org/flac/
- theora
https://www.theora.org/
- mpeg2
https://libmpeg2.sourceforge.io/
Compiling ScummVM
-----------------
@ -151,33 +170,13 @@ Building ScummVM
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.
SDL: the latest version of SDL at this point in time is 1.2.13. 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
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
will create the epoc dir. In <DevRoot>/libmad/epoc/ go:
> bldmake bldfiles
> abld build
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
you want to build.
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.
In <DevRoot>\scummvm\backends\platform\symbian\ :
run build_me.py
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!
transfer the SCUMMVM.APP/Scummvm.EXE file directly to your !:\system\apps\ScummVM\ dir! (pre Symbian 9 only)
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: