Skip to content

Commit

Permalink
mxe documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
elpaso committed Oct 13, 2018
1 parent 219a4be commit f56e3dd
Showing 1 changed file with 24 additions and 10 deletions.
34 changes: 24 additions & 10 deletions doc/mxe.t2t
Original file line number Diff line number Diff line change
@@ -1,26 +1,40 @@

== Building on Linux with mxe ==

With this approach you can build a windows binary on Linux using mxe MXE (M cross environment).
You can find the build script and a README file in the ms-windows/mxe directory.
With this approach you can cross build a Windows binary on Linux using MXE (M cross environment).
You can find the build script and a README.md file in the ms-windows/mxe directory.

For now, Python buildings cannot be built with mxe.

=== Initial setup ===
=== Building with Docker ===

This is the simplest way, but you need to have Docker installed
on your system.

You can use a Docker image to cross build QGIS by calling
the script ms-windows/mxe/build.sh from the root directory of QGIS repository.

=== Building without Docker ====

This requires to install mxe toolchain on your system and build
all dependencies by yourself.

==== Initial setup ====

Please follow the instructions on mxe website to setup your building toolchain http://mxe.cc/,
take note of the path where you have installed mxe.

=== Building the dependencies ===
==== Building the dependencies ====

Please see the README under ms-windows/mxe for a list of the dependencies that need to be
built in mxe before attempting to build QGIS.
Please see README.md under ms-windows/mxe for detailed instructions and for the
list of dependencies that need to be built in mxe before attempting to build QGIS.

=== Cross-Building QGIS ===
==== Cross-Building QGIS ====

Edit the build-mxe.sh script and change the path where your mxe installation is located, you
can also change the build and release directory.
Edit the build-mxe.sh script and optionally adjust the path where your mxe installation is located, you
can also change the build and release directories.

=== Testing QGIS ===

Copy and unzip the release package on a Windows machine and launch it!
Copy and unzip on the Windows machine package produced by the build and launch the qgis binary: no installation
is required.

0 comments on commit f56e3dd

Please sign in to comment.