diff --git a/source/chapter0/1setup-devel-env.rst b/source/chapter0/1setup-devel-env.rst index d544e07..eecb4de 100644 --- a/source/chapter0/1setup-devel-env.rst +++ b/source/chapter0/1setup-devel-env.rst @@ -18,23 +18,23 @@ classroom配置 ------------------------------- -基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace（在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 +基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace（在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。classroom配置步骤如下： -1.在网络浏览器中用自己的github id登录github.com + 1.在网络浏览器中用自己的github id登录github.com -2.接收实验练习uCore-RV-64的github classroom在线邀请(https://classroom.github.com/a/bY_uu2Q3)，根据提示接受该实验练习。 + 2.接收实验练习uCore-RV-64的github classroom在线邀请(https://classroom.github.com/a/bY_uu2Q3)，根据提示接受该实验练习。 -3.完成上一步后，你的实验练习uCore-RV-64的github repository会被自动建立好，刷新页面即可看到github repository的链接，点击此github repository的链接，就可看到你要完成的实验了。 + 3.完成上一步后，你的实验练习uCore-RV-64的github repository会被自动建立好，刷新页面即可看到github repository的链接，点击此github repository的链接，就可看到你要完成的实验了。 -4.在你的实验练习的网页的中上部可以看到一个醒目的code绿色按钮，点击后，可以进一步看到 codespace 标签和醒目的create codesapce on main绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu + vscode环境中。 + 4.在你的实验练习的网页的中上部可以看到一个醒目的code绿色按钮，点击后，可以进一步看到 codespace 标签和醒目的create codesapce on main绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu + vscode环境中。 -5.配置codespace中的开发环境（rustc，qemu等工具）。你可以在vscode的terminal中执行make ubuntu_setenv（需在master分支下）自动配置开发环境（执行``sudo``需要root权限，仅需要执行一次），也可以按照下面的环境安装提示在vscode的terminal中进行环境配置。 + 5.配置codespace中的开发环境（rustc，qemu等工具）。你可以在vscode的terminal中执行make ubuntu_setenv（需在master分支下）自动配置开发环境（执行``sudo``需要root权限，仅需要执行一次），也可以按照下面的环境安装提示在vscode的terminal中进行环境配置。 -6.重要：在vscode的terminal中执行make setupclassroom（需在master分支下，后面各分支的设置也需在master分支）配置github classroom的自动评分功能。也可分别配置各个分支的github classroom自动评分功能，例如：make setupclassroom1为配置ch1的github classroom自动评分功能，共有8个分支。 + 6.重要：在vscode的terminal中执行make setupclassroom（需在master分支下，后面各分支的设置也需在master分支）配置github classroom的自动评分功能。也可分别配置各个分支的github classroom自动评分功能，例如：make setupclassroom1为配置ch1的github classroom自动评分功能，共有8个分支。 -7.然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + 7.然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 -8.完成提交后会触发classroom提供的自动测试功能，你可以点击仓库名下边的“Actions”标签查看自动测试的结果，第一次提交触发自动测试可能需要执行5-7分钟，随后的提交所触发的自动测试则不需要这么长的时间。 + 8.完成提交后会触发classroom提供的自动测试功能，你可以点击仓库名下边的“Actions”标签查看自动测试的结果，第一次提交触发自动测试可能需要执行5-7分钟，随后的提交所触发的自动测试则不需要这么长的时间。 上述的3，4，5步不是必须的，你也可以直接克隆Github Classroom生成git repository到本地，按照下面的环境安装提示配置好本地的开发环境，然后在本地进行实验开发与提交。