第 053 期·2025 年 09 月 30 日

卷首语

各位 RuyiSDK 的小伙伴们，大家好！欢迎阅读第 53 期《RuyiSDK 双周进展》！

我们如期带来了 RuyiSDK 包管理器 0.41.0 版本，为大家的国庆假期准备了一份特别的“技术礼物”！每一个版本的迭代，都离不开社区朋友们的支持与反馈，我们由衷地感谢大家。

值此国庆佳节来临之际，祝大家节日快乐，阖家幸福！如果您在假期里有了闲暇时光，不妨来 RuyiSDK 的世界里转一转，体验一下新版本。也欢迎大家随时来 RuyiSDK 技术社区 浏览下关于 RISC-V 领域的新动态。

下个版本计划在 10 月 21 日发布，敬请关注！

包管理器

RuyiSDK 0.41 对应的包管理器版本也为 0.41.0，已于今日发布。您可移步 GitHub Releases、PyPI 或 ISCAS 镜像源下载体验。

• PyPI: pip install ruyi
• GitHub Releases
• ISCAS 镜像源

[!NOTE] RISC-V 用户可以使用 pip 安装 ruyi，但由于 ruyi 依赖的部分 Python 库暂未在 PyPI 上提供 RISC-V 架构的预编译包，安装 ruyi 时 Python 包管理器会尝试从源代码编译安装这些依赖，可能非常耗时或编译失败。

如果您在 RISC-V 设备上安装 ruyi 时遇到问题，建议使用其他安装方法。

本次 RuyiSDK 包管理器的更新主要包含了以下内容：

• ruyi update 在访问网络前后会打印提示信息了。
• 如果执行 ruyi 命令时触发了软件源同步动作，会打印提示信息了。
• ruyi news（不带子命令调用时）会提示当前未读新闻的信息了。
• 当您在 bash 或 zsh 环境下首次执行单文件发行版的 ruyi 时，会提示配置 Shell 自动补全了。
• RuyiSDK 设备安装器在询问 dd 命令的目标设备文件时，会检查其是否当前正被挂载，并拒绝您填入正被挂载的设备了。
• 工程化迭代：
  • 为方便发行版打包工作，重新提供了兼容 Poetry 1.0.7 版本的 Python 项目元数据。
  • 为方便测试工作，现在会为 Debian、deepin、Ubuntu 三种发行版为每个 ruyi tag 自动化打包了。

本次 RuyiSDK 软件源的更新主要包含了以下内容：

• 新增软件包：
  • source/jdk23u: OpenJDK 23 源码。
  • source/llvm: LLVM 源码。
  • source/llvm-plct: PLCT 维护的 LLVM 源码，带 RVP 扩展支持。
  • source/opencv: OpenCV 源码。
  • source/qemu: QEMU 源码。
  • source/qemu-plct: PLCT 维护的 QEMU 源码，带 RVP 扩展支持。
  • source/v8: V8 JavaScript 引擎。
• 更新软件包：
  • toolchain/gnu-plct: PLCT 维护的 GNU 工具链，0.20250912.0 版本。
  • toolchain/llvm-plct: PLCT 维护的 LLVM 工具链，21.1.0 版本。
  • toolchain/llvm-upstream: 上游版本 LLVM 工具链，21.1.1 版本。
• 完善了设备支持：
  • board-image/freebsd-riscv64-mini-live: 移除无法使用的旧版本，更新了新版本。
  • board-image/openbsd-riscv64-live: 移除无法使用的旧版本，更新了新版本。
  • board-image/ubuntu-server-riscv64-sifive-unmatched: 移除无法使用的旧版本，更新了新版本。
  • 为 ruyi 虚拟环境新增了 manual profile 支持。该 profile 不会代您配置任何编译参数，适用于需要自行控制 -march、-mabi 或 -mcpu 等参数的使用场景。
• 工程化迭代：
  • 移除了 ruyi 0.33.0 及更早版本的支持，以降低维护负担。
  • 系统性地为第三方软件源配置了相应的镜像列表。

感谢 @weilinfox 的贡献！

欢迎试用或来上游围观；您的需求是我们迭代开发的目标和动力。您也可以亲自参与 RuyiSDK 软件的打包与分发工作：目前您可以直接在 GitHub 上查看、修改我们的部分打包脚本与软件源仓库。今后，按照本年度的开发计划，我们也将支持有权的第三方贡献者通过程序化的方式上传软件包、系统镜像等分发文件，以便利打包工作。

IDE

VSCode 插件： 新增 VS Code 插件对 Ruyi 的检测与安装支持。主要包括：

• 新增 ruyi.detect 命令：启动自动检测，缺失时提示安装或打开指南
• 新增 ruyi.install 命令：通过 PyPI 安装/升级 Ruyi，仅支持 Linux
• 在 extension.ts 注册命令并触发检测
• feat: add Ruyi detect & install commands

Eclipse 插件： 本期无新增特性，欢迎对Eclipse插件开发有兴趣的小伙伴加入开发团队，详情参考 J159 RuyiSDK IDE 开发实习生 ，期待您的加入。

