Как собрать библиотеку из исходников windows

У многих языков программирования системы сборки поставляются вместе с компиляторами и являються де-факто стандартом для соответсвующего языка.

Для C/C++ де-факто стандрата сборки нет, но есть несколько систем сборки, которые обычно используються:

make — очень простая утилита, но неудобно для больших проектов.
Можно определить по наличию файла Makefile. Иногда этот файл генерируеться скриптом configure.
Если есть Makefile, запускаем:
$ make
Удалить сгенерированные файлы (чтобы запустить сборку заново):
$ make clean

cmake— более высокоуровневая система сборки, генерирует проекты для IDE или те же Makefile.
Можно определить по наличию CMakeLists.txt

mkdir cmake-build
# Создаём папку для сгенерированных файлов, чтобы не смешивались с исходниками
# Это называеться out-of-source build
cd cmake-build

# Генерируем проект или Makefile
cmake ..

# Запускаем билд, можно просто запустить make
cmake --build .

qmake — система сборки разработаная для сборки Qt и проектов использующих Qt.
Можно определить по наличию .pro файлов. Билдим так:

qmake
make

В вашем случае используеться make.

Дата публикации: 09.01.2023
Дата последней правки: 10.06.2023

Содержание

• Введение
• Процесс сборки
  • Установка требуемых инструментов
  • Клонирование репозитория с исходниками
  • Компиляция
  • Сборка пакетов Python
• Проверка пакетов
• Заключение
• Похожие статьи

Введение

wxPython — это сравнительно легковесная (по сравнению с Qt) библиотека для создания графического интерфейса приложений на языке Python. По сути wxPython является оболочкой над библиотекой wxWidgets, написанной на языке C++. Хотя разработчики wxPython подготавливают бинарные сборки библиотеки под различные операционные системы (Windows, Linux и macOS), но бывают случаи, когда требуется самостоятельно собрать библиотеку из исходников. В частности, для wxPython 4.2.1, на примере которой будет показан процесс сборки в данной статье, на pypi есть сборки только под 64-битные версии Windows, однако библиотека вполне может работать и на 32-битных системах, для этого нужно всего лишь собрать ее из исходников.

Если в системе, для которой отсутствует бинарная сборка, выполнить команду для установки библиотеки

то pip попробует собрать пакет из исходников самостоятельно. Если у вас в системе установлены все необходимые библиотеки, то скорее всего это ему даже удастся. Но, во-первых, это процесс достаточно долгий (на моем стареньком i7-3770 этот процесс занимает больше получаса), и поэтому иногда желательно один раз скомпилировать себе требуемую бинарную сборку, а потом ее быстро устанавливать, не ожидая новой пересборки. И, во-вторых, если проблема сборки выявится на этапе компиляции с использованием pip, определить причину неудачи будет сложнее по сравнению со случаем, когда вы будете собирать библиотеку по шагам самостоятельно.

К тому же процесс сборки библиотеки достаточно простой и не требует каких-то особых знаний и шаманств, он подробно описан в документации (в файле README.rst в корне исходников), но кто ж ее читает :), и к тому же могут возникнуть проблемы с отсутствующими библиотеками или требуемыми приложениями для сборки, и поэтому лучше сразу установить все необходимое, чтобы процесс сборки прошел гладко.

Процесс сборки

Установка требуемых инструментов

Для сборки под Windows понадобятся следующие инструменты:

• git.
• Python.
• MS Build Tools с установленной опцией «Desktop Development with C++».
• graphviz (используется для сборки справки).

Относительно git и Python, я думаю, вопросов быть не должно. Отмечу лишь, что для сборки wxPython вполне можно (и адже это будет правильнее) использовать виртуальное окружение Python с требуемой версией интерпретатора, но в дальнейшем для простоты будем подразумевать, что виртуальное окружение не используется, и требуемые библиотеки установлены глобально.

В дальнейшем процесс сборки я буду показывать на примере использования Python 3.8 32-bit. Эта достаточно старая версия Python выбрана, потому что это последняя версия интерпретатора, которая работает на Windows 7. Если вам нужно, чтобы ваша программа работала на этой пока еще не совсем редкой операционной системе (хорошо хоть не на Windows XP), то придется ограничиться Python 3.8. Ну а 32-битная версия была выбрана из-за того, что бинарная сборка для 64 бит лежит в pypi (в том числе и для Python 3.8), и в большинстве случаев нет смысла ее собирать самостоятельно. Несмотря на использование столь старой версии интерпретатора, примеры будут приводиться при компиляции в Windows 10 64-bit.

