Skip to content

Latest commit

 

History

History
150 lines (94 loc) · 7.06 KB

QA.md

File metadata and controls

150 lines (94 loc) · 7.06 KB

常见问题解答

Q0：GitHub classroom 是啥？如何使用？

A：

 - [B 站的 GitHub Classroom 视频介绍](https://www.bilibili.com/video/BV12L41147r7?spm_id_from=333.337.search-card.all.click&vd_source=8e19ee6e49f598fda8c17e306d8b3726) 
 - [Youtube 的 GitHub Classroom 视频介绍](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u)
 - [GitHub 文档：使用 GitHub Classroom 教学](https://docs.github.com/cn/education/manage-coursework-with-github-classroom/get-started-with-github-classroom)

Q1：已经在 classroom 中建立了自己的仓库（例如“LearningOS/lab0-0-setup-env-run-os1-chyyuu2022”），但是源仓库“LearningOS/rust-based-os-comp2022”更新了，如何处理？

A：

方法一：

重新点击加入课程的链接，在页面下方会有一行字“We've configured the repository associated with this assignment (update)”，“update”是一个链接，点击 update 就可以把自己的仓库更新到与最新状态的 repository template 一致。

​
方法二：

在自己构建的仓库根目录下执行以下命令：

git remote add upstream "https://github.com/LearningOS/rust-based-os-comp2022.git"
git fetch upstream
git checkout -b foo
git branch -D main
git checkout -t upstream/main
git reset --hard origin/main
git push -f

方法三：

向管理员“助教许善朴”申请删除已生成仓库，再点击 链接重新创建仓库。

Q2：在 classroom 中建立了自己的仓库中，进行提交 git push 后，触发 CI 后，出现 Annotations 错误“The job was not stared because recent account payments have failed or your spending limit needs to be increased. Please check the 'Billing & plans' section in your settings”，无法完成自动 CI 功能，比如 Autograding 等。

A：

方法一：

这是由于对用户的私有仓库进行 CI 相关的 GitHub Action 是需要付费的。用户可通过给自己的 github 账户充值来解决。https://docs.github.com/cn/billing/managing-billing-for-github-actions/about-billing-for-github-actions 给出了具体信息。

方法二：

对用户的公开仓库进行 CI GitHub Action 是不需要付费的。在项目的 `Settings` -> `Change visibility` 将项目改成 Public, 重新触发 Action。 
目前设置了让用户具有修改自己的项目从 private --> public 的能力。
如果用户还是发现自己的权限不够，或看不到  `Settings`  这个选项，可以通过联系助教帮助来解决。

Q3：我刚开始准备学习 Rust，是 Rust 新手，我应该如何入门？

A：

Q4：我不熟悉 GitHub 和 Git，有啥快速入门的资源吗？

A：

Q5：我不熟悉 Linux 的各种命令，有啥快速入门的资源吗？

A：

Q6：我碰到一些命令/应用（比如 vim, curl）、操作（比如 vscode）或语言用法（比如 Makefile）等不知到哪里能快速查找，怎么办？

A：

Q7：我可以正常 make run，但使用 make test 命令后，构件过程报了许多错（asm! not found in scope），Autograding 也无法通过，怎么办？

A：

这是由于内置的 ci-user/riscv 代码有错误，在 Autograding 时远程的 riscv 依赖被替换，导致编译失败。

方法一：

替换内置的 riscv 至正常版本，直接删除本地 `ci-user/riscv` 文件夹，替换为 [ Yakkhini / rust-based-os-comp2022](https://github.com/Yakkhini/rust-based-os-comp2022/tree/main/ci-user) 同位置的修复版本 `/riscv`。

方法二：

删除 `ci-user/overwrite.py` 21 行以下部分的依赖替换脚本。

方法三：

替换你实验文件夹中 `Cargo.toml` 的 riscv 依赖网址为 `https://GitHub.com/rcore-os/riscv`（修改了网址的大小写）或 `https://gitee.com/rcore-os/riscv`（改为 Gitee 源），使脚本中的替换匹配失效。

方法四：

如果你能看到这个 QA，说明相关 Pull request 已被 merge，可以按 QA1 中方法更新仓库。

Q8：在用vscode的esbonio （for Sphinx：rst-->html,...）和rust-analyzer插件时，不能正常工作。请问如何配置？

A：

esbonio error：找不到 conf.py 文件

解决方法

在 .vscode/settings.json中添加如下内容：

"esbonio.sphinx.confDir": "${workspaceFolder}/guide/source"

rust-analyzer插件无法正常解析源代码中的相关定义

比如 os/main.rs中，有如下代码：

#[cfg(feature = "board_k210")]
#[path = "boards/k210.rs"]
mod board;
#[cfg(not(any(feature = "board_k210")))]
#[path = "boards/qemu.rs"]
mod board;

这使得 mod board 可能是 k210.rs中的代码，也可能是qemu.rs中的代码，取决于编译时的参数，即 os/Makefile 中的：

@cargo build --release --features "board_$(BOARD)"

rust-analyzer会报错：unresolved import `crate::drivers::chardev::UART` 等错误

解决方法

在 .vscode/settings.json中添加如下内容：

// Prevent "can't find crate for `test`" error on no_std
// Ref: https://github.com/rust-lang/vscode-rust/issues/729
// For vscode-rust plugin users:
"rust.target": "riscv64gc-unknown-none-elf",
"rust.all_targets": false,
// For Rust Analyzer plugin users:
"rust-analyzer.cargo.target": "riscv64gc-unknown-none-elf",
"rust-analyzer.checkOnSave.allTargets": false,
"rust-analyzer.cargo.features": [
    "board_qemu"
]