Skip to content

Commit 9944640

Browse files
authored
Update embox_quick_start_ru.md
1 parent f599cc9 commit 9944640

File tree

1 file changed

+20
-34
lines changed

1 file changed

+20
-34
lines changed

ru/embox_quick_start_ru.md

Lines changed: 20 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -6,30 +6,21 @@
66
```
77
$ git clone https://github.com/embox/embox
88
```
9-
Либо скачиваем архивом из [https://github.com/embox/embox/releases](https://github.com/embox/embox/releases)
9+
Либо скачиваем архивом из [https://github.com/embox/embox/releases](https://github.com/embox/embox/releases).
1010

1111
## Запуск в Windows (и MacOS)
12-
1312
### Выполните следующие шаги:
14-
15-
Скачайте актуальную версию PowerShell
16-
13+
Скачайте актуальную версию PowerShell:
1714
[Алгоритм скачивания PowerShell для Windows](https://learn.microsoft.com/ru-ru/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3)
1815

19-
20-
Зайдите в PowerShell под именем администратора и установите WSL2 (обратите внимание на требования к версии Windows)
21-
16+
Зайдите в PowerShell под именем администратора и установите WSL2 (обратите внимание на требования к версии Windows):
2217
[Алгоритм установки WSL2](https://learn.microsoft.com/ru-ru/windows/wsl/install-manual)
23-
24-
2518
```
2619
Перед тем как перейти к следующему шагу обязательно обновите WSL1 до WSL2
27-
(инструкция по ссылкам выше), в противном случае Embox не запустится под Windows
20+
(инструкция по ссылкам выше), в противном случае Embox не запустится под Windows.
2821
```
2922

30-
Скачайте Ubuntu из Microsoft Store
31-
32-
23+
### Скачайте Ubuntu из Microsoft Store
3324
Убедитесь, что у Вас стоит WSL версии 2, для этого введите в PowerShell команду:
3425
```
3526
wsl -l -v
@@ -45,12 +36,11 @@
4536
sudo apt-get install python3
4637
sudo apt-get install python-is-python3
4738
```
48-
4939
Клонируйте себе версию проекта (используйте https или ssh):
50-
51-
git clone <https://github.com/embox/embox.git>
52-
git clone <[email protected]:embox/embox.com>
53-
40+
```
41+
git clone <https://github.com/embox/embox.git>
42+
git clone <[email protected]:embox/embox.com>
43+
```
5444

5545
Зайдите в папку проекта:
5646
```
@@ -68,11 +58,11 @@
6858
[Устранение неполадок WSL](https://learn.microsoft.com/ru-ru/windows/wsl/troubleshooting)
6959

7060

71-
7261
## Настройка окружения
7362
Необходимые пакеты: make, gcc (кросс-компилятор под выбранную архитектуру, см. “Установка кросс-компилятора”).
7463
Дополнительные пакеты (рекомендуется установить сразу): build-essential, gcc-multilib, curl, libmpc-dev, python.
75-
Пример установки для Debian:
64+
65+
Пример установки для Ubuntu/Debian:
7666
```
7767
$ sudo apt-get install make gcc \
7868
build-essential gcc-multilib \
@@ -84,21 +74,23 @@
8474
```
8575

8676
## Установка кросс-компилятора
87-
### x86:
77+
***x86***:
8878
```
8979
$ sudo apt-get install gcc
9080
```
91-
Обычно эти пакеты уже установлены в Вашей ОС, но на всякий случай стоит это проверить. Вам также понадобится *gcc-multilib*. Обратите внимание, что требуется установить другие пакеты, если Вы уже настроили окружение на Windows и MacOS самостоятельно.
81+
Обычно эти пакеты уже установлены в Вашей ОС, но на всякий случай стоит это проверить. Вам также понадобится *gcc-multilib*.
82+
Обратите внимание, что требуется установить другие пакеты, если Вы уже настроили окружение на Windows и MacOS самостоятельно.
9283

9384
### ARM:
9485
```
9586
$ sudo apt install arm-none-eabi-gcc
9687
```
97-
Или для Debian
88+
Или для Debian:
9889
```
9990
$ sudo apt install gcc-arm-none-eabi
10091
```
101-
Вы можете также скачать архив с набором ARM-инструментов(тулчейном) по ссылке: [https://launchpad.net/gcc-arm-embedded](https://launchpad.net/gcc-arm-embedded), а затем распаковать архив и настроить переменную окружения *PATH*:
92+
Вы можете также скачать архив с набором ARM-инструментов(тулчейном) по ссылке: [https://launchpad.net/gcc-arm-embedded](https://launchpad.net/gcc-arm-embedded).
93+
Затем нужно распаковать архив и настроить переменную окружения *PATH*:
10294
```
10395
$ export PATH=$PATH:<путь к тулчейну>/gcc-arm-none-eabi-<version>/bin
10496
```
@@ -163,10 +155,12 @@ Embox kernel start
163155
...
164156
```
165157
Если все unit-тесты прошли успешно, и система загружена, появится консоль, в которой можно выполнять команды. Начать можно с команды ***'help'*** которая выведет список доступных команд для вашей конфигурации.
158+
166159
Для выхода из эмулятора qemu нажмите последовательно: ***ctrl+’A’***, затем ***‘x’***.
167160

168161
## Особенности системы сборки Mybuild
169-
***Embox*** - модульная и настраиваемая система. Для этих целей был разработан декларативный язык описания ***Mybuild***. Он позволяет описывать как отдельные единицы системы (модули), так и всю систему в целом.
162+
***Embox*** - модульная и настраиваемая система. Для этих целей был разработан декларативный язык описания ***Mybuild***.
163+
Он позволяет описывать как отдельные единицы системы (модули), так и всю систему в целом.
170164

171165
***Модуль*** является базовым понятием для системы сборки. Он содержит: список файлов, относящихся к данному модулю; параметры, которые можно задать модулю в момент конфигурации; список зависимостей.
172166

@@ -207,7 +201,6 @@ Embox kernel start
207201
$ mkdir src/cmds/hello_world
208202
```
209203
* Создать файл с исходным кодом программы ***src/cmds/hello_world/hello_world.c*** со следующим содержанием:
210-
211204
```
212205
#include <stdio.h>
213206
@@ -216,7 +209,6 @@ Embox kernel start
216209
}
217210
```
218211
* Создать файл ***src/cmds/hello_world/Mybuild*** с описанием Вашего модуля:
219-
220212
```
221213
package embox.cmd
222214
@@ -227,22 +219,18 @@ Embox kernel start
227219
}
228220
```
229221
* Добавить программу в файл конфигурации *conf/mods.conf*:
230-
231222
```
232223
include embox.cmd.hello_world
233224
```
234225
* Собрать Embox:
235-
236226
```
237227
$ make
238228
```
239229
* Запустить Embox:
240-
241230
```
242231
$ ./scripts/qemu/auto_qemu
243232
```
244233
* Наберите **help** в консоли Embox, чтобы проверить, появилась ли **hello_world** в списке команд, и Вы увидите:
245-
246234
```
247235
root@embox:/#hello_world
248236
Hello, world!
@@ -251,7 +239,6 @@ Embox kernel start
251239

252240
### Файл описания модуля
253241
Разберем немного подробнее файл описания модуля.
254-
255242
```
256243
package embox.cmd
257244
@@ -291,4 +278,3 @@ Embox допускает подключение внешнего репозит
291278
make ext_conf EXT_PROJECT_PATH=<your projects path>
292279
```
293280
Для того, чтобы темплейты были видны через вызовы `make confload` и `make confload-`, подключеный репозиторий должен иметь структуру папки *project*, а именно *<root_folder>/<project_name>/templates*. Модули могут располагаться в произвольных папках, поиск осуществляется по файлам Mybuild и *.my
294-

0 commit comments

Comments
 (0)