RuyiSDK 0.42 版本更新说明

RuyiSDK 0.42 现已发布，对应的包管理器版本也为 0.42.0。您可前往以下位置之一下载 RuyiSDK 包管理器：

• PyPI: pip install ruyi
• https://github.com/ruyisdk/ruyi/releases/tag/0.42.0
• https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.42.0/

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

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

本次更新主要包含了以下内容，祝您使用愉快！

RuyiSDK 包管理器

• 默认遥测模式现已变更为 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 版本移除。届时请打包人员更新依赖声明。

RuyiSDK 软件源

• 实体数据库更新：
  • Ruyi 虚拟环境所用的 profiles 现已通过 profile-v1 实体类型暴露，如 profile-v1:generic。
• 工程化迭代：
  • 修复了一些第三方软件源镜像地址的配置问题。感谢 @weilinfox 的贡献！

版本测试及遗留问题

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 版本新增未修复缺陷：

缺陷	问题等级	判定依据
A large number of old revyos images were deleted #116	一般	软件自带修复功能，预期将在 0.43.0 版本前修复

由于 RevyOS 删除大量历史版本镜像，导致 RevyOS 上游、操作系统支持矩阵和 Ruyi 包管理器软件源两两均不对应。 已经确认修复细节，并定于 0.43.0 版本前修复。

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

缺陷	问题等级	备注
关于 fastboot 的文档提示 #95	严重	建立新的 issue 进行更新，且已拟订相关修复版本号为 0.43.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 解决。