194 lines
6.5 KiB
Markdown
194 lines
6.5 KiB
Markdown
wxWidgets for Qt installation {#plat_qt_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: wxQt 3.1.0, GCC 4.8.1, Ubuntu 14.04
|
|
|
|
Installation {#qt_install}
|
|
============
|
|
|
|
The simplest case {#qt_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):
|
|
|
|
> mkdir buildqt
|
|
> cd buildqt
|
|
> ../configure --with-qt
|
|
> make
|
|
> su <type root password>
|
|
> make install
|
|
> ldconfig
|
|
|
|
[if you get "ldconfig: command not found", try using "/sbin/ldconfig"]
|
|
|
|
If you don't do the 'make install' part, you can still use the libraries from
|
|
the buildgtk directory, but they may not be available to other users.
|
|
|
|
If you want to remove wxWidgets on Unix you can do this:
|
|
|
|
> su <type root password>
|
|
> make uninstall
|
|
> ldconfig
|
|
|
|
The simplest errors {#qt_error_simple}
|
|
---------------------
|
|
|
|
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 Qt installed although you are very
|
|
sure you have. Well, you have installed it, but you also have another
|
|
version of the Qt installed, which you may need to remove. 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
|
|
qtconfig/pkg-config. Also check that your LD_LIBRARY_PATH or equivalent
|
|
variable contains the path to Qt libraries if they were installed in a
|
|
non-default location.
|
|
|
|
The simplest program {#qt_simple_app}
|
|
----------------------
|
|
|
|
Now create your super-application myfoo.cpp and compile anywhere with
|
|
|
|
g++ myfoo.cpp `wx-config --libs --cxxflags` -o myfoo
|
|
|
|
GUI libraries {#qt_libs_ui}
|
|
---------------
|
|
|
|
wxWidgets/Qt requires the Qt library to be installed on your system. It has
|
|
to be a stable version, preferably Qt 5.2.1 or later.
|
|
|
|
Building wxQT on Ubuntu {#qt_build_ubuntu}
|
|
-------------------------
|
|
|
|
Install latest Qt5 packages (qt5-default). To build unit tests, libcppunit-dev
|
|
is required. You will need to install other dependencies to compile wxWidgets
|
|
depending on the features you'll want to use (build-essential libjpeg-dev
|
|
libtiff5-dev ubuntu-restricted-extras freeglut3 freeglut3-dev libsdl1.2-dev
|
|
libgstreamer-plugins-base0.10-dev)
|
|
|
|
|
|
Then create a build directory, configure and compile:
|
|
|
|
mkdir bldqt5
|
|
cd bldqt5
|
|
../configure --with-qt --enable-debug
|
|
make
|
|
make samples
|
|
|
|
If everything is ok, you can do the make install as specified before.
|
|
|
|
Optionally, you can build and run Unit Tests:
|
|
|
|
cd tests
|
|
make
|
|
./test_gui
|
|
|
|
Building wxQT, using qt-unified-XXX-online installer {#qt_build}
|
|
------------------------------------------------------
|
|
|
|
Download qt-unified-XXX-online installer from the qt website.
|
|
Install the Qt package of your choice (with the same minimum version
|
|
restriction as above).
|
|
The same build instructions apply, except that you need to explicitly pass
|
|
to configure the Qt dir of the build intended to use as QT5_CUSTOM_DIR, i.e.
|
|
|
|
for Linux:
|
|
|
|
../configure --with-qt --enable-debug QT5_CUSTOM_DIR=~/Qt/5.11.0/gcc_64
|
|
|
|
for Windows (ran from Git Bash, or any other Unix-like shell):
|
|
(the syntax for the drive in the path is required by ar and ld)
|
|
|
|
../configure --with-qt --enable-debug QT5_CUSTOM_DIR=c:/Qt/5.11.0/mingw53_32
|
|
|
|
Building wxGT on Android {#qt_android}
|
|
--------------------------
|
|
|
|
Download Android Native Development Kit (NDK), tandalone Android Software
|
|
Development Kit (SDK), install them and perform the following instructions to
|
|
prepare the cross-compilation tool-chain to (change NDK and other paths):
|
|
|
|
NDK=~/src/android-ndk-r9d
|
|
SDK=~/src/android-sdk-linux
|
|
export ANDROID_NDK_ROOT=$NDK
|
|
$NDK/build/tools/make-standalone-toolchain.sh \
|
|
--toolchain=arm-linux-androideabi-4.8 --platform=android-9 \
|
|
--install-dir=/tmp/ndk
|
|
|
|
export PATH=/tmp/ndk/bin:$PATH
|
|
export CC=arm-linux-androideabi-gcc
|
|
export CXX=arm-linux-androideabi-g++
|
|
|
|
|
|
Also, you'll need to download the Qt library bundle that matches your operating
|
|
system installed package (5.2.1 in this case installed in ~/src/qt, you'll need
|
|
the android_armv5/ android_armv7/ android_x86/ pre-compiled folders to
|
|
cross-compile for that architectures)
|
|
|
|
Then, create a build directory (under the wxWidgets folder), configure for
|
|
Android (disable currently unsupported/unneeded features) and run make:
|
|
|
|
cd ~/src/wxWidgets
|
|
mkdir bldqt5droid
|
|
cd bldqt5droid
|
|
../configure --with-qt --enable-debug --build=x86_64-unknown-linux-gnu \
|
|
--host=arm-linux-androideabi --disable-compat28 --disable-shared \
|
|
--disable-arttango --enable-image --disable-dragimage --disable-sockets \
|
|
--with-libtiff=no --without-opengl --disable-baseevtloop --disable-utf8
|
|
make
|
|
|
|
You can now compile and link your app against this build, and finally
|
|
package it for Android using standard APK tools.
|
|
|
|
Create your configuration {#qt_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.
|
|
|
|
Feature Options {#qt_feature_options}
|
|
-----------------
|
|
|
|
When producing an executable that is linked statically with wxQt
|
|
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.
|
|
|
|
Please see the output of "./configure --help" for comprehensive list
|
|
of all configurable options.
|
|
|
|
Apart from disabling certain features you can very often "strip"
|
|
the program of its debugging information resulting in a significant
|
|
reduction in size.
|