Blog
Bleiben Sie mit aktuellen Nachrichten vom RuyiSDK-Team auf dem Laufenden
RuyiSDK 0.44 现已发布,对应的包管理器版本也为 0.44.0。您可前往以下位置之一下载 RuyiSDK 包管理器:
[!NOTE]
RISC-V 用户可以使用 pip 安装 ruyi,但由于 ruyi 依赖的部分 Python
库暂未在 PyPI 上提供 RISC-V 架构的预编译包,安装 ruyi 时 Python
包管理器会尝试从源代码编译安装这些依赖,可能非常耗时或编译失败。
如果您在 RISC-V 设备上安装 ruyi 时遇到问题,建议使用其他安装方法。
[!NOTE]
请注意:已知使用 pipx 安装 ruyi 会导致随后创建的 Ruyi
虚拟环境不可用,将在下个版本修复。在此之前,请不要使用 pipx 安装 ruyi。
本次更新主要包含了以下内容,祝您使用愉快!
- 遥测功能变更:
- 修复了遥测模式为
local 时,主动进行的 ruyi telemetry upload 不生效的问题。
- 出于 RuyiSDK 运营需要,如您的遥测模式为
on 且距离上次上传遥测数据至少 7 天,ruyi
则会在您下一次调用时上传遥测数据,不论预定的上传日为星期几。
- 出于 RuyiSDK 运营需要,如您在首次运行
ruyi 时选择了禁用数据收集与上传,ruyi
仍然会进行一次上传,仅此一次,内容为不被保存的随机 ID 与当前 ruyi 版本号。
如您不希望进行此类上传,请确保您使用 ruyi 前为其设置了环境变量 RUYI_TELEMETRY_OPTOUT=1。
对于低频使用 ruyi 的用户而言,本次更新包含的变更可能允许 RuyiSDK 团队就您的安装
ID 而言 观测到比先前更具体的行为模式。截至目前 RuyiSDK 团队未进行过任何有关数据挖掘。
- 新增设备支持:
- 完善设备支持:
- 重命名 RV32 的
manual profile(用于手工管理编译参数)为 manual-rv32 以避免与 RV64 同名 profile 冲突。感谢 @Cyl18 报告!
- RuyiSDK 管理:
- 新增 RuyiSDK 自动检测功能:支持一键安装系统缺失的 RuyiSDK。
- 完善多版本管理:支持管理多个安装路径,并实现不同版本间的灵活切换。
- 虚拟环境:
- 新增可视化管理:支持通过树状视图直观查看并操作所有虚拟环境。
- 新增工作区感知:支持基于当前工作区智能检测并关联虚拟环境。
- 软件包管理:
- 新增搜索功能:支持快速检索并浏览 RuyiSDK 软件仓库。
- 优化安装体验:支持工具链与模拟器的一键提取与快速安装。
- 新增版本选择:支持在安装时手动指定软件包的具体版本。
- 完善系统集成:新增文件资源管理器右键菜单,支持直接提取 RuyiSDK 软件包。
- 新闻与更新:
- 新增资讯系统:支持实时查看 RuyiSDK 官方新闻与更新动态。
- 新增离线模式:支持缓存新闻内容,确保在离线状态下仍可阅读。
- 完善状态跟踪:支持自动记录并持久化新闻的阅读状态。
- 引入 Maven 管理构建流程和依赖,引入 CI 检查 DCO 规范并在 GitHub Pages 自动发布插件。
- 重构插件目录、优化现有文档。
- 制定代码风格约束,审查所有代码。
- 添加并测试“新闻”和“虚拟环境”模块。
- 菜单栏:在 "RuyiSDK" 下添加新闻和虚拟环境模块的入口。
- 发布:版本 0.1.0 。
RuyiSDK 0.44.0 版本已通过发版测试。该版本测试是基于 0.44.0-beta.20251219 测试版本开展的,预期 0.44.0
版本将基于 0.44.0-beta.20251219 版本代码发版。
RuyiSDK 0.43 现已发布,对应的包管理器版本也为 0.43.0。您可前往以下位置之一下载 RuyiSDK 包管理器:
[!NOTE]
RISC-V 用户可以使用 pip 安装 ruyi,但由于 ruyi 依赖的部分 Python
库暂未在 PyPI 上提供 RISC-V 架构的预编译包,安装 ruyi 时 Python
包管理器会尝试从源代码编译安装这些依赖,可能非常耗时或编译失败。
如果您在 RISC-V 设备上安装 ruyi 时遇到问题,建议使用其他安装方法。
本次更新主要包含了以下内容,祝您使用愉快!
- 允许在容器环境下以
root 身份运行 ruyi 了,以方便 CI 等受控场景。
- 会在新创建的 Ruyi 虚拟环境中记录所用 RuyiSDK 软件包的包名、版本号等元数据了,以便 RuyiSDK
IDE 等 RuyiSDK 生态组件取用。
- 工程化迭代:
- 支持了 Python 3.14 运行环境。
- 移除了
ruyi 对 packaging 的依赖。请打包人员更新依赖声明。
- 新增了集成测试框架,作为
ruyi-litester 的补充,有助于持续保证 ruyi 在小众场景下的功能不受破坏。
- 新增软件包:
source/riscv-gnu-toolchain-plct: toolchain/gnu-plct 的源码仓库集合。
- 新增设备支持:
- Milk-V Jupiter: 兼容各类 Bianbu 镜像。
- Sipeed LicheePi 3A: 兼容各类 Bianbu 镜像。
- SpacemiT MUSE Book: 兼容各类 Bianbu 镜像。
- SpacemiT MUSE Box: 兼容各类 Bianbu 镜像。
- 香山南湖笔记本: 兼容 RedleafOS。
- 完善了设备支持:
- 移除 Pine64 Star64 的 Armbian 支持: 上游已停止维护并不再提供系统镜像下载。
- 适用各类 SpacemiT K1 设备的 Bianbu Desktop 与 Bianbu Minimal: 新增适用于 eMMC 存储设备的镜像。
- 新增适用各类 SpacemiT K1 设备的 Bianbu Desktop Lite。
感谢 @weilinfox 的贡献!
RuyiSDK 0.43.0 版本已通过发版测试。该版本测试是基于 0.43.0-beta.20251118 测试版本开展的,预期 0.43.0
版本将基于 0.43.0-beta.20251118 版本代码发版。
RuyiSDK 0.42 现已发布,对应的包管理器版本也为 0.42.0。您可前往以下位置之一下载 RuyiSDK 包管理器:
[!NOTE]
RISC-V 用户可以使用 pip 安装 ruyi,但由于 ruyi 依赖的部分 Python
库暂未在 PyPI 上提供 RISC-V 架构的预编译包,安装 ruyi 时 Python
包管理器会尝试从源代码编译安装这些依赖,可能非常耗时或编译失败。
如果您在 RISC-V 设备上安装 ruyi 时遇到问题,建议使用其他安装方法。
本次更新主要包含了以下内容,祝您使用愉快!
- 默认遥测模式现已变更为
local——收集数据但不会自动上传。
- 相应地,在终端界面首次运行
ruyi 时,ruyi 会询问您的数据收集偏好,并帮您写入用户配置文件。
ruyi extract 命令的默认行为变更与其他改进:
ruyi extract 现在会将所请求的软件包内容解压到以软件包名、版本命名的独立目录下了。之前会直接解压到当前工作目录,如用户不提前阅读文档,可能会将用户的目录弄乱。如仍然需要先前的行为,可传入新增的 --extract-without-subdir 选项。
ruyi extract 现在支持 --dest-dir 或 -d 选项,以便指定解压到非当前工作目录的其他目录了。
ruyi extract 也新增了 --fetch-only 或 -f 选项,与 ruyi install 相应选项保持一致。
- 打磨了命令行用户体验:
- 在受支持的终端下,
ruyi 会把重要的手工操作用红色加粗样式体现了。
- 首次运行
ruyi 前,当您尝试命令行自动补全时,不会错误地打印出提示信息了。
- 用来下载软件包但不安装或解压的
ruyi install -f 现在支持下载源码类型的软件包了。
- 若用户下载了
ruyi 的单二进制文件发行版,但忘记将其重命名为 ruyi,ruyi 会在运行时提醒用户这么做了。
- 修复了一些问题:
- 当
repo.local 的值为空字符串或与默认值相等时,不会被判定为自定义了软件源本地路径了。
- 修复了自动管理软件源远程分支时,变更了
repo.remote 之后需要两次 ruyi update 才会体现的问题。
ruyi clean --all 不会残留软件包安装状态记录了。
- 不再允许使用用户配置文件去覆盖那些不面向用户的配置项了。
- 更新了文档:
- 写明了
ruyi 配置文件的系统全局搜索路径,供打包人员、系统管理员等参考。感谢 @bkmgit 的贡献!
- 工程化迭代:
ruyi 对 packaging 的依赖已不再必要,将于 0.43.0 版本移除。届时请打包人员更新依赖声明。
- 实体数据库更新:
- Ruyi 虚拟环境所用的 profiles 现已通过
profile-v1 实体类型暴露,如 profile-v1:generic。
- 工程化迭代:
RuyiSDK 0.42.0 版本已通过发版测试。该版本测试是基于 0.42.0-alpha.20251013、0.42.0-beta.20251015 和 0.42.0-beta.20251017 三个测试版本开展的,预期 0.42.0
版本将基于 0.42.0-beta.20251017 版本代码发版。下面的表格记录了 0.42.0-beta.20251017 版本新增未修复缺陷:
由于 RevyOS 删除大量历史版本镜像,导致 RevyOS 上游、操作系统支持矩阵和 Ruyi 包管理器软件源两两均不对应。
已经确认修复细节,并定于 0.43.0 版本前修复。
同时可以参考下面的表格来跟踪历史遗留问题的修复进度:
这些遗留问 题并不会影响 Ruyi 包管理器核心功能的实现,但可能影响用户体验,故建议在下载和更新您的
Ruyi 包管理器版本前了解。其中 packages-index 相关问题将主要影响 ruyi device provision
功能,请不要使用 BananaPi BPI-F3 开发板的 BananaPi BPI-F3 (eMMC storage) 镜像和
Pine64 Star64 开发板的 Armbian for Pine64 Star64 镜像,相关缺陷修复后可以通过
ruyi update 解决。
RuyiSDK 0.41 现已发布,对应的包管理器版本也为 0.41.0。您可前往以下位置之一下载 RuyiSDK 包管理器:
本次更新主要包含了以下内容,祝您使用愉快!
ruyi update 在访问网络前后会打印提示信息了。
- 如果执行
ruyi 命令时触发了软件源同步动作,会打印提示信息了。
ruyi news(不带子命令调用时)会提示当前未读新闻的信息了。
- 当您在 bash 或 zsh 环境下首次执行单文件发行版的
ruyi 时,会提示配置 Shell 自动补全了。
- RuyiSDK 设备安装器在询问
dd 命令的目标设备文件时,会检查其是否当前正被挂载,并拒绝您填入正被挂载的设备了。
- 工程化迭代:
- 为方便发行版打包工作,重新提供了兼容 Poetry 1.0.7 版本的 Python 项目元数据。
- 为方便测试工作,现在会为 Debian、deepin、Ubuntu 三种发行版为每个
ruyi tag 自动化打包了。
- 新增软件包:
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 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
版本修复:
同时可以参考下面的表格来跟踪历史遗留问题的修复进度:
这些遗留问题并不会影响 RuyiSDK 包管理器核心功能的实现,但可能影响用户体验,故建议在下载和更新您的 RuyiSDK 包管理器版本前了
解。其中 packages-index 相关问题将主要影响 ruyi device provision 功能,请不要使用 BananaPi BPI-F3 开发板的
BananaPi BPI-F3 (eMMC storage) 镜像和 Pine64 Star64 开发板的 Armbian for Pine64 Star64 镜像,相关缺陷修
复后可以通过 ruyi update 解决。
RuyiSDK 0.40 现已发布,对应的包管理器版本也为 0.40.0。您可前往以下位置之一下载 RuyiSDK 包管理器:
本期我们重点优化了发版测试流程,进一步加强了版本发布前的兼容性与文档测试。因此,本期发布较常规节奏推迟了 2 天。