Preparing Dev-C++ and Win32 enviroment for Borsuk development.
==============================================================
by Mateusz 'vArDo' Bilinski
with help of:
Piotr 'piko' Konieczny
Most of this text contains libs installing procedures as it is the most
important. So let's get started.
1. Installing Dev-C++.
----------------------
* Download the Dev-C++ IDE: http://www.bloodshed.net/dev/devcpp.html
I use version 4.9.8 (so you should too :P ):
http://heanet.dl.sourceforge.net/sourceforge/dev-cpp/devcpp4980.exe
* Now install it where you prefer. I installed it in default dir:
c:\Dev-Cpp. Installing Dev-C++ in dir containing spaces is
NOT RECOMMENDED (so c:\Program files is not a good idea) as it is
a problem for some versions.
* Dev-C++ should work now.
* Remember that you should install Dev-C++ with MinGW. Otherwise you
will have to install it separately.
* As Borsuk is on the GPL license to make things easier select 'Tools'
menu and then the 'Code' tab. Now click on the 'Add button' and as
the menu entry write in sth like 'GPL Borsuk Header'. Now enter
the text below in this big edit field:
<src>
/*
* Borsuk Maths & Physics Instant Messenger
*
* Borsuk is the legal property of its developers, whose names are listed
* in the COPYRIGHT file distributed with this source distribution.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
</src>
Click OK and that's it. Now you can enter the above text quickly
selecting 'GPL Borsuk Header' form Edit/Enter menu.
REMEMBER this text MUST BE at the beginning of EVERY Borsuk project
source file.
2. Installing GTK+.
-------------------
* We will use all-in-one installer available here:
http://gladewin32.sourceforge.net/. Download AIO installer:
http://heanet.dl.sourceforge.net/sourceforge/gladewin32/gtk-win32-aio-2.4-rc9.exe
* Select 'GTK+ Runtime' (it should be grayed-out so you can't uncheck it)
and 'Devel headers/libraries' the rest is up to you. We will not
be using Glade so you don't have to install it. Documentation is
of course helpful.
* An installation dir is up to you. I've chosen c:\GTK and I will
be using it later in this text. DO NOT INSTALL GTK+ in Dev-C++
dir, as there can be problems later with uninstalling it
(e.g. some GTK+ and Dev-Cpp files have the same names). Of course
you can install it in c:\Dev-Cpp\GTK dir.
* Now we have to inform 'pkg-config' tool where to find *.pc files
as we will be using it. Add new enviroment variable called
'PKG_CONFIG_PATH' and as a value enter:
'c:\Dev-Cpp\lib\pkgconfig;c:\GTK\lib\pkgconfig'. Please remember
where you installed GTK+ as 'c:\GTK' above is my installation dir.
In WinXP to do this right-click on 'My computer' icon on desktop
and select 'Properties'. Now click on the 'Advanced' card and then
on the 'Enviroment variables' button at the bottom. Click on the 'New'
button again at the bottom of the window and enter the values given
earlier.
[Added by piko] In WinME/Win9x you have to use: Menu Start -> Run
(Or just press combo 'WinKey + R' The WinKey is located on your
keyboard, (near left Ctrl)). Done, Luke? Now type: 'msconfig'
and press Enter. Then click on the 'Enviroment' tab and push
'New' button. Enter the values given earlier. Remember to activate
this line by clicking on the selection field. Then you should
restart your machine. Thanks to Gates :>
3. Installing gtkmm.
--------------------
* Download gtkmm installer from this page:
http://www.pcpm.ucl.ac.be/~gustin/win32_ports/gtkmm.html.
Here is my version:
http://www.pcpm.ucl.ac.be/~gustin/win32_ports/binaries/gtkmm-2.4.3-1.exe
* Install at least: libsigc++, glibmm, gtkmm (both Runtime and Development).
Install it in Dev-C++ dir, e.g 'c:\Dev-Cpp' (NOT IN 'c:\Dev-Cpp\gtkmm'!!!).
* Finally add new entry to the PATH enviroment variable (the same as you
you did it with PKG_CONFIG_PATH, but now just edit it - don't create it):
'c:\Program Files\Common Files\gtkmm'. This is the default path to gtkmm
runtime libraries (*.dll). You need it to run gtkmm applications.
4. Compiling first project.
---------------------------
* Create new empty project in Dev-Cpp and an empty file.
* Paste the code below to that file:
<src>
#include <gtkmm.h>
int main(int argc, char *argv[])
{
Gtk::Main kit(argc, argv);
Gtk::Window window;
Gtk::Main::run(window);
return 0;
}
</src>
* Now get the the console (execute 'command.com' for example) and enter:
'pkg-config --libs --cflags gtkmm-2.4' (if system can't find 'pkg-config'
tool enter 'c:\Dev-Cpp\bin' dir). You should get something like this:
<src>
-Ic:/Dev-Cpp/include/gtkmm-2.4 -Ic:/Dev-Cpp/lib/gtkmm-2.4/include -Ic:/Dev-Cpp/i
nclude/glibmm-2.4 -Ic:/Dev-Cpp/lib/glibmm-2.4/include -Ic:/Dev-Cpp/include/gdkmm
-2.4 -Ic:/Dev-Cpp/lib/gdkmm-2.4/include -Ic:/Dev-Cpp/include/pangomm-1.4 -Ic:/De
v-Cpp/include/atkmm-1.6 -Ic:/Dev-Cpp/include/sigc++-2.0 -Ic:/Dev-Cpp/lib/sigc++-
2.0/include -Ic:/GTK/include/gtk-2.0 -Ic:/GTK/include/glib-2.0 -Ic:/GTK/lib/glib
-2.0/include -Ic:/GTK/lib/gtk-2.0/include -Ic:/GTK/include/pango-1.0 -Ic:/GTK/in
clude/atk-1.0 -Lc:/Dev-Cpp/lib -Lc:/GTK/lib -lgtkmm-2.4 -lgdkmm-2.4 -latkmm-1.6
-lgtk-win32-2.0 -lpangomm-1.4 -lglibmm-2.4 -lsigc-2.0 -lgdk-win32-2.0 -latk-1.0
-lgdk_pixbuf-2.0 -lpangowin32-1.0 -lgdi32 -lpango-1.0 -lgobject-2.0 -lgmodule-2
.0 -lglib-2.0 -lintl -liconv
</src>
* Now enter project options (Alt+P) and Parameters card. In 'C++ compiler' field
enter everything that contains dir paths, in the above listing everythin till
'-Lc:/GTK/lib' including it. In 'Linker' field enter the rest, from
'-lgtkmm-2.4' till '-liconv'. In both fields everything MUST BE in ONE LINE
so erase any linebreaks if you copy/pasted the above from console. And of course
click OK button.
* You should now be able to compile and execute (<F9>) your first gtkmm app.
4. Contact.
-----------
If you have any problems contact me:
E-mail: vardo . (at) . fr . pl
Jabber: vardo@jabber.atman.pl
Gadu-Gadu: 3052379
Good Luck,
Mateusz 'vArDo' Bilinski