Hi there, I thought it would be good to have a little manual on this. It’s work in progress so please post as much feedback as possible.
Chapters (Grey is to do):
[ul][li]The Frogatto SVN-repository[/li]
[li]The SVN commandline tool[/li]
[li]Graphical client RapidSVN[/li]
[li]Compiling on Linux[/li]
[li]Compiling on Windows
[li]Using Ms Unix Services for Windows[/li]
[li]Using Ms Visual C++[/li]
[li]Compiling on Mac OS
[size=12pt]The Frogatto SVN-repository[/size]
SVN stands for Subversion and is a version control system. Every committer (->The developers) can commit his local changes to the repository on the SVN-server. Every commit will create a new revision which is like a number for every single version of the repository.
The Frogatto repository is public since revision 125, everyone can download from it. The current revision 3470 but often, it increases multiple times a day. The url of the Frogatto repo is svn://frogatto.com/home/ben/svn/frogatto/trunk/. To Access it, you’ll need an SVN client. There are no Binaries in the Repository. I’ll explain how to compile them later.
SVN can be used through the simple svn commandline program or through a graphical client which likely is more intuitive.
[size=12pt]The SVN commandline tool[/size]
On some Linux distriutions, subversion is present by default, on others, you’ll have to install it through:
On Debian and it’s derivatives (like Ubuntu)
(The # means that it needs to be run as root, so you might have to put a sudo to the beginning)
If you want to compile it on your own, you can find source releases here.
For Mac you can find Binaries at http://www.open.collab.net/downloads/community/ or you can install subversion through Mac-Ports later.
On Windows, it will come with the Build enviorenment we’ll install later. In case you prefer to compile with Ms Visual C++, I recommend to simply use the graphical client.
The command to run the subversion commandline program is ‘svn’. Through
you can download or update to the current revision of the repository to the directory frogatto (created if nonexistent) in the current path.
You can revert local changes to the “file”.
Will update a file or directory to the current revision.
[size=12pt]Graphical client RapidSVN[/size]
I recommend RapidSVN as a graphical SVN client. Binary packages are available for Windows Linux and Mac. Using Repostitory/Checkout, you can enter the SVN URL and a directory to download to. Everything else should be self explanatory.
[size=12pt]Compiling on Linux[/size]
Compiling on Linux is Quite easy. The development files (The Headers) of SDL, SDL_image, SDL_mixer, SDL_ttf, libpng, OpenGL, GLEW, GLU and boost need to be installed. On Debian, Ubuntu and other derivates, you can use:
Also you need the build-essentials (Compiler, GnuMake etc):
Now open a terminal and cd to the directory in which you checked out the frogatto repository.
You can use ccache to recompile faster (apt-get install ccache), otherwise you have to edit the Makefile and remove ccache in line 13.
Then, in the directory with the Makefile run
(Without the $, it indicates that you should run this as an unprivileged user) and wait until it’s compiled. If there’s an error you should try to compile using
to ignore leftovers from earlier compilations but this will take longer. If that doesn’t help, please respond to this thread and show the last few lines of the make-output.
For translation-support, you need to let it generate the .mo language files from the .po’s.
You can compile the multiplayer server using
If everything worked, there should be a ‘game’ binary in the directory now. This is the newest frogatto SVN build. Use
./gameto run it.
[size=12pt]Compiling on Windows[/size]
[b]- TODO -[/b]
Just played around with the Windows Services for Unix and found I don’t like them, so no tutorial for them, I’ll work on a cygwin tut now.