You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ru/embox_quick_start_ru.md
+20-34Lines changed: 20 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,30 +6,21 @@
6
6
```
7
7
$ git clone https://github.com/embox/embox
8
8
```
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).
10
10
11
11
## Запуск в Windows (и MacOS)
12
-
13
12
### Выполните следующие шаги:
14
-
15
-
Скачайте актуальную версию PowerShell
16
-
13
+
Скачайте актуальную версию PowerShell:
17
14
[Алгоритм скачивания PowerShell для Windows](https://learn.microsoft.com/ru-ru/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3)
18
15
19
-
20
-
Зайдите в PowerShell под именем администратора и установите WSL2 (обратите внимание на требования к версии Windows)
21
-
16
+
Зайдите в PowerShell под именем администратора и установите WSL2 (обратите внимание на требования к версии Windows):
22
17
[Алгоритм установки WSL2](https://learn.microsoft.com/ru-ru/windows/wsl/install-manual)
23
-
24
-
25
18
```
26
19
Перед тем как перейти к следующему шагу обязательно обновите WSL1 до WSL2
27
-
(инструкция по ссылкам выше), в противном случае Embox не запустится под Windows
20
+
(инструкция по ссылкам выше), в противном случае Embox не запустится под Windows.
28
21
```
29
22
30
-
Скачайте Ubuntu из Microsoft Store
31
-
32
-
23
+
### Скачайте Ubuntu из Microsoft Store
33
24
Убедитесь, что у Вас стоит WSL версии 2, для этого введите в PowerShell команду:
34
25
```
35
26
wsl -l -v
@@ -45,12 +36,11 @@
45
36
sudo apt-get install python3
46
37
sudo apt-get install python-is-python3
47
38
```
48
-
49
39
Клонируйте себе версию проекта (используйте https или ssh):
Необходимые пакеты: make, gcc (кросс-компилятор под выбранную архитектуру, см. “Установка кросс-компилятора”).
74
63
Дополнительные пакеты (рекомендуется установить сразу): build-essential, gcc-multilib, curl, libmpc-dev, python.
75
-
Пример установки для Debian:
64
+
65
+
Пример установки для Ubuntu/Debian:
76
66
```
77
67
$ sudo apt-get install make gcc \
78
68
build-essential gcc-multilib \
@@ -84,21 +74,23 @@
84
74
```
85
75
86
76
## Установка кросс-компилятора
87
-
### x86:
77
+
***x86***:
88
78
```
89
79
$ sudo apt-get install gcc
90
80
```
91
-
Обычно эти пакеты уже установлены в Вашей ОС, но на всякий случай стоит это проверить. Вам также понадобится *gcc-multilib*. Обратите внимание, что требуется установить другие пакеты, если Вы уже настроили окружение на Windows и MacOS самостоятельно.
81
+
Обычно эти пакеты уже установлены в Вашей ОС, но на всякий случай стоит это проверить. Вам также понадобится *gcc-multilib*.
82
+
Обратите внимание, что требуется установить другие пакеты, если Вы уже настроили окружение на Windows и MacOS самостоятельно.
92
83
93
84
### ARM:
94
85
```
95
86
$ sudo apt install arm-none-eabi-gcc
96
87
```
97
-
Или для Debian
88
+
Или для Debian:
98
89
```
99
90
$ sudo apt install gcc-arm-none-eabi
100
91
```
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*:
102
94
```
103
95
$ export PATH=$PATH:<путь к тулчейну>/gcc-arm-none-eabi-<version>/bin
104
96
```
@@ -163,10 +155,12 @@ Embox kernel start
163
155
...
164
156
```
165
157
Если все unit-тесты прошли успешно, и система загружена, появится консоль, в которой можно выполнять команды. Начать можно с команды ***'help'*** которая выведет список доступных команд для вашей конфигурации.
158
+
166
159
Для выхода из эмулятора qemu нажмите последовательно: ***ctrl+’A’***, затем ***‘x’***.
167
160
168
161
## Особенности системы сборки Mybuild
169
-
***Embox*** - модульная и настраиваемая система. Для этих целей был разработан декларативный язык описания ***Mybuild***. Он позволяет описывать как отдельные единицы системы (модули), так и всю систему в целом.
162
+
***Embox*** - модульная и настраиваемая система. Для этих целей был разработан декларативный язык описания ***Mybuild***.
163
+
Он позволяет описывать как отдельные единицы системы (модули), так и всю систему в целом.
170
164
171
165
***Модуль*** является базовым понятием для системы сборки. Он содержит: список файлов, относящихся к данному модулю; параметры, которые можно задать модулю в момент конфигурации; список зависимостей.
172
166
@@ -207,7 +201,6 @@ Embox kernel start
207
201
$ mkdir src/cmds/hello_world
208
202
```
209
203
* Создать файл с исходным кодом программы ***src/cmds/hello_world/hello_world.c*** со следующим содержанием:
210
-
211
204
```
212
205
#include <stdio.h>
213
206
@@ -216,7 +209,6 @@ Embox kernel start
216
209
}
217
210
```
218
211
* Создать файл ***src/cmds/hello_world/Mybuild*** с описанием Вашего модуля:
219
-
220
212
```
221
213
package embox.cmd
222
214
@@ -227,22 +219,18 @@ Embox kernel start
227
219
}
228
220
```
229
221
* Добавить программу в файл конфигурации *conf/mods.conf*:
230
-
231
222
```
232
223
include embox.cmd.hello_world
233
224
```
234
225
* Собрать Embox:
235
-
236
226
```
237
227
$ make
238
228
```
239
229
* Запустить Embox:
240
-
241
230
```
242
231
$ ./scripts/qemu/auto_qemu
243
232
```
244
233
* Наберите **help** в консоли Embox, чтобы проверить, появилась ли **hello_world** в списке команд, и Вы увидите:
make ext_conf EXT_PROJECT_PATH=<your projects path>
292
279
```
293
280
Для того, чтобы темплейты были видны через вызовы `make confload` и `make confload-`, подключеный репозиторий должен иметь структуру папки *project*, а именно *<root_folder>/<project_name>/templates*. Модули могут располагаться в произвольных папках, поиск осуществляется по файлам Mybuild и *.my
0 commit comments