GCC

修复了Binutils中p扩展支持的一些编码问题，更新了GCC回归测试中发现的部分错误。 提交了Zvabd的binutils支持，正在处理Binutils寄存器对使用编号不正确的问题。

LLVM

upstream:

• [LLDB] Fix GetIndexOfChildMemberWithName to handle anonymous struct in base classes

xtheadvector:

• [LLVM][XTHeadVector] fix vwcvt, vwcvtu

V8

PLCT提交并合入的patch：

1. [riscv] Fix SimdCrossCompilerDeterminismTest.TestTernOp failed.
   [RISC-V] 修复 SimdCrossCompilerDeterminismTest.TestTernOp 测试失败问题
   chromium-review.googlesource.com/c/6965545
2. [riscv] Add Extension Zimop
   [RISC-V] 添加 Zimop 扩展
   chromium-review.googlesource.com/c/6955146
3. [riscv] Fix build for v8_enable_external_code_space
   [RISC-V] 修复 v8_enable_external_code_space 的构建问题
   chromium-review.googlesource.com/c/6934203
4. [riscv][wasmfx][jspi] Allow JSPI to suspend multiple stacks at once
   [RISC-V][wasmfx][JSPI] 允许 JSPI 同时挂起多个栈
   chromium-review.googlesource.com/c/6937846
5. [riscv] Fix custom-descriptors-inlining.js failed
   [RISC-V] 修复 custom-descriptors-inlining.js 执行失败问题
   chromium-review.googlesource.com/c/6928701

审阅并合入的patch：

1. [riscv] Only compile vlen intrinsic for RVV targets
   [RISC-V] 仅为 RVV 目标编译 vlen 内在函数
   chromium-review.googlesource.com/c/6959231
2. [riscv] Fix IsNodeUnsigned bug
   [RISC-V] 修复 IsNodeUnsigned 函数的漏洞
   chromium-review.googlesource.com/c/6958729
3. [riscv] Support architectures with 256-bit vector units
   [RISC-V] 支持带有 256 位向量单元的架构
   chromium-review.googlesource.com/c/6948289
4. [riscv] Replace more auipc+jalr into addi+jal
   [RISC-V] 将更多 auipc+jalr 指令组合替换为 addi+jal
   chromium-review.googlesource.com/c/6874383
5. [riscv] Refactor WASM Simd128 operations
   [RISC-V] 重构 WebAssembly 的 Simd128 操作
   chromium-review.googlesource.com/c/6948067
6. [riscv] Add more checks in IsNodeUnsigned to eliminate slli instructions
   [RISC-V] 在 IsNodeUnsigned 中添加更多检查以消除 slli 指令
   chromium-review.googlesource.com/c/6933681
7. [riscv] Fix compilation error and disassembling error when enabling the RISC-V C extension
   [RISC-V] 修复启用 RISC-V C 扩展时的编译错误和反汇编错误
   chromium-review.googlesource.com/c/6934163

操作系统支持矩阵

• Mars: debian: add trixie (mainline version)
• Add Tizen
• Bit-Brick_K1,LicheePi4A@OpenKylin 2.0 SP2
• Test LicheePi4A/Tizen
• Update mangopi_mq
• test LicheePi3A: Bianbu Desktop/Desktop Lite
• Opennovation.org 工程软件在 RISC-V 上的测试验证：https://github.com/QA-Team-lo/engineering-riscv

版本测试及遗留问题

RuyiSDK 0.41.0 版本已通过发版测试。该 版本测试是基于 0.41.0-beta.20250922 和 0.41.0-beta.20250926 两个测试版本开展的，预期 0.41.0 版本将基于 0.41.0-beta.20250926 版本代码发版。下面的表格记录了 0.41.0-beta.20250922 版本缺陷，该缺陷已在 0.41.0-beta.20250926 版本修复：

缺陷	问题等级	判定依据
[Feature Request] Provide information prompts when automatically running ruyi update #352	修复	在 0.41.0-beta-20250926 修复

同时可以参考下面的表格来跟踪历史遗留问题的修复进度：

缺陷	问题等级	备注
关于 fastboot 的文档提示 #95	严重	建立新的 issue 进行更新，且已拟订相关修复版本号为 0.42.0 版本
关于使用 pip 安装 ruyi 的文档提示 #96	严重	已有文档整体更新计划，已有具体时间节点和时间表安排
有一部分包无法下载 #37	一般	已有相关 issue 回复且已经在修复中
BananaPi BPI-F3 eMMC storage variant did not refer to any combo #101	一般	软件自带修复功能，且已有相关 issue 回复

这些遗留问题并不会影响 Ruyi 包管理器核心功能的实现，但可能影响用户体验，故建议在下载和更新您的 Ruyi 包管理器版本前了 解。其中 packages-index 相关问题将主要影响 ruyi device provision 功能，请不要使用 BananaPi BPI-F3 开发板的 BananaPi BPI-F3 (eMMC storage) 镜像和 Pine64 Star64 开发板的 Armbian for Pine64 Star64 镜像，相关缺陷修 复后可以通过 ruyi update 解决。