С установкой MS Build Tools проблем обычно тоже не возникает. Инсталятор сам прописывает все требуемые пути в переменные окружения, чтобы скрипт сборки мог использовать компилятор C++.

Скриншот инсталятора с выбранной опцией «Desktop Development with C++» показан на следующем рисунке:

Картинка с сайта: jenyay.net

Что касается Graphviz, то его нужно не просто установить, но и прописать путь до его запускаемого файла в переменной окружения PATH. Если вы устанавливали GraphViz в папку по умолчанию (C:\Program Files\GraphViz), то в PATH нужно добавить путь C:\Program Files\GraphViz\bin:

Картинка с сайта: jenyay.net

GraphViz — это инструмент для генерации картинок с диаграммами по текстовому описанию. Он часто используется для создания справки, например, для создания диаграмм наследования классов.

Затем надо установить требуемые для сборки библиотеки для Python:

Библиотека attrdict используется в скрипте сборки. Эта библиотека предоставляет нестандартную коллекцию, напоминающую словарь, отличие которого заключается в том, что ключи можно запрашивать и через квадратные скобки, и как доступ к свойствам. Одна из плюшек этой библиотеке заключается в том, что она позволяет создавать данный объект по текстовому представлению, например из строки в формате yaml.

Библиотека sip используется для создания Python-обертки над библиотекой, написанной на C++. Об этой библиотеке я когда-то писал статью в двух частях: Создание Python-обвязки для библиотек, написанных на C/C++, с помощью SIP. Часть 1 и часть 2.

Библиотека Sphinx используется для генерации документации.

Библиотека wheel используется для сборки пакетов в формате wheel.

Клонирование репозитория с исходниками

Исходные коды библиотеки wxPython расположены в репозитории github https://github.com/wxWidgets/Phoenix. Такое странное название исторически сложилось как кодовое имя проекта в процессе перехода wxPython с Python 2 на Python 3. Это был долгий и мучительный процесс.

Для начала нужно клонировать исходники из репозитория и перейти в созданную после клонирования папку с исходниками. Для этого в консоли нужно выполнить команды:

Картинка с сайта: jenyay.net

Затем нужно переключиться на требуемую версию, если только вы не планируете собирать текущую ветку master, которая еще находится в разработке. Например, для версии wxPython 4.2.1 имя тега — «wxPython-4.2.1».

Картинка с сайта: jenyay.net

После этого нужно скачать сабмодули и при этом не забыть установить флаг —recursive.

Картинка с сайта: jenyay.net

Компиляция

Теперь мы подошли к самому волнительному моменту, на котором обычно и возникают ошибки, как правило связанные с отсутствующими библиотеками. По идее, если все библиотеки установлены и пути до требуемых запускаемых файлов прописаны в переменной окружения PATH, то все должно пройти без проблем, но этот процесс может занять сравнительно долгое время.

Процесс сборки состоит из нескольких этапов. Последовательно их выполним.

Первый шаг подготавливает файлы для будущей документации. Этот шаг требует наличия интернета. Во время его выполнения скрипт проверит, установлена ли у вас программа Doxygen для генерации документации, и если нет, то скачает ее в папку bin, а затем использует ее для генерации файлов документации.

Картинка с сайта: jenyay.net

Следующий шаг сборки:

Этот шаг на основе py-файлов из папки etg создает файлы для дальнейшей компиляции с помощью sip. Новые файлы создаются в папке sip\gen и имеют расширение .sip. Этот процесс уже чуть более долгий.

Картинка с сайта: jenyay.net

Затем запускаем компиляцию с помощью sip:

Картинка с сайта: jenyay.net

И, наконец, запускаем непосредственно компиляцию.

Картинка с сайта: jenyay.net

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

Картинка с сайта: jenyay.net

Сборка пакетов Python

