setupmxe_howto

Building using the SetupMXE and BuildMXE scripts

This document describes how to build Fldigi binaries and installer for Windows 2000 or later, using the setupmxe.sh and buildmxe.sh scripts.
Fldigi developers prefer to use a toolchain that runs on Linux and compiles for Windows, and so this is the approach shown here.

The cross-compiler used here is mingw-gcc and the build instructions have been tested with the version packaged (as mingw32) in recent releases of Debian and Ubuntu. For OpenSuse, the cross-compiler package is mingw32-cross-gcc-c++ in its most recent release.

This build-procedure has been tested to work on the following Linux distributions:
Fedora, Mint, Ubuntu, Debian, MXLinux, and OpenSuse

The instructions on this page should be followed from top to bottom.

---

Build dependencies

Fldigi

The scripts to auto-bootstrap the MXE environment and auto-build Fldigi
for Windows are contained within the normal Fldigi git-archive .

1. Download the sourcecode of the version of Fldigi you wish to compile
2. Unzip / uncompress the sourcecode
3. Open a terminal / console
4. In terminal, go to the unzipped Fldigi sub-directory: scripts

---

Bootstrapping the MXE Environment

NOTE: This MXE environment only needs to be setup once per-user on a Linux system.
The crossbuild environment is installed to the user's $HOME directory, for re-use

Install OS Packages

Automatically install the required OS packages and dependencies for Fldigi and MXE:

sudo ./setupmxe.sh packages

Build MXE crossbuild environment

Download and bootstrap the MXE environment to the user's $HOME directory

./setupmxe.sh setup32

Note: This may take a few hours of downloading and compiling

---

Cross-Building for Windows OS

Build the Windows binaries and installer
This script automatically uses the MXE environment installed above (if found).

./buildmxe.sh

The executabiles will be in the Fldigi /src directory.

Any commandline options given to buildmxe.sh are passed to the ./configure script.
Useful for compiling --enable-debug and other test-versions.

---

---

Post Install Options

Re-Using the MXE Environment

The auto-installed MXE Environment can be re-used across different versions of Fldigi.
No need to re-bootstrap for new Fldigi releases, can simply call: /scripts/buildmxe.sh

Deleting an installed MXE Environment

To delete or cleanup an installed MXE crossbuild environment run:

./setupmxe.sh clean

---

Acknowledgements

The setupmxe.sh script is a combined automated version of the following manual instructions:
- Building with MinGW - Window target
- Build WIN32 Installation Files on Fedora Linux
- https://sourceforge.net/p/fldigi/wiki/mingw_howto_fedora/

Special thanks to David Freese and Robert Shaw for the original manual build-instructions