Personal tools

Gtk2Hs

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
(Corrected Windows variable setting examples.)
(delete outdated links + update some of the information)
 
(9 intermediate revisions by 6 users not shown)
Line 7: Line 7:
 
== Homepage ==
 
== Homepage ==
   
http://haskell.org/gtk2hs/
+
http://projects.haskell.org/gtk2hs/
   
 
== Tutorials and Demos ==
 
== Tutorials and Demos ==
Line 21: Line 21:
 
== Status ==
 
== Status ==
   
It currently works with Gtk+ 2.0 through to 2.22 on Unix, Win32 and MacOS X.
+
See [[Gtk2Hs/Installation#Supported_Versions]] for details on which systems should be able to build Gtk2Hs and which are known to be able to build Gtk2Hs.
Details please check : http://www.gtk.org/language-bindings.html
 
 
It currently builds with ghc 5.04.3 through to 7.xx.x (6.12.2 have runtime bug, don't use it)
 
   
 
== Installation Notes ==
 
== Installation Notes ==
=== Windows 7 32 bit ===
 
==== Changing Environment Variables ====
 
This installation process involves adding/modifying environment variables. The rest of this subtopic shows you how to do that in Windows.
 
* Using the Environment Variable GUI
 
** Click to the Windows symbol on the bottom-left where "Start" used to be
 
** Right-Click on "Computer", choose "Properties" and click the link for "Advanced System Settings"
 
** In the *top* window, Click "New" add a variable or click "Edit" to modify an existing one.
 
** The variable should be a ';' seperated list of directories.
 
* At the DOS prompt
 
** To see the current value of variable VAR:
 
> echo %VAR%
 
** To modify variable VAR:
 
> set VAR=%VAR%;dir1;dir2 ...
 
** To create variable VAR:
 
> set VAR=dir1;dir2....
 
==== Install Haskell Platform and MingW ====
 
* Install the [http://hackage.haskell.org/platform/windows.html Haskell Platform] for Windows.
 
* Optional : Install [http://mingw.org MinGW] as per the instructions on their web site. Also install MSYS and mingw-make. A version of MinGW does come with Haskell Platform but excludes MSYS and 'make'.
 
==== Install libxml ====
 
* Download and unzip the latest libxml2 and libxml2-dev archives from [http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ Gnome].
 
* To the PKG_CONFIG_PATH environment variable add the 'pkgconfig' directory in libxml2-dev.
 
* To the INCLUDE environment variable add the path to the 'include' directory from libxml2-dev.
 
 
==== Install the GTK/Glade bundle ====
 
* Download and install the [http://ftp.gnome.org/pub/GNOME/binaries/win32/glade3/3.6/glade3-3.6.7-with-GTK+.exe bundled GTK and Glade binary].
 
* To the PKG_CONFIG_PATH environment variable add the 'pkgconfig' directory. The default path should be "C:\Program Files\Gtk+\lib\pkgconfig".
 
* To the INCLUDE environment variable add the 'libglade-2.0' directory. The default path should be "C:\Program Files\Gtk+\include\libglade-2.0".
 
==== Install the Haskell bindings ====
 
* At the DOS prompt run 'cabal install gtk2hs-buildtools'.
 
* At the DOS prompt run 'cabal install gtk'. Make sure you have at least 1.5 GB RAM otherwise this compilation will die.
 
* At the DOS prompt run 'cabal install glade'.
 
==== Test the GTK install ====
 
* In some appropriate temporary directory run 'cabal unpack gtk'. This downloads and unpacks the Haskell sources.
 
** Run the demos (using mingw-make)
 
*** If you installed MinGW then in the 'demo' directory, navigate into the 'hello' directory and run mingw32-make.exe. Now run the executable that was created.
 
** Run the demos (manual compilation)
 
*** In the 'demo' directory, navigate into the 'hello' directory and run 'ghc --make World.hs -o helloworld.exe'. Now run the executable that was created.
 
==== Test the Glade install ====
 
* In some appropriate temporary directory run 'cabal unpack glade'. This downloads and unpacks the Haskell sources.
 
** Run the demos (using mingw-make)
 
*** If you installed MinGW then in the 'demo' directory, navigate into the 'gladetest' directory and run mingw32-make.exe. Now run the executable that was created.
 
** Run the demos (manual compilation)
 
*** In the 'demo' directory, navigate into the 'gladetest' directory and run 'ghc --make GladeTest.hs -o gladetest.exe'. Now run the executable that was created.
 
 
==== Common Errors ====
 
* Glade.h is not found
 
gtk2hsC2hs.exe : glade/glade.h: File does not exist
 
Probably instead of installing the GTK/Glade bundle you installed them seperately. The GTK/Glade bundle comes with the "include/libglade-2.0" containing a number of header files. For some reason this directory is not included in stand-alone GTK and Glade installers. Install the bundle and add this directory to the INCLUDE environment variable.
 
* Cabal cannot find gtk2hsC2hs.
 
Please install gtk2hs-buildtools' first and check
 
that the installdirectory is in your PATH (e.g. HOME/.cabal/bin).
 
cabal: Error: some packages failed to install
 
Somehow the path to the cabal bin directory has been lost. To the PATH environment variable re-add the cabal bin directory. The default path should be "%USERPROFILE%\AppData\Roaming\cabal\bin".
 
* Spinner error with the 'notebook' demo
 
Running the 'notebook' demo in the GTK install gives:
 
[1 of 1] Compiling Main ( Notebook.hs, Notebook.o )
 
Notebook.hs:14:35:
 
Not in scope: type constructor or class `Spinner'
 
Notebook.hs:78:13: Not in scope: `spinnerNew'
 
Notebook.hs:101:2: Not in scope: `spinnerStart'
 
Notebook.hs:109:2: Not in scope: `spinnerStop'
 
mingw32-make: *** [notebook] Error 1
 
This happens because this demo uses the new Spinner widget in GTK 2.22. Since this is not available in GTK 2.16 you get this error.
 
 
=== Mac OS X ===
 
 
==== Using MacPorts and Snow Leopard ====
 
 
This explains how to install Gtk2Hs-0.10.1 on Mac OS X 10.6 Snow Leopard, in combination with GTK+ from MacPorts.
 
 
* Install the [http://hackage.haskell.org/platform/ Haskell Platform] for Mac
 
* Download gtk2hs from [http://www.haskell.org/gtk2hs/ gtk2hs website] and untar it.
 
* Install gtk, cairo, etc. from MacPorts like this (note that the +universal is needed; if you already installed gtk or one of its dependencies, it is recommended you reinstall those as detailed in the NB at the end of this section).
 
:::sudo port install gtk +universal
 
* go to the directory where gtk2hs is untarred and run
 
:::./configure --disable-split-objs --disable-gio
 
:::make
 
:::sudo make install
 
 
Alternatively, if you wish to follow the Mac OS X style of directory layout, you can use this configure command instead:
 
:::./configure --with-pkgconf=/Users/username/.ghc/i386-darwin-6.10.4/package.conf --prefix=/Users/username/Library/Haskell/packages/gtk2hs --disable-split-objs --disable-gio
 
 
Where username is your username ofcourse. Right now you should be able to run the demos. Unfortunately, to build any libraries depending on gtk2hs, such as [http://hackage.haskell.org/package/Chart/ Chart], you need to edit one more file. You will need to find "package.conf" for your ghc by doing
 
:::ghc-pkg list
 
In the output you will see the full directory to your package.conf file. In this file, you need to search for "gthread", and everywhere you can find it, add "/opt/local/lib" (with quotes) to the libraryDirs array before it.
 
 
If all went well, it should be properly installed now.
 
 
NB: If compiling fails with architecture errors for certain dynlibs, you need to reinstall the packages these dynlibs belong to with +universal by doing
 
:::sudo port upgrade packagename --enforce-variants +universal
 
Alternatively, and this is recommended, you can follow the steps on [http://passingcuriosity.com/2009/haskell-on-snow-leopard/ Haskell On Snow Leopard Blogpost] to immediately add the universal variant of each package:
 
# Edit /opt/local/macports/variants.conf and add +universal to the end of this file
 
# sudo port selfupdate
 
# sudo port sync
 
# sudo port upgrade --force-installed
 
 
==== Using the GTK+ OS X Framework ====
 
 
This explains how to install Gtk2Hs on Macs using the native [http://gtk-osx.sourceforge.net/ GTK+ OS X Framework], a port of GTK+ to the Mac that does '''not''' depend on X11, and hence, is better integrated into the Mac desktop - i.e., menus actually appear in the menu bar, where they belong. It also avoids the often tedious installation of GTK+ via MacPorts. However, it misses support for optional Gtk2Hs packages that are currently not supported by the [http://gtk-osx.sourceforge.net/ GTK+ OS X Framework], most notably support for Glade. It does include support for Cairo, though.
 
 
Here is how to install the library:
 
# Download and install [http://gtk-osx.sourceforge.net/ GTK+ OS X Framework] (this uses the standard Mac package installer).
 
# Install [http://pkg-config.freedesktop.org/ pkg-config], either by compiling it from source or via MacPorts.
 
# Download and unpack the Gtk2Hs tar ball from the [http://www.haskell.org/gtk2hs/download/ Gtk2Hs download page] (I tested 0.10.0).
 
# Configure with (you may want to remove the two backslashes and put everything on one line)
 
env PKG_CONFIG_PATH=/Library/Frameworks/Cairo.framework/Resources/dev/lib/pkgconfig:\
 
/Library/Frameworks/GLib.framework/Resources/dev/lib/pkgconfig:\
 
/Library/Frameworks/Gtk.framework/Resources/dev/lib/pkgconfig ./configure --disable-gio
 
# Build with
 
make
 
# Install (to <tt>/usr/local/</tt> unless a <tt>--prefix</tt> option was passed to <tt>configure</tt>) with
 
sudo make install
 
 
The library is now registered with the package database of the GHC you used for compiling.
 
 
NB: Thanks to Ross Mellgren for his post on the gtk2hs-users list that outlined the use of <tt>PKG_CONFIG_PATH</tt>.
 
 
==== Article as of Mid 2008 ====
 
Installing Gtk2Hs on Mac requires some finesse, at least until Haskell Libary Platform is built or ghc-6.8.3 is
 
available in macports. (These are planned for late 2008.)
 
 
* Install [http://macports.org MacPorts]
 
* Install dependencies:
 
sudo port install glade3 libglade2 gstreamer gst-plugins-base gtksourceview cairo librsvg gtkglext firefox
 
* Update PKG_CONFIG_PATH (for libraries)
 
export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/local/lib/pkgconfig:/opt/local/lib/pkgconfig
 
* Update ghc to use macports libs: Edit your main <tt>ghc</tt> driver program and change the last line to:
 
exec $GHCBIN $TOPDIROPT ${1+"$@"} -L/opt/local/lib -I/opt/local/include
 
* Download Gtk2Hs following instructions at [http://www.haskell.org/gtk2hs/downloads/ Gtk2Hs Download page]
 
* Check configuration:
 
./configure --enable-docs --enable-profiling
 
 
...
 
 
**************************************************
 
* Configuration completed successfully.
 
*
 
* The following packages will be built:
 
*
 
* glib : yes
 
* gtk : yes
 
* glade : yes
 
* cairo : yes
 
* svgcairo : yes
 
* gtkglext : yes
 
* gconf : yes
 
* sourceview : yes
 
* mozembed : yes
 
* soegtk : yes
 
* gnomevfs : yes
 
* gstreamer : yes
 
* documentation : yes
 
*
 
* Now do "(g)make" followed by "(g)make install"
 
**************************************************
 
* Build and Install:
 
make
 
sudo make install
 
   
==== Recent experiences ====
+
See [[Gtk2Hs/Installation]].
I successfully installed the latest version on Mac OS 10.5 by:
 
* Installing Macports.
 
* <tt>sudo port install ghc</tt>
 
* <tt>sudo port install gtk2hs</tt> - which does not complete successfully. It does however, install the appropriate dependencies. Note that there are so many, you may need to install a couple of times due to time outs etc.. The build of Gtk2HS will fail, but that is ok - continue as below. Also note that ghc configure will give up if your perl5.8 is not new enough, if so deactivate it and try again.
 
* Remove the build directory under <tt>/opt/.../build/gtk2hs</tt>
 
* Download Gtk2Hs via darcs as per [http://haskell.org/gtk2hs/development/#darcs the gtk2hs download instructions]
 
* do a <tt>sudo port install automake</tt>
 
* do a <tt>sudo port install alex</tt>
 
* do a <tt>sudo port install happy</tt> (Note this also fails and must be built from source. See the [[Happy]] page for details.)
 
* Follow the build instructions on the [http://haskell.org/gtk2hs/development/#darcs the gtk2hs download page]. I would suggest using <tt>./configure --prefix=/opt/local</tt> to get it in the same place as ports - personal preference though.
 
Good luck - as usual, your mileage may vary.
 
   
 
== Demos ==
 
== Demos ==
Line 196: Line 38:
 
These are links to FAQS on the main site.
 
These are links to FAQS on the main site.
 
*[http://haskell.org/gtk2hs/archives/2005/06/23/hiding-the-console-on-windows/#more-26 Hiding the console on windows]
 
*[http://haskell.org/gtk2hs/archives/2005/06/23/hiding-the-console-on-windows/#more-26 Hiding the console on windows]
*[http://haskell.org/gtk2hs/archives/2005/07/24/writing-multi-threaded-guis/#more-38 Writing multi-threaded GUIs]
 
*[http://haskell.org/gtk2hs/archives/2005/06/24/building-from-source-on-windows/#more-15 Building on Windows]
 
 
*[http://haskell.org/gtk2hs/development/#darcs Checkout instructions]. Also see [[Darcs]]
 
*[http://haskell.org/gtk2hs/development/#darcs Checkout instructions]. Also see [[Darcs]]
   

Latest revision as of 20:16, 1 December 2012

Contents

[edit] 1 What is it?

Gtk2Hs is a Haskell binding to Gtk+ 2.x. Using it, one can write Gtk+ based applications with GHC.

[edit] 2 Homepage

http://projects.haskell.org/gtk2hs/

[edit] 3 Tutorials and Demos

http://www.haskell.org/haskellwiki/Gtk2Hs/Tutorials

Some demonstration programs can be found at:

http://code.haskell.org/gtk2hs/gio/demo/
http://code.haskell.org/gtk2hs/pango/demo/
http://code.haskell.org/gtk2hs/cairo/demo/
http://code.haskell.org/gtk2hs/gtk/demo/

[edit] 4 Status

See Gtk2Hs/Installation#Supported_Versions for details on which systems should be able to build Gtk2Hs and which are known to be able to build Gtk2Hs.

[edit] 5 Installation Notes

See Gtk2Hs/Installation.

[edit] 6 Demos

[edit] 6.1 OpenGL and Gtk2Hs

Gtk2Hs/Demos/GtkGLext/hello.hs

Gtk2Hs/Demos/GtkGLext/terrain.hs requires Gtk2Hs/Demos/GtkGLext/terrain.xpm

[edit] 7 FAQs

These are links to FAQS on the main site.