К этому моменту основная часть уже выполнена. Осталось упаковать скомпилированную библиотеку в пакет, который можно будет установить с помощью pip. Для начала можно создать бинарный пакет с помощью команды

Эта операция не займет много времени.

Картинка с сайта: jenyay.net

В результате ее выполнения будет создан файл wxPython-4.2.1-win32-py3.8.tar.gz (или с похожим именем в зависимости от того, какую версию wxPython вы собираете и под какой интерпретатор) в папке dist

А можно собрать пакет в формате wheel (что в последнее время является предпочтительным). Для сборки пакета в формате wheel нужно выполнить команду:

Картинка с сайта: jenyay.net

После завершения этой операции в той же папке dist будет создан файл wxPython-4.2.1-cp38-cp38-win32.whl.

Картинка с сайта: jenyay.net

Проверка пакетов

Убедимся, что только что созданный wheel-пакет работает нормально. Для этого перейдем в папку dist с созданными пакетами и установим wheel-пакет с помощью pip:

При необходимости pip скачает и установит требуемые зависимости (six, pillow, numpy).

Картинка с сайта: jenyay.net

Теперь запустим интерпретатор Python и убедимся, что модуль wx импортируется без ошибок:

В результате должна быть выведена строка с номером версии wxPython.

Картинка с сайта: jenyay.net

Заключение

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

В следующем разделе приведены ссылки на статьи по близким темам.

Похожие статьи

• Компиляция библиотеки wxWidgets в Code::Blocks
• Сайзеры в wxWidgets / wxPython.
• Использование Scintilla в wxPython
• Создание Python-обвязки для библиотек, написанных на C/C++, с помощью SIP. Часть 1
• Создание Python-обвязки для библиотек, написанных на C/C++, с помощью SIP. Часть 2

Цель собрать статически библиотеки QT для MSVC2010.

Почему может потребоваться msvc, а не mingw32? Например потому-что WMI сервис не получается вызывать под mingw.

Встает вопрос либо допиливать исходники под mingw или перейти на msvc. Попробуем второй вариант.

Устанавливаем QT SDK 1.2.1 на диск D: .

Не забываем установить Perl на Windows. Perl используется утилитой config.exe и нужен будет для создания makefiles для папок исходников.

Запускаем в папке D:\QtSDK1.2.1\QtSources\4.8.1 программу config.exe с ключами через батник:

configure.exe -static -release -opensource -qt-zlib -openssl -webkit -no-fast -no-crt -nomake demos -nomake examples -no-qt3support -no-stl -no-libpng -no-libtiff -no-gif -no-libmng -no-mmx -no-libjpeg -no-iwmmxt -no-phonon -no-phonon-backend -no-multimedia -no-directwrite -no-sql-sqlite2 -no-sql-sqlite -no-rtti -no-sse -no-3dnow -no-opengl -no-sse2 -no-style-plastique -no-style-motif -no-dsp -no-ltcg -no-script -no-scripttools -no-openvg -no-opengl -no-audio-backend > config_static_mingw.txt

Но это не совсем то, что нам нужно . Нам надо именно под msvc2010.

Находим пример в интернете, который сработает как надо :

configure -mp -opensource -nomake demos -nomake examples -platform win32-msvc2010
rem  -mp ................ Use multiple processors for compiling with MSVC (-MP)
rem -platform  ... The operating system and compiler you are building on

Далее заходим в QT Creator и собираем проект (вариант msvc2010) . Собранные библиотеки сыпятся в каталог D:\QtSDK1.2.1\QtSources\4.8.1 \lib

Это такие библиотеки как например QtNetwork4.lib / QtNetworkd4.lib / QtNetwork4.dll и QtNetworkd4.dll. То есть статический вариант библиотеки и динамический , плюс два ваританта релизный и отладочный.

Примечание: и это неправда. Библиотеки собраны на самом деле — динамически. Это не статика. А ответ кроется в файле qmake.conf, там смотрите ключ -MD. У библиотек статики на конце цифры 4 не будет.

Через пару часов все библиотеки по-видимому собрались.

Что на самом деле еще надо сделать, чтобы собрать действительно статически смотрите на соседней странице.

Introduction

