Experimental support for Symbian S60 3rd edition

git-svn-id: svn://svn.code.sf.net/p/sc2/code/trunk@3064 8092fc87-c524-0410-9efc-e669fe64eaf9
2008-08-31 00:34:29 +00:00
parent 7310148db6
commit 50664a6f71
24 changed files with 939 additions and 60 deletions
@@ -0,0 +1,86 @@
+UQM for Symbian S60 3rd ed.
+===========================
+
+First some general notes. These instructions might be somewhat incomplete or
+unclear. If you encounter any problems or have suggestions how to improve this
+document, please report them to our Bugzilla at
+   http://bugs.uqm.stack.nl/
+   
+UQM's Symbian support is currently at experimental stage and is tested only on
+Nokia N73, which has too little memory to run it reliably for long time.
+Reports of successes and failures on other devices are very welcome.
+
+Known problems:
+- No OGG support so voices and 3DO music are not available.
+- No netmelee.
+
+
+Prerequisites:
+--------------
+
+- Platform SDK for S60 3rd ed. (MR) / 3rd ed. FP1 / 3rd ed. FP2, depending on
+  target hardware
+  * Download from http://www.forum.nokia.com/
+
+- Open C plugins (if SDK is other than FP2; in FP2 those should be included already)
+  * Download from http://www.forum.nokia.com/main/resources/tools_and_sdks/openc_cpp/
+
+- Carbide.c++ (if building for emulator)
+  * Download from http://www.forum.nokia.com/
+  * Command line compiling must be enabled
+
+- ARM RealView compiler (if building for hardware)
+  * Commercial, see http://www.arm.com/products/DevTools/
+
+- MinGW and MSYS (for build scripts)
+  * Download from http://www.mingw.org/
+
+- Info-Zip (for building content package)
+  * Download from http://www.info-zip.org/Zip.html
+
+- SDL for S60 3rd ed.
+  * Download from http://koti.mbnet.fi/mertama/sdl.html
+  * You also need the sources from http://www.libsdl.org/
+
+Building:
+---------
+
+1) Set up platform SDK, compilers, Open C plugins and MinGW + MSYS.
+   * Be sure zip and other tools are listed in path so they can be accessed
+     directly from command line.
+
+2) Subst your Symbian SDK to a new drive along the following example:
+      subst z: C:\Symbian\9.1\S60_3rd_MR_2
+      
+3) Put UQM sources inside the substed drive, if not already there.
+
+4) Install and build SDL, instructions are inside the package.
+
+5) Build a partial port of libpng and SDL_image, which are included
+   in UQM SVN repository at trunk/symbian/png:
+      cd png\group
+      bldmake bldfiles
+      abld build
+
+6) Open MSYS terminal. All following steps are done inside it.
+
+7) Two environment variables control the building, BUILD_EPOCROOT and BUILD_HOST.
+   
+   Set BUILD_EPOCROOT to point to the substed drive:
+      export BUILD_EPOCROOT=/z
+      
+   Set BUILD_HOST to either WINSCW (emulator) or ARMV5 (hardware), depending
+   for which target you want to build:
+      export BUILD_HOST=ARMV5
+
+8) Compile (you don't need to change any options from the interactive menu):
+      ./build.sh uqm
+
+9) Install. It builds the content zip and puts everything to proper
+   place (WINSCW) or creates a self-signed SIS package (ARMV5):
+      ./build.sh uqm install
+      
+10) If you built for ARMV5, you should now have uqm.sisx in the same directory
+    from where you did the build. Remember to also install SDL SIS package and
+    if not using FP2 SDK, Open C plugins before attempting to run UQM on actual
+    device.