wxWidgets/docs/msw/msys2-gtk.txt
Tim S d88e110256 Added samples to test to wxGTK MSys2 directions.
Also, added option "--disable-precomp-headers".
And, changed MSys2 packages to install.
2017-03-07 12:47:35 -05:00

97 lines
3.3 KiB
Plaintext

Building wxGTK port with Win32 MSys2 GDK backend
------------------------------------------------
GTK+ widget toolkit has multiple GDK backends and one of them is Win32.
It is a wrapper around Windows API.
These notes don't consider building wxGTK with X11 backend under Windows.
The MSys2 website is http://www.msys2.org/
These building steps are NOT the normal way to build MSys2 MinGW packages.
But, they are a way the wxWidgets developers can test that wxWidgets
can build the wxGTK/Win32 libraries under MSys2 MinGW.
For the MSys2 way please see https://github.com/Alexpux/MINGW-packages
Building steps:
#Note: The "#" is used in front of a comment to help the people who cut
# and paste these directions.
#Warning: At the time these directions were written the GTK version 3
# was NOT able to create wxGTK/Win32 libraries that were usable.
#1. Install the mingw32 packages needed to build wxGTK/Win32 using the
# configure/make build method.
# From the MSys2 prompt or MSys2 MinGW prompt:
# The 32 bit Mingw packages are prefixed with "mingw-w64-i686-";
# Change the prefix to "mingw-w64-x86_64-" if you wish to do 64 bit.
pacman -S make
pacman -S mingw-w64-i686-cppunit
pacman -S mingw-w64-i686-libjpeg-turbo
pacman -S mingw-w64-i686-libpng
pacman -S mingw-w64-i686-libtiff
pacman -S mingw-w64-i686-gcc
pacman -S mingw-w64-i686-pkg-config
## gtk2 can take a long time to update/find fonts
pacman -S mingw-w64-i686-gtk2
# Packages that are needed but are normally installed already.
pacman -S mingw-w64-i686-gcc-libs
pacman -S mingw-w64-i686-expat
pacman -S mingw-w64-i686-xz
pacman -S mingw-w64-i686-zlib
pacman -S mingw-w64-i686-gdk-pixbuf2
#2. Build the wxGTK/Win32 static library
#2a.Open MSys2 MinGW Prompt
# (These steps were tested on MinGW32; but, should work under MinGW64)
#2b.Use the cd command to change directory to the wxWidgets top folder.
#2c.Create the "build-gtk2-static" folder to build the static libraries
mkdir -p build-gtk2-static
#2d.Configure wxWidgets
# Option "--disable-precomp-headers" is NOT needed.
# I am doing it to check for compile issues;
# And, I think my old 32 bit Windows machine
# works best with it disabled.
cd build-gtk2-static && \
../configure --with-gtk=2 \
--disable-shared \
--disable-precomp-headers \
&& cd ..
#2e.make the wxGTK static libraries
cd build-gtk2-static && make && cd ..
#3 Build and run the minimal static sample
#3a.Build the minimal sample
cd build-gtk2-static/samples/minimal && make && cd ../../..
#3b.Run the minimal sample
./build-gtk2-static/samples/minimal/minimal.exe
#4 Build and run the typetest static sample to verify MIME database works
cd build-gtk2-static/samples/typetest && make && cd ../../..
./build-gtk2-static/samples/typetest/typetest.exe
#5 Build and run the drawing static sample
cd build-gtk2-static/samples/drawing && make && cd ../../..
cd samples/drawing && ../../build-gtk2-static/samples/drawing/drawing.exe && cd ../..
#6 Build and run the splash static sample
cd build-gtk2-static/samples/splash && make && cd ../../..
cd samples/splash && ../../build-gtk2-static/samples/splash/splash.exe && cd ../..
#7 Build and run the widgets static sample
cd build-gtk2-static/samples/widgets && make && cd ../../..
cd samples/widgets && ../../build-gtk2-static/samples/widgets/widgets.exe && cd ../..