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.1.0-beta3 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 67make run-docker 68``` 69 70 71  稍等片刻，DragonOS将会被运行。 72 73  在qemu虚拟机被启动后，我们需要在控制台输入字母`c`，然后回车。这样，虚拟机就会开始执行。 74 75:::{note} 76首次编译时，由于需要下载Rust相关的索引（几百MB大小），因此需要一定的时间，请耐心等候！ 77::: 78 79**关于编译命令的用法，请见：{ref}`编译命令讲解 <_build_system_command>`** 80 81## 手动搭建开发环境 82 83  若您追求快速的编译速度，以及完整的开发调试支持，且愿意花费半个小时到两个小时的时间来配置开发环境的话，该小节的内容能帮助到您。 84 85### 软件依赖 86 87  您需要编译安装以下软件依赖。他们的源代码可以在对应项目的官方网站上获得。 88 89- grub 2.06 (不必使用sudo权限进行install) 90- qemu 6.2.0 (启用所有选项) 91 92  需要注意的是，编译安装qemu将会是一件费时费力的工作，它可能需要花费你40分钟以上的时间。 93 94  对于其余的软件依赖，我们提供了一键配置脚本，可以一键安装，只需要在控制台运行以下命令： 95 96```shell 97cd tools 98bash bootstrap.sh 99``` 100:::{note} 101一键配置脚本目前只支持以下系统： 102 103- Ubuntu/Debian/Deepin/UOS 等基于Debian的衍生版本 104 105欢迎您为其他的系统完善构建脚本！ 106::: 107 108 109### 创建磁盘镜像 110 111  首先，您需要使用`sudo`权限运行`tools/create_hdd_image.sh`，为DragonOS创建一块磁盘镜像文件。该脚本会自动完成创建磁盘镜像的工作，并将其移动到`bin/`目录下。 112 113 114### 编译DragonOS 115 1161. 安装编译及运行环境 1172. 进入DragonOS文件夹 1183. 输入命令：`make -j 16`即可编译 1194. 输入`make build`即可编译并写入磁盘镜像 120 121 122 123 124### 运行DragonOS 125 126  至此，准备工作已经完成，您可以在DragonOS项目的根目录下，输入 127 128```shell 129make run 130``` 131 132  然后，DragonOS将会被启动，您可以通过VNC Viewer连接至虚拟机。在qemu虚拟机被启动后，我们需要在控制台输入字母`c`，然后回车。这样，虚拟机就会开始执行。 133 134:::{note} 135首次编译时，由于需要下载Rust相关的索引（几百MB大小），因此需要一定的时间，请耐心等候！ 136::: 137 138**关于编译命令的用法，请见：{ref}`编译命令讲解 <_build_system_command>`** 139 140(_build_system_command)= 141## 编译命令讲解 142 143- 本地编译，不运行: `make all -j 您的CPU核心数` 144- 本地编译，并写入磁盘镜像，不运行: `make build` 145- 本地编译，写入磁盘镜像，并在QEMU中运行: `make run` 146- Docker编译，并写入磁盘镜像,: `make docker` 147- Docker编译，写入磁盘镜像，并在QEMU中运行: `make run-docker` 148- 不编译，直接从已有的磁盘镜像启动: `make qemu`