mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 19:09:37 +00:00
137 lines
8.2 KiB
Plaintext
137 lines
8.2 KiB
Plaintext
---
|
||
sidebar_label: Система сборки
|
||
---
|
||
|
||
# Система сборки
|
||
|
||
## Бэкенды компилятора
|
||
|
||
DCR поддерживает 4 бэкенда компиляции. Выбор происходит автоматически на основе расширения файла и target triple.
|
||
|
||
| Бэкенд | Файлы | Когда используется |
|
||
| --------- | --------------------------------------- | ------------------------------------- |
|
||
| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.s`, `.S` | gcc/clang на Linux/macOS/BSD |
|
||
| `msvc` | `.c`, `.cpp`, `.cxx`, `.cc` | Windows (cl, clang-cl) |
|
||
| `газ` | `.s`, `.S` | ARM/ARM64 ассемблер |
|
||
| `nasm` | `.asm`, `.s` | x86/x86_64 ассемблер |
|
||
| `masm` | `.asm` | MASM (ml/ml64) в Windows |
|
||
| `fasm` | `.asm`, `.fasm` | Сборщик плоских деталей |
|
||
| `llvm_ir` | `.ll` | LLVM IR с помощью `llc -filetype=obj` |
|
||
|
||
## Поддержка Qt
|
||
|
||
DCR обеспечивает встроенную поддержку Qt для автоматической обработки метаобъектов (MOC, UIC, RCC).
|
||
|
||
Чтобы включить эту функцию, установите значение `build.qt = true` в файле `dcr.toml`. DCR автоматически обнаружит файлы, связанные с Qt (`.ui`, `.qrc`, `.h` с `Q_OBJECT`), и обработает их.
|
||
|
||
```toml
|
||
[build]
|
||
qt = true
|
||
```
|
||
|
||
*Примечание: Требуется установка модулей `qt6` (Core, Widgets, Gui, Svg) с помощью `pkg-config`.*
|
||
|
||
Если требуется специальная обработка, по-прежнему можно выполнить расширенную настройку с помощью файла `build.steps`:
|
||
|
||
```toml
|
||
[build.steps]
|
||
moc = "moc {in} -o {out}"
|
||
```
|
||
|
||
### Unix CC
|
||
|
||
* Компилятор определяется через `resolve_compiler()`: CC/CXX из [toolchain], DCR_COMPILER/env, PATH
|
||
* Поддерживает генерацию `.d` файлов для header dependency tracking
|
||
* Флаги: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
|
||
* Условные флаги, зависящие от настроек:
|
||
* `freestanding` или целевая среда «bare-metal»: `-ffreestanding` (компиляция), `-nostdlib -static` (линковка)
|
||
* `lto`: `-flto` (компиляция + линковка)
|
||
* `panic = "abort"`: `-fno-exceptions` (только для C++), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables`
|
||
|
||
### MSVC
|
||
|
||
* Поддерживает cl.exe и clang-cl.exe
|
||
* Флаги: `/std:`, `/Fo:`, `/Fe:`, `/I`, `/link`
|
||
|
||
### GAS / NASM
|
||
|
||
* GAS: `-I`, `-c -o`, `--defsym`
|
||
* NASM: `-I`, `-o`, `-D`, `-f` (format: win64/elf64/macho64/macho32/elf32; **`bin` when `kind = "flat-bin"`**)
|
||
* MASM: `/nologo /c /Fo\<obj> <source>`
|
||
* FASM: `<source> \<output>` (путь вывода — объектный файл)
|
||
* LLVM IR: `-filetype=obj <source> -o \<output>`
|
||
|
||
## Инкрементные сборки
|
||
|
||
Три уровня инкрементальности:
|
||
|
||
1. **mtime** — если выходной файл новее всех входных, файл не перекомпилируется
|
||
2. **`.d` files** — отслеживание изменений в заголовочных файлах (включая транзитивные)
|
||
3. **SHA256 fingerprint** — если флаги компиляции изменились, файл перекомпилируется (fingerprint хранится в `.dcr_fingerprint`)
|
||
|
||
## Параллельная компиляция
|
||
|
||
* Используется `thread::scope` для создания пула потоков
|
||
* Атомарная очередь задач (`AtomicU64`)
|
||
* Мьютекс на запись в stdout (`OUTPUT_MUTEX`)
|
||
* Количество потоков = `available_parallelism()`, ограниченное значением `build.codegen-units`, если оно задано
|
||
|
||
## Типы сборок
|
||
|
||
| Тип | Тип | Путь (пример для Linux) |
|
||
| ------------------ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| `bin` | Исполняемый файл | `target/\<profile>/\<name>` (.exe) |
|
||
| `staticlib` | Статическая библиотека | `target/\<profile>/lib\<name>.a` (.lib) |
|
||
| `sharedlib` | Динамическая библиотека | `target/\<profile>/lib\<name>.so` (.dll/.dylib) |
|
||
| `efi` | UEFI приложение | `target/\<profile>/\<name>.efi` |
|
||
| `эльф` | ELF без стандартной библиотеки | `target/\<profile>/\<name>` |
|
||
| `нет` | Только компиляция, без линковки | — |
|
||
| `пользовательский` | Полный контроль filename + extension | `target/\<profile>/\<filename>.\<extension>` |
|
||
| `flat-bin` | Raw binary | ASM: `\<stem>.bin` (NASM `-f bin` / FASM / GAS·MASM·LLC via objcopy); C/C++: `\<name>.bin` (link + objcopy) |
|
||
|
||
## Disk images (`[archive]`)
|
||
|
||
After a successful build, if `[archive]` is present in `dcr.toml`, DCR formats a FAT volume and copies files from `layout` into the image. See [dcr.toml → archive](/docs/reference/dcr-toml#archive).
|
||
|
||
## Этапы сборки
|
||
|
||
DCR поддерживает pre-build и post-build шаги через Qt codegen:
|
||
|
||
* `build.steps` — команды, выполняемые перед компиляцией
|
||
* `build.post_steps` — команды, выполняемые после компиляции
|
||
|
||
Подстановки: `{stem}`, `{in}`, `{out}`.
|
||
|
||
`rcc` — Resource Compiler: `{stem}.qrc → qrc_{stem}.cpp`
|
||
|
||
```toml
|
||
[build.steps]
|
||
moc = "moc {in} -o {out}"
|
||
```
|
||
|
||
## pkg-config
|
||
|
||
Автоматический поиск (чтение из исходного файла конфигурации):
|
||
|
||
```toml
|
||
[build]
|
||
pkg_config = ["sdl2", "gl"]
|
||
```
|
||
|
||
DCR вызывает `pkg-config --cflags sdl2 gl` и `pkg-config --libs sdl2 gl` и добавляет результат в флаги компиляции/линковки.
|
||
|
||
## Подстановка переменных
|
||
|
||
Поддерживаемые переменные:
|
||
|
||
| Переменная | Описание |
|
||
| ----------------------- | ----------------------------------------- |
|
||
| `{version}` | Версия пакета |
|
||
| `{version_major}` | Часть, обозначающая основную версию |
|
||
| `{version_minor}` | Часть, обозначающая второстепенную версию |
|
||
| `{version_patch}` | Переменная |
|
||
| `{version_suffix}` | Суффикс (например, `-rc1`) |
|
||
| `{version_suffix_dash}` | Суффикс с тире |
|
||
| `{profile}` | Имя профиля (debug/release/...) |
|
||
| `{name}` | Имя пакета |
|