xref: /DragonOS/docs/introduction/build_system.md (revision 0435eb00b1651a9d82f129a580569905501d2fcb)
1# 构建DragonOS
2
3## 从Docker构建(推荐)
4
5  为减轻配置环境的负担,DragonOS发布了一个Docker编译环境,便于开发者运行DragonOS。我们强烈建议您采用这种方式来运行DragonOS。
6
7  本节假设以下操作均在Linux下进行。
8
9### 安装Docker
10
11  您可以在docker官网下载安装docker-ce.
12
13> 详细信息请转到: https://docs.docker.com/engine/install/
14
15### 获取DragonOS编译镜像
16
17  当您成功安装了docker之后,您可以通过以下命令,下载DragonOS的编译镜像:
18
19```shell
20docker pull dragonos/dragonos-dev:v1.0
21```
22
23### 安装qemu虚拟机
24
25  在本节中,我们建议您采用命令行安装qemu:
26
27```shell
28sudo apt install -y qemu qemu-system qemu-kvm
29```
30
31  请留意,若您的Linux系统是在虚拟机中运行的,还请您在您的VMware/Virtual Box虚拟机的处理器设置选项卡中,开启Intel VT-x或AMD-V选项,否则,DragonOS将无法运行。
32
33*在某些Linux发行版的软件仓库中构建的Qemu可能存在不识别命令参数的问题,如果遇到这种问题,请卸载Qemu,并采用编译安装的方式重新安装Qemu*
34
35在该地址下载Qemu源代码: https://download.qemu.org/
36
37解压后进入源代码目录,然后执行下列命令:
38
39```shell
40./configure --enable-kvm
41make -j 8
42sudo make install
43```
44
45### 下载DragonOS的源代码
46
47  假设您的计算机上已经安装了git,您可以通过以下命令,获得DragonOS的最新的源代码:
48
49```shell
50git clone https://github.com/fslongjin/DragonOS
51cd DragonOS
52```
53
54### 创建磁盘镜像
55
56  首先,您需要使用tools文件夹下的create_hdd_image.sh,创建一块虚拟磁盘镜像。您需要在tools文件夹下运行此命令。
57
58```shell
59bash create_hdd_image.sh
60```
61
62### 运行DragonOS
63
64  如果不出意外的话,这将是运行DragonOS的最后一步。您只需要在DragonOS的根目录下方,执行以下命令,即可运行DragonOS。
65
66```shell
67bash run.sh --docker
68```
69
70  若输入密码后仍提示权限不足,您可以使用以下命令运行:
71
72```shell
73sudo bash run.sh --docker
74```
75
76  稍等片刻,DragonOS将会被运行。
77
78  在qemu虚拟机被启动后,我们需要在控制台输入字母`c`,然后回车。这样,虚拟机就会开始执行。
79
80
81
82## 手动搭建开发环境
83
84  若您追求快速的编译速度,以及完整的开发调试支持,且愿意花费半个小时到两个小时的时间来配置开发环境的话,该小节的内容能帮助到您。
85
86### 软件依赖
87
88  您需要编译安装以下软件依赖。他们的源代码可以在对应项目的官方网站上获得。
89
90- grub 2.06 (不必使用sudo权限进行install)
91- qemu 6.2.0 (启用所有选项)
92
93  需要注意的是,编译安装qemu将会是一件费时费力的工作,它可能需要花费你40分钟以上的时间。
94
95  对于以下软件依赖,建议您使用系统自带的包管理器进行安装。
96
97- gcc >= 8.3.0
98
99- xorriso
100
101- fdisk
102
103- make
104
105- VNC Viewer
106
107- gdb
108
109
110
111### 编译DragonOS
112
1131. 安装编译及运行环境
1142. 进入DragonOS文件夹
1153. 输入命令:`make -j 16`即可编译
116
117
118
119### 创建磁盘镜像
120
121  首先,您需要使用`sudo`权限运行`tools/create_hdd_image.sh`,为DragonOS创建一块磁盘镜像文件。该脚本会自动完成创建磁盘镜像的工作,并将其移动到`bin/`目录下。
122
123### 运行DragonOS
124
125  至此,准备工作已经完成,您可以在DragonOS项目的根目录下,输入
126
127```shell
128bash run.sh
129```
130
131  然后,DragonOS将会被启动,您可以通过VNC Viewer连接至虚拟机。在qemu虚拟机被启动后,我们需要在控制台输入字母`c`,然后回车。这样,虚拟机就会开始执行。
132