Developer's Guide
Quick and Dirty Developer's Guide
(a.k.a. how to install)
The GCC compiler suite (See note 1) - For Windows, use the automated MinGW installer.
Special note for Windows users:
Assumming you've installed MinGW on C:\Mingw:
Go to "My Computer", "Properties", "Advanced Settings", "Environment variables". On the system variables, add "c:\mingw\bin;c:\mingw\mingw32\bin" (without quotes) to the variable "Path".
Add the following variables (all variables and values are without quotes) :
- "LIBRARY_PATH", with value "C:\MinGW\lib"
- "C_INCLUDE_PATH", with value "C:\MinGW\include"
- "CPLUS_INCLUDE_PATH", with the following value (wrapped for display purposes):
"C:\MinGW\include\c++\3.4.5;
C:\MinGW\include\c++\3.4.5\backward;
C:\MinGW\include\c++\mingw32;C:\MinGW\include"
The wxWidgets library, version 2.8.8 or later. (See note 1)
For win32, here are the compilation commands:
- cd C:\wxWidgets-2.8.8\build\msw (note: change the path according to the version)
- mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1 VENDOR=saya clean
- mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1 VENDOR=saya
- copy c:\wxWidgets-2.8.8\lib\gcc_dll\wxmsw28u_gcc_saya.dll c:\windows\system32
- The Code::Blocks IDE (11/Nov/08 nightly preferred, or version 8.02 minimum), located at http://codeblocks.org/. Please don't install until you have installed and configured MinGW (also see note 1).
- 7zip, for extracting some of the above files.
The GetText binaries, libraries and dependencies (Win32 only), located at http://gnuwin32.sourceforge.net/packages/libint.html
To install, libintl3.dll (in the binaries archive) should go in C:\WINDOWS\SYSTEM32, the developer files should be extracted (with full path) under the MinGW main folder.
A subversion client. Install subversion on GNU/Linux, and TortoiseSVN on Win32.
- To edit some of the wxWidgets forms, you'll also need wxFormBuilder, version 3.0 or later.
- Finally, to compile Saya, you need to tell Code::Blocks where wxWidgets is located. Use the "settings","global variables" main menu. Add the wx variable, and under the "base" field, type in C:\wxWidgets-2.8.8 for Windows, or /usr/lib/wx for GNU/Linux.
(Note 1: Make sure you DON'T install them on a path with spaces! So "C:\Program Files" is forbidden)
The SVN repository
The SVN repository at berlios can be accessed at the following address:
https://yourusername@svn.berlios.de/svnroot/repos/saya/trunk
(make sure you're using https in there, not plain http)
If you don't have a username yet, skip it. There's no problem, but you won't be able to commit any changes.
Full Developer's Guide, Windows Version
(WARNING: Some paths and URLs may have changed since the publication of the guide. Remember: Google is your friend)
The Windows version of the Developer's guide is available on Sourceforge as pdf. It covers everything but the installation of 7zip.
Download Saya Developers' Guide for Windows users
Full Developer's Guide, GNU/Linux version
(WARNING: Some paths and URLs may have changed since the publication of the guide. Remember: Google is your friend)
The GNU/Linux version is also available on Sourceforge as pdf.