Compiling C (and C++) code in Windows is simple, as all we need is to create a barebones project with everything we need using Visual Studio. But Visual studio and VS code uses telemetry to track usage data. Simply put, VS Code and Visual Studio are spywares. Therefore, in the spirit of OpSec, we can use an alternative compiler that does not spy on code in development.

GCC is an open-source optimizing compiler produced by the GNU Project supporting various programming languages, hardware architectures and operating systems. It is distributed as MinGW and Cygwin for Windows.

This article will show you the basics of creating a DLL for a calculator application and dynamically linking (implicitly) to them in your applications with GCC under MingGW. You can download MinGW from https://sourceforge.net/projects/mingw-w64/

Step 1

We will declare and export our basic function in a header file: calcdll.h

/* calcdll.h

   Declares the functions to be imported by our application, and exported by our
   DLL.
*/

#ifdef CALCDLL_EXPORTS /*  define ADD_EXPORTS *only* when building the DLL. */
  #define CALCDLL_API __declspec(dllexport)
#else
  #define CALCDLL_API __declspec(dllimport)
#endif

/* Define calling convention in one place, for convenience. */
#define CALL __cdecl

/* Make sure functions are exported with C linkage under C++ compilers. */

#ifdef __cplusplus
extern "C"
{
#endif

/* Declare our Add function using the above definitions. */
CALCDLL_API int CALL Add(int a, int b);
CALCDLL_API int CALL Subtract(int a, int b);
CALCDLL_API int CALL Divide(int a, int b);
CALCDLL_API int CALL Multiply(int a, int b);

#ifdef __cplusplus
} // __cplusplus defined.
#endif

The __declspec(dllexport) attribute defined as CALCDLL_API in the code is the key to exporting functions from the DLL, and every function you would like to export from the DLL should be marked with this.

Also notice the “__cdecl” (defined as CALL) before the function name. This declares the calling convention for the function (see the Wikipedia article on x86 calling conventions if you’re not familiar with them).

The default calling convention for C functions in MinGW is cdecl, but it’s a good idea to always explicitly state the calling convention in case some other compiler has a different default. If this happens, your application will likely misbehave or crash as a result of calling one of these functions.

Step 2

We will define our basic functions in calcdll.c

/* calcdll.c

Demonstrates creating a DLL with exported functions
*/

#include "calcdll.h"

int CALL Add(int a, int b) {
  return (a + b);
}

int CALL Subtract(int a, int b) {
  return (a - b);
} 

int CALL Divide(int a, int b) {
  return (a/b);
}

int CALL Multiply(int a, int b) {
  return (a * b);
}

Then, we will compile this DLL. It is necessary to define “CALCDLL_EXPORTS” when compiling the object code, to ensure “CALCDLL_API” is correctly defined in the header. This is done most easily by passing a “-D CALCDLL_EXPORTS” on the command line. We will use a batch file for this: build.bat

/* build.bat

Demonstrates compiling a DLL using a batch file
*/
gcc -c -o calcdll.o calcdll.c -D CALCDLL_EXPORTS
gcc -o calcdll.dll calcdll.o -s -shared -Wl,--subsystem,windows

Run batch file on CMD

C:\Users\sokearth\Documents\CALC>build.bat

Step 3

Let’s create our calculator application to utilize our dll

/* calc.c

   Demonstrates using the function imported from the DLL.
*/

#include <stdlib.h>
#include <stdio.h>
#include "calcdll.h"

int main() {
  int a, b, c, d;
  a = Add(10, 5)
  printf("Addition = %d\n", a);

  b = Subtract(10, 5)
  printf("Subtraction = %d\n", b);

  c = Divide(10, 5)
  printf("Division = %d\n", c);

  d = Multiply(10, 5)
  printf("Multiplication = %d\n", d);

  return 0;
}

For the second to last step, we will compile the code to our calculator application into an exe file and run it using another batch file: build_exe.bat

/* build_exe.bat

Demonstrates compiling and running calculator app using a batch file
*/

gcc -c -o calc.o calc.c
gcc -o calc.exe -s calc.o -L. -lcalcdll
calc.exe

Finally, run batch file on CMD

C:\Users\sokearth\Documents\CALC>build_exe.bat

Note

This article demonstrates implicit dynamic linking with GCC. For a guide on how to do explicit dynamic linking, check out the next article on my OpSec series.