Skip to content

Build wxWidgets from sources


CodeLite uses MSYS2 for installing compiler and other tools:

  • Prepare a working terminal with all the tools required as described here
  • Open MSYS2 terminal, and clone wxWidgets sources and build them:
git clone
cd ~/wxWidgets
git submodule update --init
cd build/mswu
# create a setup.h file
mingw32-make -f makefile.gcc setup_h SHARED=1 UNICODE=1 BUILD=release VENDOR=cl

CodeLite requires a wxWidgets build which enables Graphic Context, Direct2D and wxUSE_SOCKET2 all enabled

To do so:

  • Open the file ~/wxWidgets/lib/gcc_dll/setup.h in your editor
  • Make sure that wxUSE_GRAPHICS_CONTEXT, wxUSE_GRAPHICS_DIRECT2D and wxUSE_SOCKET2 are all set to 1 (if not, change it)

Start the build process (from within the MSYS2 terminal):

cd ~/wxWidgets/build/mswu
mingw32-make -j$(nproc) -f Makefile.gcc SHARED=1 UNICODE=1 BUILD=release VENDOR=cl CXXFLAGS="-fno-keep-inline-dllexport -std=c++11"


if you need a Debug build of wxWidgets, follow the above steps and replace any occurrence of BUILD=releaseBUILD=debug


To build wxWidgets on you computer you will need these packages:

  • The gtk development package: for GTK+2 it's often called libgtk2.0-dev or similar; for GTK3, libgtk-3-dev
  • pkg-config (which usually comes with the gtk dev package)
  • The build-essential package (or the relevant bit of it: g++, make etc)
  • git
  • cmake

Use the following command to install the prerequisites for Ubuntu 18.04:

sudo apt-get install libgtk-3-dev \
                     pkg-config \
                     build-essential \
                     git \
                     cmake \
                     libsqlite3-dev \
                     libssh-dev \
                     libedit-dev \
                     libhunspell-dev \
                     clang-format-8 \


If your distro provides a newer version of clang-format, install it. The higher, the better

mkdir /home/$USER/devl
cd /home/$USER/devl
git clone
cd /home/$USER/devl/wxWidgets
git submodule init
git submodule update
mkdir build-release-gtk3
cd build-release-gtk3
../configure --disable-debug_flag --with-gtk=3
make -j$(nproc) && sudo make install

GTK2 (Obsolete)

mkdir /home/$USER/devl
cd /home/$USER/devl
git clone
cd /home/$USER/devl/wxWidgets
git submodule init
git submodule update
mkdir build-release
cd build-release
../configure --disable-debug_flag
make -j$(nproc) && sudo make install



  • Install Homebrew
  • Install cmake
  • Install git
  • Install latest Xcode from Apple
  • Install the Command Line Tools (open XcodePreferencesDownloads and install the command line tools). This will place clang/clang++ in the default locations /usr/bin
  • Download wxWidgets sources

Build wxWidgets

cd /Users/$USER/src/wx-src/
mkdir build-release
cd build-release
../configure --enable-shared --enable-monolithic --with-osx_cocoa CXX='clang++ -std=c++11 -stdlib=libc++' CC=clang --disable-debug --disable-mediactrl
make -j8
sudo make install