Source

pygame / symbian / how_to_build.txt

Diff from to

symbian/how_to_build.txt

 
 Run 'makeref.py --no-code-docs'
 - This regenerates pygame module documentation without documentation in code.
+-- Not very useful on the phone.
 
-Create symbian/deps directory
+- The build scripts use SCons for Symbian. 
+-- http://code.google.com/p/scons-for-symbian/
+-- Follow the installation instructions
+
+
+The used libraries are stored in pygame-for-s60 project page at code.google.com.
+They must be copied to symbian/deps directory.
+
+Go to the symbian folder and execute SVN checkout:
+
+svn checkout http://pygame-symbian-s60.googlecode.com/svn/trunk/deps deps
+
+== Install PyS60 stuff ==
+
+- Make sure your EPOCROOT environment variable points to your Symbian SDK
+- Run: 
+    deps\misc\get_pys60.py --tools-path=deps
+
+-- This gets the latest PyS60 release and unzips it into your EPOCROOT
+
+Or do it manually:
+
+Get latest PyS60 & OpenC SDKs from Maemo Garage
+- https://garage.maemo.org/frs/?group_id=854&release_id=2673
+-- Unzip the stuff to your Symbian epocroot
+
+Get PyS60 packaging tool( from maemo )
+- Get the tar.gz package.
+-- Copy the PythonForS60 folder to 'deps'
+
+
+== The original sources of external libraries ==
 
 Checkout ogg to symbian/deps/ogg
 - IMPORTANT: Revision 7524
 
 Get SDL for Series60
 - Available at: http://koti.mbnet.fi/mertama/sdl.html
-- Follow the instructions and copy the pathced SDL S60 folder to symbian/deps/SDL
+- Follow the instructions and copy the patched SDL S60 folder to symbian/deps/SDL
 
 Get SDL_mixer to symbian/deps/SDL_mixer
 - http://www.libsdl.org/projects/SDL_mixer/
 Checkout PNG library to symbian/deps/libpng
 - http://pamp.svn.sourceforge.net/svnroot/pamp/libpng/trunk/libpng-1.2.18
 
-- The build scripts use SCons for Symbian. 
--- http://code.google.com/p/scons-for-symbian/
--- Follow the installation instructions
-
 
 === Building ===
 
-==== Using the release building script ====
-- Go to pygame/symbian directory
+==== Basic configuration ====
+
+1. Get certificates for the installer.
+-- http://wiki.forum.nokia.com/index.php/Creating_and_using_self-signed_certificate
+2. Go to pygame/symbian directory
+3. Run configure.py
+-- python configure.py cert=<path to .cer> privkey=<path to .key> passphrase=<password>
+-- Now you don't need to give this information each time you build.
+
+==== Optional configurations ====
 
 The pygame can be built against the official(or any) pys60 version. 
-Initialize the release script by giving it information about the python dll to be linked with
-and the sis file to be embedded.( UID is read directly from the sis package )
-- TODO: Not implemented yet!!
-- configure.py pythondll=python222 pys60_sis=Python_1.4.5_3rdEd.sis
-- configure.py pythondll=python25  pys60_sis=Python_1.9.0_3rdEd.sis
+
+- Initialize the release script by giving it information about the python dll to be linked with
+- Optionally the sis file to be embedded.( UID is read directly from the sis package )
+configure.py pythondll=python25 pys60_sis=Python_1.9.0_3rdEd.sis
 
 or
+!!! DEPRECATED. PyS60 CE based on Python 2.2 and not supported anymore. Maybe in the future.
 
 - Use BuildPygameRelease.py script to build the 'pygame_python' with PyS60 Community Edition,
   the depended libraries and the pygame itself. All in one.
 # Use existing python sis. Need to configure the python dll for linker.
 configure.py build_python=False pys60_sis=official_python.sisx pythondll=python222.dll
 
+
 ==== Do the build ====
 
 Emulator:
 
 Device:
 - Run: BuildPygameRelease.py compiler=gcce release=urel
--- NOTE: The you can set your certificate information with configure.py
 
 
 === Misc info ===
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.