From: Neil Roberts Date: Wed, 29 Jul 2009 18:06:36 +0000 (+0100) Subject: [mingw] Update the README X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b3842a6b62979d264b7d7057e4125602e644ccad;p=profile%2Fivi%2Fclutter.git [mingw] Update the README The README has been updated to say that you can use the script under MSYS and also to contain a pointer to OAH. It also contains the updated contents of a blog post¹ about building with MSYS. 1. http://www.busydoingnothing.co.uk/blog/2008/07/13#ClutterWin32 --- diff --git a/build/mingw/README b/build/mingw/README index 2e8ba49..3a37be2 100644 --- a/build/mingw/README +++ b/build/mingw/README @@ -1,16 +1,137 @@ Building Clutter with mingw =========================== -The mingw-cross-compile.sh script in this directory automates cross compilation -of clutter with mingw for win32; it requires to have the mingw cross compiler -installed, but it will point you in the right direction if it cannot find it. -It will also fetch all the necessary dependencies; it build clutter from -svn trunk, so you might want tweak it if you are looking for specific tag. +The mingw-cross-compile.sh script in this directory automates +compilation of Clutter using the MinGW compiler. You can run it from +Linux to cross compile or you can use MSYS and MinGW to compile it +directly on Windows. -To cross-compile clutter, +If you were looking to build Clutter with Visual Studio instead there +is an external project which is maintaining build files for Clutter +(and other glib-based projects) here: + + https://launchpad.net/oah + +For cross compiling you need to have the compiler installed. The +script should automatically download all other dependencies. Under +Ubuntu (and probably other Debian-based distros) you can install the +compiler with this command: + + sudo apt-get install mingw32{,-binutils,-runtime} + +To compile clutter, mkdir build_dir cd build_dir ./mingw-cross-compile.sh and follow the prompts. + +Building under MSYS +=================== + +Building directly under Windows requires some extra work to get some +basic utilities installed. Here are step-by-step instructions to build +from a clean installation of Windows: + +First you need to install the MinGW and MSYS packages from [1]. + +Select the top package called 'Automated MinGW Intaller' and download +the exe of the latest version. Run the executable and install to the +default location. Make sure you DON'T install 'MinGW make' to make +life easier. + +Next download the 'MSYS Base System'. Use the .exe installer from +'Current release' (not the technology preview). Run the executable and +install to the default location. Answer yes to whether you want to +continue with the post install and tell it the location where you +installed MinGW (which should be c:/MinGW). + +Next install the 'MSYS supplementary tools'. Again select .exe from +the current release and install it to the default location. + +To get the dependencies we want to run the mingw-cross-compile.sh +script. However to do this we first need some extra utilities. + +Make a directory called c:/msys/1.0/clutter-work and another directory +called downloads under that. Go back to the SourceForge page for MinGW +and select the 'User Contributed: mingwPORT' section. Download the +wget tarball to the newly created downloads folder. + +Start MSYS and type the following to install wget. + +cd /clutter-work/downloads +tar -jvxf wget-1.9.1-mingwPORT.tar.bz2 +cd wget-1.9.1/mingwPORT +mkdir /usr/src +PATH="$PATH":"$PWD" ./mingwPORT.sh + +Press enter at each question to just use the default + +Next we need to install unzip.exe which we can get from the GNUWin32 +ports. Visit here [2] and download the 'complete package, except +sources'. Install it to the default location. + +Now we can type the following to download and install the clutter +dependencies using the helper script: + +cd /clutter-work +wget -O downloads/mingw-cross-compile.sh \ +http://folks.o-hand.com/neil/mingw-cross-compile.sh +PATH="$PATH:/c/Program Files/GnuWin32/bin" \ +sh ./downloads/mingw-cross-compile.sh + +Press enter to all of the questions to get the default except the 'Do +you want to download and install Clutter' question because that will +try to use Git which we don't have installed. + +Next we need to install pkg-config to get Clutter's configure script +to work. Type the following: + +cd /clutter-work/downloads +wget 'http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz' +tar -zvxf pkg-config-0.23.tar.gz +cd pkg-config-0.23 +prefix=/clutter-work/clutter-cross +libdir="${prefix}/lib" +includedir="${prefix}/include" +CFLAGS="-g -O2 -Wall -I${includedir}/glib-2.0 -I${libdir}/glib-2.0/include" \ +LDFLAGS="-L${libdir} -lglib-2.0 -lintl -liconv" \ +./configure +make all install + +Now we should finally be ready to compile Clutter: + +cd /clutter-work/downloads +wget http://www.clutter-project.org/sources/clutter/1.0/clutter-1.0.0.tar.bz2 +cd .. +tar -jvxf downloads/clutter-1.0.0.tar.bz2 +cd clutter-1.0.0 +PKG_CONFIG_PATH=/clutter-work/clutter-cross/lib/pkgconfig \ + PATH="$PATH:/clutter-work/clutter-cross/bin" \ + CFLAGS="-mms-bitfields -I/clutter-work/clutter-cross/include -g -O2 -Wall" \ + ./configure --prefix=/clutter-work/clutter-cross --with-flavour=win32 +make all install + +Now to prove that it worked we can run test-actors. Windows needs the +Clutter DLL to be in the system path for this to work so type the +following: + +export PATH="$PATH:/clutter-work/clutter-cross/bin" +cd /clutter-work/clutter-1.0.0/tests +.libs/test-actors + +If you want to compile a simple app without using autotools, it's +easiest to use the libtool generated in the Clutter source so that it +can work some voodoo with the included libraries. This assumes you've +still got your path set up from the previous test: + +libtool --mode=link gcc -Wall -g -o simple-app simple-app.c \ +-I/clutter-work/clutter-cross/include \ +`PKG_CONFIG_PATH=/clutter-work/clutter-cross/lib/pkgconfig + pkg-config clutter-0.8 --cflags --libs` + +Enjoy! + +[1] http://sourceforge.net/project/showfiles.php?group_id=2435 +[2] http://gnuwin32.sourceforge.net/packages/unzip.htm