X-Git-Url: http://pileus.org/git/?p=~andy%2Fgtk;a=blobdiff_plain;f=README.win32;h=42ca66f26331486fb46829105f7aa68af3165db7;hp=94c592d4b1814997d802eca50f6d5412fbb13cf7;hb=HEAD;hpb=38aa9a941b6a2073ec728782359997b4902763ab diff --git a/README.win32 b/README.win32 index 94c592d4b..42ca66f26 100644 --- a/README.win32 +++ b/README.win32 @@ -1,24 +1,206 @@ -The Win32 port of GTk+ is a work in progress, and not as stable or -correct as the Unix/X11 version. For more information about the Win32 -port, see http://www.gimp.org/tml/gimp/win32/ or -http://www.iki.fi/tml/gimp/win32/ . - -To build GTk+ on Win32, you need either Microsoft compiler and tools, -or egcs-1.1.2 (or gcc-2.95 or later) running under -cygwin-b20.1. Compile in gdk\win32 and gtk with `nmake -f -makefile.msc` or `make -f makefile.cygwin`. Before doing a install, -check the BIN definition in gdk\win32\makefile.msc (or -makefile.cygwin) and gtk\makefile.msc (or makefile.cygwin). - -See the README.win32 file in the GLib distribution for preparations to -build with egcs on cygwin. - -The tablet support uses the Wintab API. The Wintab development kit can -be downloaded from http://www.pointing.com. - -GTk+ wants to be built with the GNU gettext library for -internationalisation (i18n). Get the version ported to Win32 (not a -very big deal) from tml's web site mentioned above. If you don't want -any i18n stuff, undefine ENABLE_NLS, HAVE_GETTEXT and HAVE_LIBINTL in -the config.h.win32 file, and remove references to the gnu-intl library -from the makefiles. +The Win32 backend in GTK+ is not as stable or correct as the X11 one. + +For prebuilt runtime and developer packages see +http://ftp.gnome.org/pub/gnome/binaries/win32/ + +Building GTK+ on Win32 +====================== + +First you obviously need developer packages for the compile-time +dependencies: GDK-Pixbuf, Pango, atk, glib, gettext-runtime, libiconv at least. +See http://ftp.gnome.org/pub/gnome/binaries/win32/dependencies . + +For people compiling GTK+ with Visual C++ 2005 or later, it is +recommended that the same compiler is used for at least GDK-Pixbuf, +Pango, atk and glib so that crashes and errors caused by different CRTs +can be avoided. The VS 2008 project files and/or VS Makefiles are +either already available or will be available in the next stable release. +Unfortunately compiling with Microsoft's compilers versions 2003 or earlier +is not supported as compiling the latest stable GLib (which *is* required for +building this GTK+ release) requires features from newer compilers +and/or Platform SDKs + +After installing the dependencies, there are two ways to build GTK+ +for win32. + +1) GNU tools, ./configure && make install +----------------------------------------- + +This requires you have mingw and MSYS. + +Use the configure script, and the resulting Makefiles (which use +libtool and gcc to do the compilation). I use this myself, but it can +be hard to setup correctly. + +The full script I run to build GTK+ 2.16 unpacked from a source +distribution is as below. This is from bulding GTK+ 2.16.5. I don't +use any script like this to build the development branch, as I don't +distribute any binaries from development branches. + +# This is a shell script that calls functions and scripts from +# tml@iki.fi's personal work envíronment. It is not expected to be +# usable unmodified by others, and is included only for reference. + +MOD=gtk+ +VER=2.16.5 +REV=1 +ARCH=win32 + +THIS=${MOD}_${VER}-${REV}_${ARCH} + +RUNZIP=${MOD}_${VER}-${REV}_${ARCH}.zip +DEVZIP=${MOD}-dev_${VER}-${REV}_${ARCH}.zip + +HEX=`echo $THIS | md5sum | cut -d' ' -f1` +TARGET=c:/devel/target/$HEX + +usedev +usemsvs6 + +( + +set -x + +DEPS=`latest --arch=${ARCH} glib atk cairo pango libpng zlib libtiff jpeg` +PROXY_LIBINTL=`latest --arch=${ARCH} proxy-libintl` + +PKG_CONFIG_PATH= +for D in $DEPS; do + PATH=/devel/dist/${ARCH}/$D/bin:$PATH + [ -d /devel/dist/${ARCH}/$D/lib/pkgconfig ] && PKG_CONFIG_PATH=/devel/dist/${ARCH}/$D/lib/pkgconfig:$PKG_CONFIG_PATH +done + +LIBPNG=`latest --arch=${ARCH} libpng` +ZLIB=`latest --arch=${ARCH} zlib` +LIBTIFF=`latest --arch=${ARCH} libtiff` +JPEG=`latest --arch=${ARCH} jpeg` + +patch -p0 <<'EOF' +EOF + +lt_cv_deplibs_check_method='pass_all' \ +CC='gcc -mtune=pentium3 -mthreads' \ +CPPFLAGS="-I/devel/dist/${ARCH}/${LIBPNG}/include \ +-I/devel/dist/${ARCH}/${ZLIB}/include \ +-I/devel/dist/${ARCH}/${LIBTIFF}/include \ +-I/devel/dist/${ARCH}/${JPEG}/include \ +-I/devel/dist/${ARCH}/${PROXY_LIBINTL}/include" \ +LDFLAGS="-L/devel/dist/${ARCH}/${LIBPNG}/lib \ +-L/devel/dist/${ARCH}/${ZLIB}/lib \ +-L/devel/dist/${ARCH}/${LIBTIFF}/lib \ +-L/devel/dist/${ARCH}/${JPEG}/lib \ +-L/devel/dist/${ARCH}/${PROXY_LIBINTL}/lib -Wl,--exclude-libs=libintl.a \ +-Wl,--enable-auto-image-base" \ +LIBS=-lintl \ +CFLAGS=-O2 \ +./configure \ +--enable-win32-backend \ +--disable-gdiplus \ +--with-included-immodules \ +--without-libjasper \ +--enable-debug=yes \ +--enable-explicit-deps=no \ +--disable-gtk-doc \ +--disable-static \ +--prefix=$TARGET && + +libtoolcacheize && +rm gtk/gtk.def && +(PATH="$PWD/gdk-pixbuf/.libs:/devel/target/$HEX/bin:$PATH" make -j3 install || (rm .libtool-cache* && PATH="/devel/target/$HEX/bin:$PATH" make -j3 install)) && + +PATH="/devel/target/$HEX/bin:$PATH" gdk-pixbuf-query-loaders >/devel/target/$HEX/etc/gtk-2.0/gdk-pixbuf.loaders && + +grep -v -E 'Automatically generated|Created by|LoaderDir =' <$TARGET/etc/gtk-2.0/gdk-pixbuf.loaders >$TARGET/etc/gtk-2.0/gdk-pixbuf.loaders.temp && + mv $TARGET/etc/gtk-2.0/gdk-pixbuf.loaders.temp $TARGET/etc/gtk-2.0/gdk-pixbuf.loaders && +grep -v -E 'Automatically generated|Created by|ModulesPath =' <$TARGET/etc/gtk-2.0/gtk.immodules >$TARGET/etc/gtk-2.0/gtk.immodules.temp && + mv $TARGET/etc/gtk-2.0/gtk.immodules.temp $TARGET/etc/gtk-2.0/gtk.immodules && + +./gtk-zip.sh && + +mv /tmp/${MOD}-${VER}.zip /tmp/$RUNZIP && +mv /tmp/${MOD}-dev-${VER}.zip /tmp/$DEVZIP + +) 2>&1 | tee /devel/src/tml/packaging/$THIS.log + +(cd /devel && zip /tmp/$DEVZIP src/tml/packaging/$THIS.{sh,log}) && +manifestify /tmp/$RUNZIP /tmp/$DEVZIP + +You should not just copy the above blindly. There are some things in +the script that are very specific to *my* build setup on *my* current +machine. For instance the "latest" command, the "usedev" and +"usemsvs6" shell functions, the /devel/dist folder. The above script +is really just meant for reference, to give an idea. You really need +to understand what things like PKG_CONFIG_PATH are and set them up +properly after installing the dependencies before building GTK+. + +As you see above, after running configure, one can just say "make +install", like on Unix. A post-build fix is needed, running +gdk-pixbuf-query-loaders once more to get a correct gdk-pixbuf.loaders +file. + +For a 64-bit build you need to remove the gtk/gtk.def file and let it +be regenerated by the makefilery. This is because the 64-bit GTK dll +has a slightly different list of exported function names. This is on +purpose and not a bug. The API is the same at the source level, and +the same #defines of some function names to actually have a _utf8 +suffix is used (just to keep the header simpler). But the +corresponding non-suffixed function to maintain ABI stability are not +needed in the 64-bit case (because there are no older EXEs around that +would require such for ABI stability). + + +2) Microsoft's tools +-------------------- + +Use the Microsoft compiler, cl and Make, nmake. Say nmake -f +makefile.msc in gdk and gtk. Be prepared to manually edit various +makefile.msc files, and the makefile snippets in build/win32. + +There are also VS 2008/2010 solution and project files to build GTK+, which +are maintained by Chun-wei Fan. They should build GTK+ out of the box, +provided that the afore-mentioned dependencies are installed. They will +build GDK with the Win32 backend, GTK+ itself (with GAIL/a11y built in), +the GAIL-Util library and the gtk-demo program. + +Please refer to the following GNOME Live! page for a more detailed ouline +on the process of building the GTK+ stack and its dependencies with Visual +C++: + +https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack + +Alternative 1 also generates Microsoft import libraries (.lib), if you +have lib.exe available. It might also work for cross-compilation from +Unix. + +I (Tor) use method 1 myself. Hans Breuer has been taking care of the MSVC +makefiles. At times, we disagree a bit about various issues, and for +instance the makefile.msc files might not produce identically named +DLLs and import libraries as the "autoconfiscated" makefiles and +libtool do. If this bothers you, you will have to fix the makefiles. + +Using GTK+ on Win32 +=================== + +To use GTK+ on Win32, you also need either one of the above mentioned +compilers. Other compilers might work, but don't count on it. Look for +prebuilt developer packages (DLLs, import libraries, headers) on the +above website. + +Multi-threaded use of GTK+ on Win32 +=================================== + +Multi-threaded GTK+ programs might work on Windows in special simple +cases, but not in general. Sorry. If you have all GTK+ and GDK calls +in the same thread, it might work. Otherwise, probably not at +all. Possible ways to fix this are being investigated. + +Wintab +====== + +The tablet support uses the Wintab API. The Wintab development kit is +no longer required. The wintab.h header file is bundled with GTK+ +sources. Unfortunately it seems that only Wacom tablets come with +support for the Wintab API nowadays. + +--Tor Lillqvist , +--Updated by Fan, Chun-wei