¶ 入门
¶ 重要链接一览
¶ 重要 Wiki 页面一览
¶ 必做流程
从以下流程中任选其一：
¶ 其一，测试方向
使用 实体 RISC-V 设备，测试写入运行 deepin 的镜像，并尝试进行软件更新、系统使用，查找并反馈 bug。
¶ 其二，修包方向
使用 实体 RISC-V 设备 或 qemu-user 搭一个打包的环境。前者可使用 deepin RISC-V 镜像，后者可自行 debootstrap。
¶ 参考链接
- deepin RISC-V 发布的镜像可在 镜像下载 页面获得。
- deepin RISC-V 预览版镜像可在 ci.deepin.org 仓库获得。
- deepin-port-image 项目可用于定制镜像。
- 使用
debootstrap或mmdebstrap可创建用于 QEMU 启动的 rootfs。 - deepin RISC-V 的内核 deb 可在 deepin-riscv-kernel 仓库的 actions 产出获取，也可以在 ci.deepin.org
v23-addons仓库的ports-kernel获得。
¶ RISC-V 专用仓库
¶ 镜像
https://ci.deepin.com/repo/deepin/deepin-ports/cdimage/
¶ 附加软件包仓库
https://ci.deepin.com/repo/deepin/deepin-ports/v23-addons/
ports-imggpu: Imagination GPU 驱动维护仓库ports-kernel: RISC-V 内核维护仓库ports-board-*: 设备专用软件包维护仓库
¶ 工作流
¶ 修包
¶ 测试
¶ 镜像测试
- 使用实体设备，写入最新或给定镜像，启动并进入 deepin 系统。
- 进行一些常规操作，测试系统 bug，并汇总为报告。
- 推荐同时安装 deepin amd64 版本作为对照以判断是否是 riscv64 架构特有问题
- 推荐自行设计标准化的自动/半自动测试方案
- 推荐定期更新系统
¶ 软件测试
- 在镜像测试的基础上，安装给定软件，测试软件是否运行正常，并汇总为报告。
¶ 内核/固件测试
- 在镜像测试的基础上，安装给定内核/uboot/启动固件，测试的系统是否运行正常，并汇总为报告。
- deepin-riscv-kernel 的工作流会定期构建内核，可参考源仓库的更新状况进行测试。
¶ 附加任务（可选）
- 为 镜像生成脚本 增加 QEMU 镜像支持。
- 使用以上脚本自行构建最新的 deepin RISC-V 镜像并测试。
¶ 必备组件
- 任何 deepin 适配的 RISC-V 设备
- 至少一个串口转 USB 模块（可选，若设备自带 usb 串口可以不需要）
- 至少一台显示器及连接线
- 至少一套键盘鼠标
- 至少一张 AMD 亮机显卡（可选，如果设备支持 PCI-E 并且希望测试独显）
- 至少一块 nvme 硬盘（可选，若设备仅支持 ssd 启动）
- 至少一张 SD 卡（可选，若设备内置存储可以不需要）
¶ Q&A
.
- Q: 我手里没有 RISC-V 设备怎么办？
- A: 需要 RISC-V 设备的同学可以通过 甲辰计划开发板漂流计划 获取。
¶ 修包部分
.
- Q: 怎么寻找需要修的包？
- A: 有几种方式：
- 在硬件/模拟设备上测试 deepin 镜像，发现问题后提交 issue，分析并找到存在问题的包。
- 在 OBS 构建系统的 main、community、dde 页面查找
riscv64构建失败或缺少依赖的包（注意，此处获得的信息不一定可靠，部分包可能已被修复或只是临时依赖缺失，需要与 deepin 开发者们一同沟通） - 查阅 deepin developer-center 的 issue 列表，找出与
riscv64有关的 issue 并验证是否还存在。
. - Q: 需要修那些包？
- A: 所有的包，只要影响在 RISC-V 架构上的使用和构建就需要修。
. - Q: 升级版本算可观测产出吗？
- A: 算，但是 deepin sysdev-team 内部有 bot 可进行自动包版本升级，手动升级版本费时费力且产出权重会降低。
¶ 注意事项
¶ 修包
入门常见问题：
- 一个 commit 对应一次修复，多次修改请 squash 合并后提交
- 一次修复对应一个 PR，不要反复关闭和创建 PR
- 每次提交的修改都请在 changelog 中新增条目并提升版本
- 除非升级版本，不要修改
debian/目录以外的文件
一般常见问题：
- changelog 请对照检查版本号规则
- 一些包由于某些原因被锁定不可升级，有 bot 作对应检查
- 升级版本可自动化，有需要请与 mentor 联系