60 lines
2.7 KiB
Markdown
60 lines
2.7 KiB
Markdown
# PIP Build Options
|
||
|
||
## Основные опции сборки
|
||
|
||
### Стандартные опции (option())
|
||
| Опция | Описание | По умолчанию |
|
||
|-------|----------|--------------|
|
||
| `ICU` | ICU support для конвертации кодовых страниц | ON (кроме Win/Android/Apple) |
|
||
| `STD_IOSTREAM` | Поддержка std::iostream операторов | OFF |
|
||
| `INTROSPECTION` | Сборка с интроспекцией | OFF |
|
||
| `TESTS` | Сборка тестов | OFF |
|
||
| `COVERAGE` | Сборка с информацией о покрытии | OFF |
|
||
| `PIP_FFTW_F` | Поддержка FFTW для float | ON |
|
||
| `PIP_FFTW_L` | Поддержка FFTW для long double | ON |
|
||
| `PIP_FFTW_Q` | Поддержка FFTW для quad double | OFF |
|
||
|
||
### Опции модулей (PIP_BUILD_*)
|
||
| Опция | Модуль |
|
||
|-------|--------|
|
||
| `PIP_BUILD_CONSOLE` | console |
|
||
| `PIP_BUILD_CRYPT` | crypt (требует libsodium) |
|
||
| `PIP_BUILD_COMPRESS` | compress (требует zlib) |
|
||
| `PIP_BUILD_USB` | usb |
|
||
| `PIP_BUILD_FFTW` | fftw |
|
||
| `PIP_BUILD_OPENCL` | opencl |
|
||
| `PIP_BUILD_IO_UTILS` | io_utils |
|
||
| `PIP_BUILD_CLIENT_SERVER` | client_server |
|
||
| `PIP_BUILD_CLOUD` | cloud |
|
||
| `PIP_BUILD_LUA` | lua |
|
||
| `PIP_BUILD_HTTP_CLIENT` | http_client (требует libcurl) |
|
||
| `PIP_BUILD_HTTP_SERVER` | http_server (требует libmicrohttpd) |
|
||
|
||
### Дополнительные переменные
|
||
| Переменная | Описание |
|
||
|------------|----------|
|
||
| `PIP_BUILD_DEBUG` | Сборка debug версии |
|
||
| `PIP_FREERTOS` | Режим сборки для FreeRTOS |
|
||
| `CROSSTOOLS` | Собрать инструменты кросс-сборки под хостовую систему (pip_cmg, pip_rc, ...) |
|
||
| `LOCAL` | Локальная установка (bin/lib/include) |
|
||
| `PIP_CONTAINERS_MIN_ALLOC` | Переопределить минимальный размер аллокации контейнеров |
|
||
| `PIP_CONTAINERS_MAX_POT_ALLOC` | Переопределить максимальный размер дополнительной аллокации (поддерживает X_KiB, X_MiB) |
|
||
|
||
### Примеры использования
|
||
```bash
|
||
# Базовая сборка с тестами
|
||
cmake -B build -DTESTS=ON
|
||
|
||
# Сборка с покрытием и ICU
|
||
cmake -B build -DTESTS=ON -DCOVERAGE=ON -DICU=ON
|
||
|
||
# Отключение отдельных модулей
|
||
cmake -B build -DPIP_BUILD_CRYPT=OFF -DPIP_BUILD_OPENCL=OFF
|
||
|
||
# Переопределение параметров контейнеров
|
||
cmake -B build -DPIP_CONTAINERS_MIN_ALLOC=64
|
||
|
||
# Локальная установка
|
||
cmake -B build -DLOCAL=ON
|
||
```
|