Merge branch 'gtk-docs'
Update wxGTK README and install instructions for 21st century. See https://github.com/wxWidgets/wxWidgets/pull/2132
This commit is contained in:
@@ -46,8 +46,6 @@ starting with 3.1.4. Use @c configure option @c \--with-gtk=2 to use GTK 2.
|
||||
|
||||
@subpage plat_gtk_install "Build and Install Instructions"
|
||||
|
||||
@subpage plat_gtk_overview "wxWidgets on the GNOME Desktop"
|
||||
|
||||
|
||||
|
||||
@section page_port_wxosx wxOSX/Cocoa
|
||||
|
@@ -3,18 +3,6 @@ wxWidgets for GTK installation {#plat_gtk_install}
|
||||
|
||||
[TOC]
|
||||
|
||||
IMPORTANT NOTE:
|
||||
|
||||
If you experience problems installing, please re-read these
|
||||
instructions and other related files (todo.txt, bugs.txt and
|
||||
osname.txt for your platform if it exists) carefully before
|
||||
mailing wxwin-users or the author. Preferably, try to fix the
|
||||
problem first and then send a patch to the author.
|
||||
|
||||
When sending bug reports tell us what version of wxWidgets you are
|
||||
using (including the beta) and what compiler on what system. One
|
||||
example: wxGTK 3.0.5, GCC 9.3.1, Fedora 31
|
||||
|
||||
Installation {#gtk_install}
|
||||
============
|
||||
|
||||
@@ -23,7 +11,7 @@ The simplest case {#gtk_simple}
|
||||
-------------------
|
||||
|
||||
If you compile wxWidgets on Linux for the first time and don't like to read
|
||||
install instructions just do (in the base dir):
|
||||
install instructions just do the following in wxWidgets directory:
|
||||
|
||||
> mkdir buildgtk
|
||||
> cd buildgtk
|
||||
@@ -47,70 +35,39 @@ If you want to remove wxWidgets on Unix you can do this:
|
||||
Note that by default, GTK 3 is used. GTK 2 can be specified
|
||||
with --with-gtk=2.
|
||||
|
||||
The expert case {#gtk_expert}
|
||||
-----------------
|
||||
If you use CMake, please see @ref overview_cmake for
|
||||
building wxWidgets using it.
|
||||
|
||||
If you want to do some more serious cross-platform programming with wxWidgets,
|
||||
such as for GTK and Motif, you can now build two complete libraries and use
|
||||
them concurrently. To do this, create a separate directory for each build
|
||||
of wxWidgets - you may also want to create different versions of wxWidgets
|
||||
and test them concurrently. Most typically, this would be a version configured
|
||||
with --enable-debug and one without.
|
||||
|
||||
For building three versions (one GTK, one Motif and a debug version of the GTK
|
||||
source) you'd do this:
|
||||
Troubleshooting {#gtk_errors_simple}
|
||||
---------------
|
||||
|
||||
mkdir buildmotif
|
||||
cd buildmotif
|
||||
../configure --with-motif
|
||||
make
|
||||
cd ..
|
||||
IMPORTANT NOTE:
|
||||
|
||||
mkdir buildgtk
|
||||
cd buildgtk
|
||||
../configure --with-gtk
|
||||
make
|
||||
cd ..
|
||||
When sending bug reports tell us what version of wxWidgets you are
|
||||
using (including the beta) and what compiler on what system. One
|
||||
example: wxGTK 3.0.5, GCC 9.3.1, Fedora 31.
|
||||
|
||||
mkdir buildgtkd
|
||||
cd buildgtkd
|
||||
../configure --with-gtk --enable-debug
|
||||
make
|
||||
cd ..
|
||||
|
||||
Note that you can install all those libraries concurrently, you just need to
|
||||
pass the appropriate flags when using them.
|
||||
|
||||
The simplest errors {#gtk_errors_simple}
|
||||
---------------------
|
||||
|
||||
For any configure errors: please look at config.log file which was generated
|
||||
For any configure errors: please look at `config.log` file which was generated
|
||||
during configure run, it usually contains some useful information.
|
||||
|
||||
configure reports, that you don't have GTK 1.2/2.0/3.0 installed although you
|
||||
are very sure you have. Well, you have installed it, but you also have another
|
||||
version of the GTK installed, which you may need to remove including other
|
||||
versions of glib (and its headers). Or maybe you installed it in a non-default
|
||||
location and configure can't find it there, so please check that your PATH
|
||||
variable includes the path to the correct gtk-config/pkg-config. Also check
|
||||
that your LD_LIBRARY_PATH or equivalent variable contains the path to GTK
|
||||
libraries if they were installed in a non-default location.
|
||||
If configure reports that you don't have GTK installed, please
|
||||
check that the appropriate _development_ package is available on
|
||||
your system and not just the GTK libraries themselves. You can
|
||||
use `pkg-config --modversion gtk+-3.0` (or `2.0`) to check that
|
||||
this is the case.
|
||||
|
||||
You get errors from make: please use GNU make instead of the native make
|
||||
program. Currently wxWidgets can be built only with GNU make, BSD make and
|
||||
Solaris make. Other versions might work or not (any which don't have VPATH
|
||||
support definitely won't).
|
||||
Solaris make. Other versions might work or not.
|
||||
|
||||
You get errors during compilation: The reason is that you probably have a
|
||||
broken compiler. GCC 2.8 and earlier versions and egcs are likely to cause
|
||||
problems due to incomplete support for C++ and optimisation bugs. Best to use
|
||||
GCC 2.95 or later.
|
||||
You get immediate crashes when starting any sample or application: This may
|
||||
be due to having compiled the library with different flags or
|
||||
compiler options than your program or using the headers from a
|
||||
different version of the library that is being used during
|
||||
run-time. If you have multiple versions of wxWidgets installed,
|
||||
please try uninstalling the ones you don't need and rebuilding.
|
||||
|
||||
You get immediate segfault when starting any sample or application: This is
|
||||
either due to having compiled the library with different flags or options than
|
||||
your program - typically you might have the `__WXDEBUG__` option set for the
|
||||
library but not for your program - or due to using a compiler with optimisation
|
||||
bugs.
|
||||
|
||||
The simplest program {#gtk_simple_app}
|
||||
----------------------
|
||||
@@ -119,90 +76,43 @@ Now create your super-application myfoo.cpp and compile anywhere with
|
||||
|
||||
g++ myfoo.cpp `wx-config --libs --cxxflags` -o myfoo
|
||||
|
||||
GUI libraries {#gtk_libs_gui}
|
||||
---------------
|
||||
|
||||
wxWidgets/GTK requires the GTK library to be installed on your system.
|
||||
|
||||
You can get the newest version of GTK from the GTK homepage at:
|
||||
|
||||
http://www.gtk.org
|
||||
|
||||
Additional libraries {#gtk_libs_misc}
|
||||
----------------------
|
||||
|
||||
wxWidgets/Gtk requires a thread library and X libraries known to work with
|
||||
threads. This is the case on all commercial Unix-Variants and all
|
||||
Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
|
||||
many aspects. As of writing this, virtually all Linux distributions have
|
||||
correct glibc 2 support.
|
||||
|
||||
You can disable thread support by running
|
||||
|
||||
./configure --disable-threads
|
||||
make
|
||||
su <type root password>
|
||||
make install
|
||||
ldconfig
|
||||
exit
|
||||
|
||||
Building wxGTK on Cygwin {#gtk_cygwin}
|
||||
--------------------------
|
||||
|
||||
The normal build instructions should work fine on Cygwin. The one difference
|
||||
with Cygwin is that when using the "--enable-shared" configure option (which
|
||||
is the default) the API is exported explicitly using __declspec(dllexport)
|
||||
is the default) the API is exported explicitly using `__declspec(dllexport)`
|
||||
rather than all global symbols being available.
|
||||
|
||||
This shouldn't make a difference using the library and should be a little
|
||||
more efficient. However if an export attribute has been missed somewhere you
|
||||
will see linking errors. If this happens then you can work around the
|
||||
problem by setting LDFLAGS=-Wl,--export-all-symbols. Please also let us know
|
||||
problem by setting `LDFLAGS=-Wl,--export-all-symbols`. Please also let us know
|
||||
about it on the wx-dev mailing list.
|
||||
|
||||
Create your configuration {#gtk_config}
|
||||
---------------------------
|
||||
|
||||
Usage:
|
||||
|
||||
./configure options
|
||||
|
||||
If you want to use system's C and C++ compiler,
|
||||
set environment variables CC and CXX as
|
||||
|
||||
% setenv CC cc
|
||||
% setenv CXX CC
|
||||
% ./configure [options]
|
||||
|
||||
to see all the options please use:
|
||||
|
||||
./configure --help
|
||||
|
||||
It is recommended to build wxWidgets in another directory (maybe a
|
||||
subdirectory of your wxWidgets installation) as this allows you to
|
||||
have multiple configurations (for example, debug and release or GTK
|
||||
and Motif) simultaneously.
|
||||
|
||||
|
||||
General options {#gtk_options}
|
||||
Configure options {#gtk_options}
|
||||
-----------------
|
||||
|
||||
Given below are the commands to change the default behaviour,
|
||||
i.e. if it says "--disable-threads" it means that threads
|
||||
are enabled by default.
|
||||
This section documents some of the most important configure
|
||||
options. It is not exhaustive, please refer to `configure --help`
|
||||
for the full list of options.
|
||||
|
||||
Normally, you won't have to choose a toolkit, because when
|
||||
you download wxGTK, it will default to --with-gtk etc. But
|
||||
if you use the git repository you have to choose a toolkit.
|
||||
You must do this by running configure with either of:
|
||||
Note that the options documented below are given in the form
|
||||
indicating how to change the default behaviour, i.e. if it says
|
||||
"--disable-optimise" it means that optimizations are enabled by
|
||||
default.
|
||||
|
||||
--with-gtk=3 Use GTK 3. Default.
|
||||
--with-gtk=2 Use GTK 2.
|
||||
--with-gtk=1 Use GTK 1.2.
|
||||
All standard configure options are supported, e.g. you can choose
|
||||
`--prefix` to select the directory to install the libraries to.
|
||||
Also note that cross-compiling is fully supported, just specify
|
||||
the `--host` option as usual (please refer to autoconf manual for
|
||||
more information).
|
||||
|
||||
The following options handle the kind of library you want to build.
|
||||
|
||||
--disable-threads Compile without thread support.
|
||||
The following options can be used to specify the kind and number
|
||||
of libraries to build:
|
||||
|
||||
--disable-shared Do not create shared libraries, but
|
||||
build static libraries instead.
|
||||
@@ -211,16 +121,61 @@ The following options handle the kind of library you want to build.
|
||||
of as several smaller libraries (which is
|
||||
the default since wxWidgets 2.5.0).
|
||||
|
||||
--disable-optimise Do not optimise the code. Can
|
||||
sometimes be useful for debugging
|
||||
and is required on some architectures
|
||||
such as Sun with gcc 2.8.X which
|
||||
would otherwise produce segvs.
|
||||
Options for third party dependencies: wxWidgets may use other
|
||||
libraries present on the current system. For some of these
|
||||
libraries, wxWidgets also provides built-in versions, that can be
|
||||
linked into wx libraries themselves, which can be useful to
|
||||
minimize external dependencies.
|
||||
|
||||
--enable-unicode Enable Unicode support.
|
||||
--disable-sys-libs Don't use system libraries at all.
|
||||
Use built-in ones when possible or
|
||||
disable support for the corresponding
|
||||
feature otherwise.
|
||||
|
||||
--enable-profile Add profiling info to the object
|
||||
files. Currently broken, I think.
|
||||
--without-libpng Disables PNG image format code.
|
||||
Don't use libpng (although GTK
|
||||
itself still uses it).
|
||||
|
||||
--without-libjpeg Disables JPEG image format code.
|
||||
Don't use libjpeg.
|
||||
|
||||
--without-libtiff Disables TIFF image format code.
|
||||
Don't use libtiff.
|
||||
|
||||
--without-expat Disable XML classes based on Expat parser.
|
||||
Don't use expat library.
|
||||
|
||||
--without-liblzma Disable LZMA compression support.
|
||||
Don't use liblzma.
|
||||
|
||||
--without-opengl Disable OpenGL integration with wxGLCanvas.
|
||||
Don't use OpenGL or EGL libraries.
|
||||
|
||||
--disable-glcanvasegl Disable EGL support even if it is available
|
||||
(it would be used if it is, by default).
|
||||
|
||||
--disable-mediactrl Disable wxMediaCtrl.
|
||||
Don't use GStreamer libraries.
|
||||
|
||||
--disable-webview Disable wxWebView.
|
||||
Don't use webkit2gtk and its multiple
|
||||
dependencies.
|
||||
|
||||
Normally, you won't have to choose a toolkit, because configure
|
||||
defaults to wxGTK anyhow. However you need to use this option to
|
||||
explicitly specify the version of GTK to use, e.g.:
|
||||
|
||||
--with-gtk=3 Use GTK 3. Default.
|
||||
--with-gtk=2 Use GTK 2.
|
||||
--with-gtk=1 Use GTK 1.2. Obsolete.
|
||||
|
||||
Some other general compilation options:
|
||||
|
||||
--disable-optimise Do not optimise the code. Can be useful
|
||||
for debugging but shouldn't be used
|
||||
for production builds.
|
||||
|
||||
--disable-unicode Disable Unicode support. Not recommended.
|
||||
|
||||
--enable-no_rtti Enable compilation without creation of
|
||||
C++ RTTI information in object files.
|
||||
@@ -230,18 +185,7 @@ The following options handle the kind of library you want to build.
|
||||
--enable-no_exceptions Enable compilation without creation of
|
||||
C++ exception information in object files.
|
||||
This will speed-up compilation and reduce
|
||||
binary size. Also fewer crashes during the
|
||||
actual compilation...
|
||||
|
||||
--enable-permissive Enable compilation without checking for strict
|
||||
ANSI conformance. Useful to prevent the build
|
||||
dying with errors as soon as you compile with
|
||||
Solaris' ANSI-defying headers.
|
||||
|
||||
--enable-mem_tracing Add built-in memory tracing.
|
||||
|
||||
--enable-dmalloc Use the dmalloc memory debugger.
|
||||
Read more at www.letters.com/dmalloc/
|
||||
binary size.
|
||||
|
||||
--enable-debug_info Add debug info to object files and
|
||||
executables for use with debuggers
|
||||
@@ -261,22 +205,9 @@ The following options handle the kind of library you want to build.
|
||||
option instead of --enable-debug_info/flag ones
|
||||
separately.
|
||||
|
||||
Feature Options {#gtk_feature_options}
|
||||
-----------------
|
||||
|
||||
When producing an executable that is linked statically with wxGTK
|
||||
you'll be surprised at its immense size. This can sometimes be
|
||||
drastically reduced by removing features from wxWidgets that
|
||||
are not used in your program. The most relevant such features
|
||||
are
|
||||
|
||||
--without-libpng Disables PNG image format code.
|
||||
|
||||
--without-libjpeg Disables JPEG image format code.
|
||||
|
||||
--without-libtiff Disables TIFF image format code.
|
||||
|
||||
--without-expat Disable XML classes based on Expat parser.
|
||||
To reduce the final libraries (or executables, when linking
|
||||
statically) size, many wxWidgets features may be disabled. Here
|
||||
is a list of some of them:
|
||||
|
||||
--disable-pnm Disables PNM image format code.
|
||||
|
||||
@@ -296,8 +227,6 @@ are
|
||||
|
||||
--disable-clipboard Disables Clipboard.
|
||||
|
||||
--disable-serial Disables object instance serialisation.
|
||||
|
||||
--disable-streams Disables the wxStream classes.
|
||||
|
||||
--disable-file Disables the wxFile class.
|
||||
@@ -308,82 +237,64 @@ are
|
||||
|
||||
--disable-validators Disables validators.
|
||||
|
||||
--disable-accel Disables accelerators support.
|
||||
|
||||
Apart from disabling certain features you can very often "strip"
|
||||
the program of its debugging information resulting in a significant
|
||||
reduction in size.
|
||||
|
||||
Please see the output of "./configure --help" for comprehensive list
|
||||
of all configurable options.
|
||||
Please remember that the full list of options can be seen in
|
||||
`configure --help` output.
|
||||
|
||||
|
||||
Compiling {#gtk_compling}
|
||||
-----------
|
||||
|
||||
The following must be done in the base directory (e.g. ~/wxGTK
|
||||
or ~/wxWin or whatever)
|
||||
Building the libraries {#gtk_compling}
|
||||
----------------------
|
||||
|
||||
Now the makefiles are created (by configure) and you can compile
|
||||
the library by typing:
|
||||
|
||||
make
|
||||
|
||||
make yourself some coffee, as it will take some time. On an old
|
||||
386SX possibly two weeks. During compilation, you'll get a few
|
||||
warning messages depending in your compiler.
|
||||
|
||||
If you want to be more selective, you can change into a specific
|
||||
directory and type "make" there.
|
||||
After running configure, just run `make` from the same directory.
|
||||
Building can take some time and it's strongly recommended to use
|
||||
`--jobs` option with GNU make, e.g. `make -j8` if you have 8
|
||||
logical CPU cores.
|
||||
|
||||
Then you may install the library and its header files under
|
||||
/usr/local/include/wx and /usr/local/lib respectively. You
|
||||
have to log in as root (i.e. run "su" and enter the root
|
||||
password) and type
|
||||
`/usr/local/include/wx` and `/usr/local/lib` respectively. You
|
||||
have to perform the following command as root, using either `su`
|
||||
or `sudo`:
|
||||
|
||||
make install
|
||||
|
||||
You can remove any traces of wxWidgets by typing
|
||||
After installing, you can run `make clean` in the original
|
||||
directory or just remove it entirely if you don't plan to build
|
||||
wxWidgets again in the near future.
|
||||
|
||||
make uninstall
|
||||
Note that installing the library is _not_ required and it can
|
||||
also be used from the build directory by simply specifying the
|
||||
full path to `wx-config` script located in it when building your
|
||||
application.
|
||||
|
||||
If you want to save disk space by removing unnecessary
|
||||
object-files:
|
||||
|
||||
make clean
|
||||
Building your project {#gtk_new_project}
|
||||
---------------------
|
||||
|
||||
in the various directories will do the work for you.
|
||||
|
||||
Creating a new Project {#gtk_new_project}
|
||||
--------------------------
|
||||
|
||||
1. The first way uses the installed libraries and header files
|
||||
automatically using wx-config
|
||||
You need to use the compilation flags returned by `wx-config
|
||||
--cxxflags` and linking flags returned by `wx-config --libs`,
|
||||
which may be combined into a single invocation:
|
||||
|
||||
g++ myfoo.cpp `wx-config --cxxflags --libs` -o myfoo
|
||||
|
||||
Using this way, a make file for the minimal sample would look
|
||||
like this
|
||||
A simple makefile for a program using wxWidgets could be written
|
||||
in the following way (note that if you are copying and pasting
|
||||
this into your makefile, the leading spaces must be replaced by a
|
||||
`TAB` character):
|
||||
|
||||
CXX = g++
|
||||
```make
|
||||
program: program.o
|
||||
$(CXX) -o program program.o `wx-config --libs`
|
||||
|
||||
minimal: minimal.o
|
||||
$(CXX) -o minimal minimal.o `wx-config --libs`
|
||||
program.o: program.cpp
|
||||
$(CXX) `wx-config --cxxflags` -c program.cpp -o program.o
|
||||
|
||||
minimal.o: minimal.cpp
|
||||
$(CXX) `wx-config --cxxflags` -c minimal.cpp -o minimal.o
|
||||
clean:
|
||||
$(RM) program.o program
|
||||
.PHONY: clean
|
||||
```
|
||||
|
||||
clean:
|
||||
rm -f *.o minimal
|
||||
|
||||
If your application uses only some of wxWidgets libraries, you can
|
||||
specify required libraries when running wx-config. For example,
|
||||
`wx-config --libs=html,core` will only output link command to link
|
||||
with libraries required by core GUI classes and wxHTML classes. See
|
||||
the manual for more information on the libraries.
|
||||
|
||||
2. The other way creates a project within the source code
|
||||
directories of wxWidgets. For this endeavour, you'll need
|
||||
GNU autoconf version 2.14 and add an entry to your Makefile.in
|
||||
to the bottom of the configure.in script and run autoconf
|
||||
and configure before you can type make.
|
||||
If your application uses only some of wxWidgets libraries, you can
|
||||
specify required libraries when running wx-config. For example,
|
||||
`wx-config --libs=html,core` will only output link command to link
|
||||
with libraries required by core GUI classes and wxHTML classes. See
|
||||
the manual for more information on the libraries.
|
||||
|
@@ -1,14 +1,8 @@
|
||||
List of classes which should use their native GTK+ equivalents but don't:
|
||||
|
||||
- wxSearchCtrl
|
||||
Should use GtkSearchEntry (GTK+ 3.6+)
|
||||
|
||||
- wxStatusBar:
|
||||
Problem with multiple fields, GtkStatusbar only seems to support one pane
|
||||
|
||||
- wxTreeCtrl
|
||||
Ryan Norton has implemented this
|
||||
|
||||
- wxListCtrl
|
||||
Could be reimplemeted in terms of wxDataViewCtrl?
|
||||
|
||||
@@ -19,9 +13,5 @@ List of classes which should use their native GTK+ equivalents but don't:
|
||||
supports both and can even change orientation at
|
||||
runtime.
|
||||
|
||||
- wxDatePickerCtrl
|
||||
- wxCalendarCtrl
|
||||
Use GtkCalendar
|
||||
|
||||
- wxWizard
|
||||
Can GtkAssistant be used?
|
||||
|
@@ -1,134 +0,0 @@
|
||||
# wxWidgets on the GNOME Desktop {#plat_gtk_overview}
|
||||
|
||||
wxWidgets is a C++ cross-platform GUI library, whose distintive feature is the
|
||||
use of native calls and native widgets on the respective platform, i.e. an
|
||||
application compiled for the Linux platform will use the [GTK+][] library for
|
||||
displaying the various widgets. There is also a version ("port") of wxWidgets
|
||||
which uses the Motif toolkit for displaying its widgets (this port is commonly
|
||||
referred to as wxMotif) and another one, which only uses X11 calls and which
|
||||
draws its widgets entirely itself, without using any outside library. This port
|
||||
is called wxX11 or sometimes more generally wxUniv (short for wxUniversal),
|
||||
since this widget set (implemented entirely within wxWidgets) is available
|
||||
wherever wxWidgets is available. Since this short overview is mainly about how
|
||||
to write wxWidgets applications for the [GNOME][] desktop, I will focus on the
|
||||
GTK+ port, which is generally referred to as wxGTK.
|
||||
|
||||
wxGTK still supports the old version GTK+ 1.2, but it now defaults to the
|
||||
up-to-date version GTK+ 2.X, which is the basis for the current GNOME desktop. By
|
||||
way of using GTK+ 2.X and its underlying text rendering library [Pango][], wxGTK
|
||||
fully supports the Unicode character set and it can render text in any language
|
||||
and script, that is supported by Pango.
|
||||
|
||||
[GTK+]: http://www.gtk.org/
|
||||
[GNOME]: https://www.gnome.org/
|
||||
[Pango]: http://www.pango.org/
|
||||
|
||||
## Design Principles
|
||||
|
||||
The three main design goals of the wxWidgets library are portability across the
|
||||
supported platforms, complete integration with the supported platforms and a
|
||||
broad range of functionality covering most aspects of GUI and non-GUI
|
||||
application programming. Sometimes, various aspects of these design goals
|
||||
contradict each other and this holds true especially for the Linux platform
|
||||
which – from the point of view of the desktop environment integration – is
|
||||
lagging behind the other two major desktops (Windows and OS X) mostly because of
|
||||
the schism between the GTK+ based GNOME desktop and the [Qt][] based [KDE][]
|
||||
desktop. So far, the typical wxWidgets user targeted Windows, maybe OS X and
|
||||
Linux _in general_, so the aim was to make wxGTK applications run as well as
|
||||
possible on as many versions of Linux as possible, including those using the KDE
|
||||
environment. Luckily, most of these distributions included the GTK+ library (for
|
||||
running applications like the GIMP, GAIM, Evolution or Mozilla) whereas the
|
||||
GNOME libraries were not always installed by default. Also, the GNOME libraries
|
||||
didn't really offer substantial value so that the hassle of installing them was
|
||||
hardly justified. Therefore, much effort was spent on making wxGTK fully
|
||||
functional without relying on the GNOME libraries, mostly by reimplementing as
|
||||
much as sensible of the missing functionality. This included a usable file
|
||||
selection dialog, a printing system for PostScript output, code for querying
|
||||
MIME-types and file-icon associations, classes for storing application
|
||||
preferences and configurations, the possibility to display mini-apps in the
|
||||
taskbar, a full-featured HTML based help system etc. With all that in place you
|
||||
can write a pretty fully featured wxWidgets application on an old Linux system
|
||||
with little more installed than X11 and GTK+.
|
||||
|
||||
[Qt]: http://www.qt.io/
|
||||
[KDE]: https://www.kde.org/
|
||||
|
||||
## Recent Developments
|
||||
|
||||
Recently, several key issues have been addressed by the GNOME project. Sometimes
|
||||
integrated into the newest GTK+ releases (such as the file selecter), sometimes
|
||||
as part of the GNOME libraries (such as the new printing system with Pango
|
||||
integration or the mime-types handling in gnome-vfs), sometimes as outside
|
||||
projects (such as the media/video backend based on the [Gstreamer][] project).
|
||||
Also, care has been taken to unify the look and feel of GNOME applications by
|
||||
writing down a number of rules (modestly called
|
||||
["Human Interface Guidelines"][GNOME-HIG]) and more and more decisions are taken
|
||||
in a desktop neutral way (for both GNOME and KDE), mostly as part of the
|
||||
[FreeDesktop][] initiative. This development together with the rising number of
|
||||
OpenSource projects using wxWidgets mainly for the Linux and more specifically
|
||||
GNOME desktop has led to a change of direction within the wxWidgets project, now
|
||||
working on making more use of GNOME features when present. The general idea is
|
||||
to call the various GNOME libraries if they are present and to offer a
|
||||
reasonable fallback if not. I'll detail on the various methods chosen below:
|
||||
|
||||
[Gstreamer]: http://gstreamer.freedesktop.org/
|
||||
[GNOME-HIG]: http://developer.gnome.org/projects/gup/hig
|
||||
[FreeDesktop]: http://www.freedesktop.org/
|
||||
|
||||
## Printing System
|
||||
|
||||
The old printing system ....
|
||||
|
||||
## MIME-type Handling
|
||||
|
||||
The old mime-type system used to simply query some files stored in "typical"
|
||||
locations for the respective desktop environment. Since both the format and the
|
||||
location of these files changed rather frequently, this system was never fully
|
||||
working as desired for reading the MIME-types and it never worked at all for
|
||||
writing MIME-types or icon/file associations. ...
|
||||
|
||||
## File Dialogs
|
||||
|
||||
Previously, wxGTK application made use of a file dialog written in wxWidgets
|
||||
itself, since the default GTK+ file dialog was simplistic to say the least. This
|
||||
has changed with version GTK+ 2.4, where a nice and powerful dialog has been
|
||||
added. wxGTK is using it now.
|
||||
|
||||
## File Configuration and Preferences
|
||||
|
||||
The usual Unix way of saving file configuration and preferences is to write and
|
||||
read a so called "dot-file", basically a text file in a user's home directory
|
||||
starting with a dot. This was deemed insufficient by the GNOME desktop project
|
||||
and therefore they introduced the so called GConf system, for storing and
|
||||
retrieving application and sessions information....
|
||||
|
||||
## Results and Discussion
|
||||
|
||||
One of wxWidgets' greatest merits is the ability to write an application that
|
||||
not only runs on different operating systems but especially under Linux even on
|
||||
rather old systems with only a minimal set of libraries installed – using a
|
||||
single application binary. This was possible since most of the relevant
|
||||
functionality was either located in the only required library (GTK+) or was
|
||||
implemented within wxWidgets. Recent development outside the actual GTK+ project
|
||||
has made it necessary to rethink this design and make use of other projects'
|
||||
features in order to stay up-to-date with current techological trends. Therefore,
|
||||
a system was implemented within wxWidgets that queries the system at runtime
|
||||
about various libraries and makes use of their features whenever possible, but
|
||||
falls back to a reasonable solution if not. The result is that you can create
|
||||
and distribute application binaries that run on old Linux systems and integrate
|
||||
fully with modern desktops, if they are available. This is not currently
|
||||
possible with any other software.
|
||||
|
||||
Copyright 2004 © Robert Roebling, MD. No reprint permitted without written prior
|
||||
authorisation. Last modified 14/11/04.
|
||||
|
||||
## About the Author
|
||||
|
||||
Robert Roebling works as a medical doctor in the Department of Neurology at the
|
||||
University clinic of Ulm in Germany. He has studied Computer Sciences for a few
|
||||
semesters and is involved in the wxWidgets projects since about 1996. He has
|
||||
started and written most of wxGTK port (beginning with GTK+ around 0.9) and has
|
||||
contributed to quite a number projects within wxWidgets, ranging from the image
|
||||
classes to Unicode support to making both the Windows and the GTK+ ports work on
|
||||
embedded platform (mostly PDAs). He is happily married, has two children and
|
||||
never has time.
|
@@ -1,35 +1,25 @@
|
||||
Welcome to wxWidgets for GTK+
|
||||
-----------------------------
|
||||
Welcome to wxWidgets for GTK
|
||||
----------------------------
|
||||
|
||||
You have downloaded the GTK+ port of the wxWidgets GUI library.
|
||||
You have downloaded the GTK port of the wxWidgets GUI library.
|
||||
|
||||
It is required to use at least GTK+ 2.6 and some features are
|
||||
only available when using GTK+ 2.10 or higher. Note that even if
|
||||
you compile wxWidgets against a later GTK+ version, your application
|
||||
will still work with older GTK+ version down to version 2.6 as wxWidgets
|
||||
tests for the presence of newer features at run-time and it
|
||||
will fall back to a generic implementation if these features
|
||||
are not present in the GTK+ version used.
|
||||
This port works best with GTK 3, but also supports versions as
|
||||
old as GTK 2.6 (although some features are only available when
|
||||
using GTK+ 2.10 or higher). Note that even if you compile
|
||||
wxWidgets against a later GTK version, your application will
|
||||
still work with older GTK versions with the same major version
|
||||
as wxWidgets tests for the presence of newer features at run-time
|
||||
and it will fall back to a generic implementation if these
|
||||
features are not present in the GTK version used.
|
||||
|
||||
wxWidgets 2.9.4 adds support for GTK+ 3, which can be enabled
|
||||
with configure option --with-gtk=3.
|
||||
|
||||
wxWidgets 2.8 still supports GTK+ 1.2, but no development
|
||||
is done on that port anymore and support for GTK+ 1.2 will
|
||||
probably be dropped entirely. Indeed, one of the major steps
|
||||
in the development cycle leading up to wxWidgets 2.8 was
|
||||
that the codebase for GTK+ 1.2 and GTK+ 2.0 were separated
|
||||
so that improvements and clean-ups to the GTK+ 2.0 port
|
||||
could be done without caring for GTK+ 1.2.
|
||||
|
||||
More info about the wxWidgets project (including all the
|
||||
More information about the wxWidgets project (including all the
|
||||
other ports and version of wxWidgets) can be found at the
|
||||
main wxWidgets homepage at:
|
||||
|
||||
https://www.wxwidgets.org/
|
||||
|
||||
Information on how to install can be found in the file
|
||||
INSTALL.txt, but if you cannot wait, this should work on
|
||||
install.md, but if you cannot wait, this should work on
|
||||
many systems:
|
||||
|
||||
mkdir build_gtk
|
||||
@@ -40,10 +30,8 @@ many systems:
|
||||
make install
|
||||
ldconfig
|
||||
|
||||
In order to use wxGTK with GTK 1.2 you need to use --with-gtk=1
|
||||
configure option. To build the library in Unicode mode (all
|
||||
strings will be wide strings and so on) you need to configure
|
||||
with GTK 2.0 and add --enable-unicode.
|
||||
In order to use wxGTK with GTK 2 you need to use --with-gtk=2
|
||||
configure option.
|
||||
|
||||
Please note that it is strongly advised to build the library in
|
||||
a separate directory, as shown above, as it allows you to have
|
||||
@@ -51,21 +39,8 @@ different builds of it (for example with and without debug) in
|
||||
parallel. If you build in the source directory, don't forget to
|
||||
do "make clean" before changing the configuration!
|
||||
|
||||
When you run into problems, please read the INSTALL.txt and
|
||||
follow those instructions. If you still don't have any success,
|
||||
please send a bug report to one of our mailing list, INCLUDING
|
||||
A DESCRIPTION OF YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR
|
||||
VERSION OF GTK, WXGTK, WHAT DISTRIBUTION YOU USE AND WHAT ERROR
|
||||
WAS REPORTED. I know this has no effect, but I tried...
|
||||
|
||||
Please send problems concerning installation, feature requests,
|
||||
bug reports or comments to the wxWidgets users list. These can
|
||||
be found at https://www.wxwidgets.org/support/mailing-lists/
|
||||
|
||||
wxWidgets doesn't come with any guarantee whatsoever. It
|
||||
might crash your harddisk or destroy your monitor. It doesn't
|
||||
claim to be suitable for any special or general purpose.
|
||||
|
||||
Regards,
|
||||
|
||||
Robert Roebling
|
||||
Please see the manual for further information.
|
||||
|
Reference in New Issue
Block a user