148 lines
7.3 KiB
Markdown
148 lines
7.3 KiB
Markdown
---
|
||
title: Побудова з джерельного коду
|
||
x-toc-enable: true
|
||
...
|
||
|
||
WARNING: Flash from bin/, NOT elf/
|
||
==================================
|
||
|
||
TODO: translate this section into ukrainian language
|
||
|
||
**WARNING: When you build a ROM image from the Canoeboot build system, please
|
||
ensure that you flash the appropriate ROM image from `bin/`, NOT `elf/`.
|
||
The `elf/` coreboot ROMs do not contain payloads. Canoeboot's build system
|
||
builds no-payload ROMs under `elf/`, and payloads separately under `elf/`. Then
|
||
it copies from `elf/` and inserts payloads from `elf/`, and puts the final ROM
|
||
images (containing payloads) in `bin/`. This design is more efficient, and
|
||
permits many configurations without needless duplication of work. More info
|
||
is available in the [cbmk maintenance manual](../maintain/)**
|
||
|
||
Multi-threaded builds
|
||
=====================
|
||
|
||
Canoeboot's build system defaults to a single build thread, but you can change
|
||
it by doing e.g.
|
||
|
||
export XBMK_THREADS=4
|
||
|
||
This would make cbmk run on 4 threads.
|
||
|
||
More specifically: when compiling source trees via `script/trees`, `-jTHREADS`
|
||
is passed, where THREADS is the number of threads. This is also set when running
|
||
xz commands for compression, using the `-t` option.
|
||
|
||
Environmental variables
|
||
=======================
|
||
|
||
Please read about environmental variables in [the build
|
||
instructions](../maintain/), before running cbmk. You should set
|
||
your variables accordingly, though you do not technically need to; some
|
||
of them may be useful, e.g. `XBMK_THREADS` (sets the number of build threads).
|
||
|
||
Introduction
|
||
============
|
||
|
||
Система побудови canoeboot, називається `cbmk`, скорочення від `CanoeBoot MaKe`, і цей
|
||
документ описує те, як використовувати її. З цим керівництвом ви можете узнати те, як побудувати
|
||
canoeboot з доступного джерельного коду.
|
||
Ця версія, якщо розміщена наживо на canoeboot.org, передбачає, що ви використовуєте
|
||
сховище git `cbmk`, яке
|
||
ви можете завантажити, використовуючи інструкції на [сторінці огляду коду](../../git.uk.md).
|
||
|
||
Якщо ви використовуєте архів випуску canoeboot, будь ласка, зверніться до
|
||
документації, включеної до *того* випуску. Випуски canoeboot розраховані тільки,
|
||
як *знімки*, не для розробки. Для належної розробки ви маєте завжди
|
||
працювати безпосередньо в сховищі git canoeboot.
|
||
|
||
Наступний документ описує те, як працює `cbmk`, і як ви можете робити зміни
|
||
до нього: [керівництво обслуговування canoeboot](../maintain/)
|
||
|
||
Git
|
||
===
|
||
|
||
Система побудови Canoeboot використовує Git, обширно. Ви маєте виконати кроки
|
||
знизу, *навіть, якщо ви використовуєте архів випуску*.
|
||
|
||
Перед тим, як вам використовувати систему побудови, будь ласка, знайте: система побудови, сама по собі,
|
||
використовує Git обширно, коли завантажує програмне забезпечення, таке як coreboot, та проводить застосування виправлень.
|
||
|
||
Ви маєте переконатись в тому, щоб ініціалізувати ваш Git належним чином, перед тим, як почати, або інакше
|
||
система побудови не буде працювати належно. Зробіть це:
|
||
|
||
git config --global user.name "John Doe"
|
||
git config --global user.email johndoe@example.com
|
||
|
||
Змініть ім'я та адресу електронної пошти на будь-яку, що забажаєте, коли робите це.
|
||
|
||
Ви також можете захотіти прослідувати більшій кількості етапів тут:
|
||
<https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup>
|
||
|
||
Python
|
||
======
|
||
|
||
Python2 не використовується cbmk або будь-чим, що завантажується в якості модулів. Ви
|
||
маєте переконатись, що команда `python` виконує python 3 на вашій системі.
|
||
|
||
Zero..st, check time/date
|
||
-------------------------
|
||
|
||
Make sure date/hwclock report the correct time and date on your system,
|
||
because parts of the build process download from HTTPS servers and wrong
|
||
time or date can cause connections to be dropped during negotiation.
|
||
|
||
Побудова з джерельного коду
|
||
============================
|
||
|
||
Фактична розробка/тестування завжди виконується безпосередньо за допомогою `cbmk`, і це також
|
||
стосується збирання з джерельного коду. Ось кілька інструкцій, щоб
|
||
почати:
|
||
|
||
canoeboot включає сценарій, який автоматично встановлює apt-get залежності
|
||
в Ubuntu 20.04:
|
||
|
||
sudo ./build dependencies ubuntu2004
|
||
|
||
Окремі сценарії також існують:
|
||
|
||
sudo ./build dependencies debian
|
||
|
||
sudo ./build dependencies arch
|
||
|
||
sudo ./build dependencies void
|
||
|
||
Check: `config/dependencies/` for list of supported distros.
|
||
|
||
Технічно, будь-який дистрибутив Linux може бути використано для побудови canoeboot.
|
||
Однак, вам потрібно буде написано свій власний сценарій для встановлення залежностей
|
||
побудови.
|
||
|
||
Canoeboot Make (cbmk) автоматично виконує всі необхідні команди; наприклад,
|
||
`./build roms` автоматично виконає `./build grub`,
|
||
якщо затребувані утиліти для GRUB не збудовано, для виготовлення корисних навантажень.
|
||
|
||
В якості результату, ви тепер можете (після встановлення правильних залежностей побудови) виконати
|
||
лише одну команду, з свіжого Git clone, для побудови образів ROM:
|
||
|
||
./build roms all
|
||
|
||
або навіть побудувати конкретні образи ROM, такі як:
|
||
|
||
./build roms x60
|
||
|
||
or get a list of supported build targets:
|
||
|
||
./build roms list
|
||
|
||
Якщо ви бажаєте побудувати корисні навантаження, можете зробити це. Наприклад:
|
||
|
||
./build grub
|
||
|
||
./update trees -b seabios
|
||
|
||
./update trees -b u-boot
|
||
|
||
Попередні кроки буде виконано автоматично. Однак, ви можете *досі* виконати
|
||
окремі частини системи побудови власноруч, якщо виберете. Це може бути
|
||
вигідно, коли ви робите зміни, та бажаєте протестувати конкретну частину
|
||
cbmk.
|