Сборка из исходников wxWidgets под Windows, используя MinGW и makefile

В данной статье приводится инструкция, как собрать из исходников wxWidgets, используя GNU Make на Windows.

0. Для сборки нужен MinGW, в частности mingw32-make. Если он у вас имеется, то переходим к следующему этапу.
Если у вас сложности с установкой MinGW, то советую скачать архив со всем необходимым из сайта winlibs. Там рекомендую выбирать MinGW-w64 (UCRT) + GCC. Разархивируйте архив и укажите абсолютный путь к папке bin в Path.
Для удобства добавляем переменную среды.
Нажимаем Win+R и вводим команду SystemPropertiesAdvanced и далее нажимаем на Переменные окружения
Далее, в переменных системы ищем переменную Path и нажимаем Изменить.
Добавляем папку тулчейна. Например, в моем случае C:\msys64\ucrt64\bin.
В указанной папке должен быть файл mingw32-make.exe. Если нет, то вы неправильно установили тулчейн.

1. Заходим на официальный сайт wxWidgets и нажимает на Downloads


2. Скачиваем архив с исходниками (zip или 7z)


3. Разархивируем скачанные файлы, например, в корень диска С. Например, после этих действий у вас должна быть папка C:\wxWidgets-3.2.4

4. Переходим в папку C:\wxWidgets-3.2.4\build\msw\. Перед глазами должны быть разные файлы, среди которых makefile.gcc. Если вы его видите, то вы в правильной папке.

5. Кликаете на адресную строку в Проводнике, вводите команду cmd и нажимаете Enter.

Открывается командная строка, где выбран уже C:\wxWidgets-3.2.4\build\msw>

6. Далее, нужно прописать команду для сборки с помощью make

Команда состоит из двух частей:

Первая часть указывает на наш makefile:

mingw32-make -f makefile.gcc

Во второй части идут опции, которые нужно передать в зависимости от того, что вам нужно

BUILD=release (если вам нужна релизная сборка)
или
BUILD=debug (если нужна отладочная сборка)

SHARED=1 (говорит о том, что нужно генерировать DLL файлы для динамической линковки)
или
SHARED=0 (выбрана по умолчанию, можно даже не прописывать. Означает, что нужна версия со статической линковкой)

MONOLITHIC=1 (если нужно генерировать одну большую библиотеку вместо отдельных файлов)
Опция MONOLITHIC 1 используются только с SHARED 1

UNICODE=1 (выбрана по умолчанию, можно не прописывать. Означает, что нужно использовать юникод)
или
UNICODE=0 (использует ANSI)

Примечание: при сборке с опциями SHARED=1 MONOLITHIC=1 рекомендую также прописать
CXXFLAGS=-fno-keep-inline-dllexport
чтобы предотвратить нехватку оперативной памяти при сборке

В итоге, если презюмировать, что не отключаем включенный по умолчанию юникод, то возможны такие варианты:
Т.к. я предпочитаю всегда статическую линковку и мне достаточно релизной сборки, то я прописываю:

mingw32-make -f makefile.gcc SHARED=0 BUILD=release

т.е. в командной строке выглядит так

C:\wxWidgets-3.2.4\build\msw>mingw32-make -f makefile.gcc SHARED=0 BUILD=release


Далее нажимаю Enter и сборка начинается.

Процесс занимает много времени, которое зависит от вашего железа.
В конце нужно убедиться, что сборка прошла без ошибок.

***

Потом можно создать папку, например, wxWin куда скопировать из папки C:\wxWidgets-3.2.4 (папка с исходниками) две папки:
C:\wxWidgets-3.2.4\include
C:\wxWidgets-3.2.4\lib\

В итоге, получится
wxWin\include
wxWin\lib

Собственно, папку C:\wxWidgets-3.2.4\ можно потом удалить, если не планируете создать другие сборки.

Дальше в ide указываются папки из wxWin.
Например, если Code::Blocks, то в Settings/Global variables создается переменная wx.
в base указывается абсолютный путь к wxWin
в include указывается абсолютный путь к wxWin\include
в lib указывается абсолютный путь к wxWin\lib

Далее создаете проект wxWidgets
При создании проекта, выбирайте wxWidgets 3.2, а также ставьте или уберите галочки, касающиеся юникода, типа созданной библиотеки и пр., чтобы оно соответствовало опциям, которые вы использовали при сборке.

Дополнительно можно скачать wxFormBuilder, которая облегчит процесс создания форм, либо использовать плагин wxSmith из C::B.

4

Royal_X, всё прошло гладко - без сучка и запинки...



спасибо за манула)

0

Update

Начиная с wxWidgets 2.9.1 при сборке даже релизной версии wxDEBUG_LEVEL выставлен на 1, что включает некоторые ассерты, хотя и не все (как это происходит при значении 2).

Такое поведение, как по мне, не совсем корректное. Человек при сборке с флагом BUILD=release видит, что данный флаг также подключает NDEBUG и полагает, что его релизная библиотека будет без ассертов, но в итоге оказывается, что это не так. NDEBUG отключает только ассерты С++, но не wxWidgets. Далее, все программы, скомпилированные на релизной библиотеки будут иметь больше размера и содержать ненужный отладочный мусор, даже если при сборке передать NDEBUG. Этот мусор заметно увеличивает размер бинарника.
Передача wxDEBUG_LEVEL=0 при сборке проектов может убрать эти отладочные данные из бинарников, но не полностью, поэтому предлагаю решить эту проблему еще при сборке самой библиотеки wxWidgets.

Перед сборкой библиотеки, предлагаю отредактировать файл include/msw/setup.h.
Там уже есть закомментированные строки

Тут они предлагают связать с NDEBUG, типа если юзер выставил данный флаг, то чтобы wxDEBUG_LEVEL принял значение 0 и отладочные данные не включались, а мол если нет данного флага, то чтобы этих данных наоборот было больше обычного.
Такая логика и вправду хороша, если вы собираете и релизную и отладочную версии wxWidgets.
Однако, если вы собираете только релизную библиотеку и отладочная версия вам вообще не нужна, то предлагаю раскомментировать только строку
Лезть в wx/debug.h не нужно. Дефайны в setup.h приоритетнее. К тому же, полагается, что юзер имеет право редактировать только setup.h и данный файлик вообще-то для этого и был создан разрабами библиотеки.

0