跳到主要内容

安装

让我们从 RuyiSDK 包管理器的安装开始。

本文档使用 ~ 表示当前普通用户的家目录，必要时使用 /home/foo 作为家目录绝对路径示例。

使用预编译的二进制安装​

目前 RuyiSDK 包管理器工具为 Linux 系统预编译了 amd64、arm64、riscv64 三种架构的二进制，它不依赖系统 Python，适用范围较为广泛。

它们同时发布在 GitHub Release 和 ISCAS 镜像站上：

以 ISCAS 镜像源为例描述安装流程，首先运行 uname -m 检查系统架构并下载对应的二进制。

如果输出为 x86_64：

$ wget

如果输出为 aarch64：

$ wget

如果输出为 riscv64：

$ wget

您也可以浏览 RuyiSDK 镜像 以获取更新的版本。您也可以选择从 GitHub releases 下载。

下面以 x86_64 架构为例，给下载的二进制添加执行权限：

$ chmod +x ./ruyi.amd64

安装二进制到 PATH 包含的目录中：

$ sudo cp -v ruyi.amd64 /usr/local/bin/ruyi

如果您的 PATH 中包含 ~/.local/bin/ 目录，将 ruyi 安装到 ~/.local/bin/ruyi 可能会是一个更推荐的选择。这个目录下的安装和删除并不需要超级用户权限。

注意二进制文件名必须为 ruyi。

使用系统包管理器安装​

Arch Linux​

目前 Arch Linux 用户可以使用系统包管理器安装和卸载 Ruyi 包管理器，相对于使用预编译的二进制安装，维护更加便利；使用系统 Python 也可以获得更好的性能。

从 AUR 安装，以 yay 为例，注意应当使用普通用户：

$ yay -S ruyi

从 Arch Linux CN 软件源安装，以 ISCAS 开源镜像站为例添加配置：

[archlinuxcn]
Server = https://mirror.iscas.ac.cn/archlinuxcn/$arch

使用 pacman 安装：

$ sudo pacman -Sy
$ sudo pacman -S ruyi

Gentoo Linux​

Gentoo Linux 用户可参考以下步骤，通过官方提供的 ruyisdk-overlay 安装并配置 Ruyi 包管理器（ruyi）。

  1. 安装 eselect-repository 与 Git 客户端：
sudo emerge --ask app-eselect/eselect-repository dev-vcs/git

  1. 确保系统已添加主 Gentoo 仓库（通常已默认配置）。

  2. 使用 eselect-repository 添加 ruyisdk-overlay

sudo eselect repository add ruyisdk git https://github.com/ruyisdk/ruyisdk-overlay.git
  1. 同步仓库
sudo emaint sync -r ruyisdk
  1. 接受测试关键字（Unmask）

Ruyi 的 ebuild 被标记为测试版本 (~amd64)，需要解屏蔽才能安装。

sudo emerge dev-util/ruyi --autounmask-write --autounmask
sudo dispatch-conf

  1. 第一条命令会生成必要的 package.accept_keywords 改动。

  2. 运行 dispatch-conf ，并在界面中输入 u（use-new）接受改动。

  3. 安装 Ruyi 包管理器

sudo emerge --ask dev-util/ruyi

验证你的安装​

$ ruyi version

命令应当可以正常运行并打印版本和 Copyright 信息，如果失败请检查系统环境或重新尝试安装。

开始使用​

至此 Ruyi 包管理器已经成功安装在您的系统中。可以从 Ruyi 本身帮助信息中了解使用方法，或继续阅读本文档。

列出帮助信息：

$ ruyi --help