mirror of
https://github.com/LearningOS/rust-based-os-comp2022.git
synced 2026-05-05 16:01:07 +08:00
deploy: a8898ffe28
This commit is contained in:
chyyuu
@@ -301,14 +301,13 @@
|
||||
<li><p>试运行 rCore-Tutorial</p></li>
|
||||
</ul>
|
||||
<p>如果你在环境配置中遇到了无法解决的问题，请在本节讨论区留言，我们会尽力提供帮助。</p>
|
||||
<div class="section" id="os">
|
||||
<h2>OS 环境配置<a class="headerlink" href="#os" title="永久链接至标题">¶</a></h2>
|
||||
<p>目前，实验主要支持 Ubuntu18.04/20.04 操作系统。使用 Windows10 和 macOS 的读者，可以安装一台 Ubuntu18.04 虚拟机或 Docker
|
||||
进行实验。</p>
|
||||
<p>Windows10 用户可以通过系统内置的 <strong>WSL2</strong> 虚拟机（请不要使用 WSL1）来安装 Ubuntu 18.04 / 20.04 。读者请自行在互联网上搜索相关安装教程，或 <a class="reference external" href="https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package">适用于 Linux 的 Windows 子系统安装指南 (Windows 10)</a> 。</p>
|
||||
进行实验。也可基于 <strong>gihub classroom with codespaces</strong> 进行开发。</p>
|
||||
<div class="section" id="github-classroomos">
|
||||
<h2>Github Classroom方式进行在线OS 环境配置<a class="headerlink" href="#github-classroomos" title="永久链接至标题">¶</a></h2>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">注解</p>
|
||||
<p><strong>基于github classroom的开发方式</strong></p>
|
||||
<p><strong>基于github classroom的在线开发方式</strong></p>
|
||||
<p>基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。</p>
|
||||
<ol class="arabic simple">
|
||||
<li><p>在网络浏览器中用自己的 github id 登录 github.com</p></li>
|
||||
@@ -319,9 +318,11 @@
|
||||
<li><p><strong>重要：</strong> 在vscode的 <cite>console</cite> 中执行 <cite>make setupclassroom_testX</cite> （该命令仅执行一次，X的范围为 1-8）配置githubclassroom 自动评分功能。</p></li>
|
||||
<li><p>然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。</p></li>
|
||||
</ol>
|
||||
<p>上述的3，4，5步不是必须的，你也可以线下本地开发。</p>
|
||||
<p>注：如果是本地的ubuntu中建立开发环境，可在shell中执行 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">ubuntu_local_setenv</span></code> 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。</p>
|
||||
<p>上述的3，4，5步不是必须的，你也可以仅仅基于 <code class="docutils literal notranslate"><span class="pre">Github</span> <span class="pre">Classromm</span></code> 生成git repository，并进行本地开发。</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="dockeros">
|
||||
<h2>Docker方式进行本地OS开发环境配置<a class="headerlink" href="#dockeros" title="永久链接至标题">¶</a></h2>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">注解</p>
|
||||
<p><strong>Docker 开发环境</strong></p>
|
||||
@@ -334,14 +335,21 @@
|
||||
<li><p>通过 <code class="docutils literal notranslate"><span class="pre">ls</span></code> 可以发现 <code class="docutils literal notranslate"><span class="pre">/mnt</span></code> 目录下的内容和 <code class="docutils literal notranslate"><span class="pre">rCore-Tutorial-v3</span></code> 目录下的内容完全相同，接下来就可以在这个环境下运行 tutorial 了。例如 <code class="docutils literal notranslate"><span class="pre">cd</span> <span class="pre">os</span> <span class="pre">&&</span> <span class="pre">make</span> <span class="pre">run</span></code> 。</p></li>
|
||||
</ol>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="os">
|
||||
<h2>手动方式进行本地OS开发环境配置<a class="headerlink" href="#os" title="永久链接至标题">¶</a></h2>
|
||||
<blockquote>
|
||||
<div><p>注：如果是本地的ubuntu中建立开发环境，可在shell中执行 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">ubuntu_local_setenv</span></code> 来快速安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。</p>
|
||||
<p>当然，也可以通过如下详细介绍，一步一步地手动配置开发环境。</p>
|
||||
</div></blockquote>
|
||||
<p>Windows10 用户可以通过系统内置的 <strong>WSL2</strong> 虚拟机（请不要使用 WSL1）来安装 Ubuntu 18.04 / 20.04 。读者请自行在互联网上搜索相关安装教程，或 <a class="reference external" href="https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package">适用于 Linux 的 Windows 子系统安装指南 (Windows 10)</a> 。</p>
|
||||
<p>使用 macOS 进行实验理论上也是可行的，但本章节仅介绍 Ubuntu 下的环境配置方案。</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">注解</p>
|
||||
<p>经初步测试，使用 M1 芯片的 macOS 也可以运行本实验的框架，即我们的实验对平台的要求不是很高。但我们仍建议同学配置 Ubuntu 环境，以避免未知的环境问题。</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="rust">
|
||||
<h2>Rust 开发环境配置<a class="headerlink" href="#rust" title="永久链接至标题">¶</a></h2>
|
||||
<h3>Rust 开发环境配置<a class="headerlink" href="#rust" title="永久链接至标题">¶</a></h3>
|
||||
<p>首先安装 Rust 版本管理器 rustup 和 Rust 包管理器 cargo，可以使用官方安装脚本：</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>curl https://sh.rustup.rs -sSf <span class="p">|</span> sh
|
||||
</pre></div>
|
||||
@@ -393,7 +401,8 @@ curl https://sh.rustup.rs -sSf <span class="p">|</span> sh
|
||||
<span class="n">registry</span> <span class="o">=</span> <span class="s">"https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>推荐 JetBrains Clion + Rust插件 或者 Visual Studio Code 搭配 rust-analyzer 和 RISC-V Support 插件 进行代码阅读和开发。</p>
|
||||
<p>推荐 Visual Studio Code 搭配 rust-analyzer 和 RISC-V Support 插件 进行代码阅读和开发。</p>
|
||||
<p>也可采用 JetBrains Clion + Rust插件进行代码阅读和开发。</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">注解</p>
|
||||
<ul class="simple">
|
||||
@@ -404,7 +413,7 @@ curl https://sh.rustup.rs -sSf <span class="p">|</span> sh
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="qemu">
|
||||
<h2>Qemu 模拟器安装<a class="headerlink" href="#qemu" title="永久链接至标题">¶</a></h2>
|
||||
<h3>Qemu 模拟器安装<a class="headerlink" href="#qemu" title="永久链接至标题">¶</a></h3>
|
||||
<p>我们需要使用 Qemu 7.0.0 以上版本进行实验，为此，从源码手动编译安装 Qemu 模拟器：</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># 安装编译所需的依赖包</span>
|
||||
sudo apt install autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev <span class="se">\</span>
|
||||
@@ -450,6 +459,7 @@ qemu-riscv64 --version
|
||||
</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="rcore-tutorial">
|
||||
<h2>试运行 rCore-Tutorial<a class="headerlink" href="#rcore-tutorial" title="永久链接至标题">¶</a></h2>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/LearningOS/rust-based-os-comp2022.git
|
||||
@@ -577,9 +587,13 @@ Panicked at src/main.rs:48 Shutdown machine!
|
||||
<div class="toc-tree">
|
||||
<ul>
|
||||
<li><a class="reference internal" href="#">第零章：实验环境配置</a><ul>
|
||||
<li><a class="reference internal" href="#os">OS 环境配置</a></li>
|
||||
<li><a class="reference internal" href="#github-classroomos">Github Classroom方式进行在线OS 环境配置</a></li>
|
||||
<li><a class="reference internal" href="#dockeros">Docker方式进行本地OS开发环境配置</a></li>
|
||||
<li><a class="reference internal" href="#os">手动方式进行本地OS开发环境配置</a><ul>
|
||||
<li><a class="reference internal" href="#rust">Rust 开发环境配置</a></li>
|
||||
<li><a class="reference internal" href="#qemu">Qemu 模拟器安装</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a class="reference internal" href="#rcore-tutorial">试运行 rCore-Tutorial</a></li>
|
||||
<li><a class="reference internal" href="#gdb">GDB 调试支持*</a></li>
|
||||
</ul>
|
||||
|
||||
@@ -15,18 +15,18 @@
|
||||
|
||||
如果你在环境配置中遇到了无法解决的问题，请在本节讨论区留言，我们会尽力提供帮助。
|
||||
|
||||
OS 环境配置
|
||||
-------------------------------
|
||||
|
||||
|
||||
目前，实验主要支持 Ubuntu18.04/20.04 操作系统。使用 Windows10 和 macOS 的读者，可以安装一台 Ubuntu18.04 虚拟机或 Docker
|
||||
进行实验。
|
||||
进行实验。也可基于 **gihub classroom with codespaces** 进行开发。
|
||||
|
||||
Windows10 用户可以通过系统内置的 **WSL2** 虚拟机（请不要使用 WSL1）来安装 Ubuntu 18.04 / 20.04 。读者请自行在互联网上搜索相关安装教程，或 `适用于 Linux 的 Windows 子系统安装指南 (Windows 10) <https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package>`_ 。
|
||||
|
||||
Github Classroom方式进行在线OS 环境配置
|
||||
-----------------------------------------------------------
|
||||
|
||||
.. note::
|
||||
|
||||
**基于github classroom的开发方式**
|
||||
**基于github classroom的在线开发方式**
|
||||
|
||||
基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。
|
||||
|
||||
@@ -38,11 +38,13 @@ Windows10 用户可以通过系统内置的 **WSL2** 虚拟机（请不要使用
|
||||
6. **重要：** 在vscode的 `console` 中执行 `make setupclassroom_testX` （该命令仅执行一次，X的范围为 1-8）配置githubclassroom 自动评分功能。
|
||||
7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。
|
||||
|
||||
上述的3，4，5步不是必须的，你也可以线下本地开发。
|
||||
上述的3，4，5步不是必须的，你也可以仅仅基于 ``Github Classromm`` 生成git repository，并进行本地开发。
|
||||
|
||||
注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。
|
||||
|
||||
|
||||
Docker方式进行本地OS开发环境配置
|
||||
-------------------------------------------------
|
||||
|
||||
.. note::
|
||||
|
||||
**Docker 开发环境**
|
||||
@@ -56,14 +58,31 @@ Windows10 用户可以通过系统内置的 **WSL2** 虚拟机（请不要使用
|
||||
3. 进入 Docker 之后，会发现当前处于根目录 ``/`` ，我们通过 ``cd mnt`` 将当前工作路径切换到 ``/mnt`` 目录；
|
||||
4. 通过 ``ls`` 可以发现 ``/mnt`` 目录下的内容和 ``rCore-Tutorial-v3`` 目录下的内容完全相同，接下来就可以在这个环境下运行 tutorial 了。例如 ``cd os && make run`` 。
|
||||
|
||||
|
||||
|
||||
|
||||
手动方式进行本地OS开发环境配置
|
||||
----------------------------------------------
|
||||
|
||||
注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来快速安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。
|
||||
|
||||
当然，也可以通过如下详细介绍，一步一步地手动配置开发环境。
|
||||
|
||||
|
||||
Windows10 用户可以通过系统内置的 **WSL2** 虚拟机（请不要使用 WSL1）来安装 Ubuntu 18.04 / 20.04 。读者请自行在互联网上搜索相关安装教程，或 `适用于 Linux 的 Windows 子系统安装指南 (Windows 10) <https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package>`_ 。
|
||||
|
||||
|
||||
|
||||
|
||||
使用 macOS 进行实验理论上也是可行的，但本章节仅介绍 Ubuntu 下的环境配置方案。
|
||||
|
||||
.. note::
|
||||
|
||||
经初步测试，使用 M1 芯片的 macOS 也可以运行本实验的框架，即我们的实验对平台的要求不是很高。但我们仍建议同学配置 Ubuntu 环境，以避免未知的环境问题。
|
||||
|
||||
|
||||
Rust 开发环境配置
|
||||
-------------------------------------------
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
首先安装 Rust 版本管理器 rustup 和 Rust 包管理器 cargo，可以使用官方安装脚本：
|
||||
|
||||
@@ -135,7 +154,9 @@ Rust 开发环境配置
|
||||
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
|
||||
|
||||
|
||||
推荐 JetBrains Clion + Rust插件 或者 Visual Studio Code 搭配 rust-analyzer 和 RISC-V Support 插件 进行代码阅读和开发。
|
||||
推荐 Visual Studio Code 搭配 rust-analyzer 和 RISC-V Support 插件 进行代码阅读和开发。
|
||||
|
||||
也可采用 JetBrains Clion + Rust插件进行代码阅读和开发。
|
||||
|
||||
.. note::
|
||||
|
||||
@@ -144,7 +165,7 @@ Rust 开发环境配置
|
||||
* 当然，采用 VIM，Emacs 等传统的编辑器也是没有问题的。
|
||||
|
||||
Qemu 模拟器安装
|
||||
----------------------------------------
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
我们需要使用 Qemu 7.0.0 以上版本进行实验，为此，从源码手动编译安装 Qemu 模拟器：
|
||||
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user