Install-WindowsMobile

On this page you can find instructions on how to compile Freeciv (SDL client) for the Pocket PC platform. I've successfully compiled it for my 200MHz StrongARM Pocket PC (Windows Mobile 2003) and it looks quite nice, though it still needs a lot of polishing to be really playable ;-)
==Requirements==
*a Windows machine
*7-Zip (to unzip the development environment)
==Building==
#download my freeciv-ppc development environment: freeciv-ppc-2.1.0-beta4-src.7z(it contains MSYS, an arm-wince-pe cross-compiler (GCC-3.3.3) which was created by Mamaich, Python, all libraries that Freeciv depends on and also a snapshot of Freeciv itself)
#unzip the development environment (for this HOWTO it was unzipped to C:\)
#have a look at the Tweaking section for special configuration hints
#run "C:\freeciv-ppc\msys\1.0\msys.bat"
#$ cd /usr/src
#$ ./build_all.sh
#If all went well, you'll find the binaries in "C:\freeciv-ppc\msys\1.0\games"
==Precompiled Binaries==
If something goes wrong during the build process or if you don't want to build the game from source, you can also download precompiled binaries:
*freeciv-ppc-2.1.0-beta4-qvga-bin.zip - Freeciv 2.1.0-beta4 for devices with QVGA (320x240) display
*freeciv-ppc-2.1.0-beta4-vga-bin.zip - Freeciv 2.1.0-beta4 for devices with VGA (640x480) display
==Installing==
# transfer all files and directories from "C:\freeciv-ppc\msys\1.0\games" to some folder on your Pocket PC
==Playing==
#start the file manager
#change to the folder where you installed Freeciv
#click on "civserver" -> this will start the Freeciv server in the background
#click on "civclient"
#select "Join Game" from the main menu and click "Connect" to connect to the server
#enjoy :-)
NOTES: 
* If you want to change some game settings (number of AI players, difficulty etc.), you need to edit the "servercmds.serv" file. See Server_options for a list of supported settings.
* There seems to be a bug in the SDL library that leads to screen distortions in fullscreen mode. If the main screen looks distorted after starting the client, moving the "Messages" window around the screen might clear it up a bit.
==Tweaking==
*if your device has a resolution of 640x480 or higher, open /usr/src/build_freeciv.sh in an editor and delete or outcomment the line which says:patch -N -p1 < ../freeciv-smallscreen-2.1.0-beta4.diff
*if your device is not low on RAM, open /usr/src/build_freeciv.sh in an editor and delete or outcomment the line which says:patch -N -p1 < ../freeciv-nocompression-2.1.0-beta4.diff
==Troubleshooting==
If it doesn't run on your device, there's perhaps not enough free memory available (server and client together need about 50 MB with trident tileset at this time, even more with isometric tilesets :-|). Then you could try to deinstall some of your other software or delete some unused tilesets from the data directory (if you have stored it in RAM). Please check the logfiles (serverlog.txt and clientlog.txt), too. You could also delete civserver.exe and start a server on your Windows machine which would save some megabytes of RAM, too. Since there's no possibility to enter text in fullscreen mode yet, you'd then have to edit the "clientargs.txt" file and add a "-s HOST" argument, where HOST would have to be the hostname (or IP) of your windows machine.
Category:Installing