跳到主要内容

安装

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

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

使用预编译的二进制安装

目前 RuyiSDK 包管理器工具为 Linux 系统预编译了 amd64arm64riscv64 三种架构的二进制,它不依赖系统 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