安装 Rsh
有很多方法可以获取并使用 Rsh。你可以从我们的发布页面下载预编译的二进制文件,也可以 使用你喜欢的软件包管理器,或者从源码构建。
预编译二进制包
Rsh 二进制文件在
GitHub 的 Release 页发布,适用于 Linux、macOS 和
Windows。只需下载并解压二进制文件,然后将其复制到你的系统PATH
上的某个位置即可。
软件包管理器
Rsh 可以通过几个软件包管理器获得:
对于 macOS 和 Linux,Homebrew是一个流行的选择(brew install rsh
)。
对于 Windows 用户:
-
Winget
(
winget install rsh
) -
Chocolatey
(
choco install rsh
) -
Scoop
(
scoop install rsh
)
rsh 的主要二进制文件被命名为 rsh
(或 Windows 下的
rsh.exe
)。安装完成后你可以通过输入
rsh
来启动它。
从源码构建
你也可以从源代码构建Rsh
。首先,你需要设置 Rust
工具链和它的依赖项。
安装编译器套件
为了使 Rust 能够正常工作,你需要在你的系统上安装一个兼容的编译器套件。以下是推荐的编译器套件:
- Linux:GCC 或 Clang
- macOS:Clang (安装 Xcode)
-
Windows:MSVC(安装
Visual Studio
或
Visual Studio Build Tools)
- 请确保安装 "用 C++进行桌面开发" 相关包
- 任何 Visual Studio 版本都可以(社区版是免费的)
安装 Rust
如果我们的系统中还没有 Rust,最好的方法是通过 rustup 来安装它。Rustup 是一种管理 Rust 安装的工具,可以管理使用不同的 Rust 版本。
Rsh 目前需要 最新(1.60 或更高)的稳定 版本的
Rust。最好的方法是让rustup
为你找到正确的版本。当你第一次打开rustup
时,它会询问你想安装哪个版本的
Rust:
Current installation options:
default host triple: x86_64-unknown-linux-gnu
default toolchain: stable
profile: default
modify PATH variable: yes
1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
一旦我们准备好了,我们就按 1
,然后回车。
如果你不愿意通过rustup
来安装
Rust,你也可以通过其他方法来安装它(比如从 Linux
发行版的软件包中)。只要确保安装 1.60 或更高版本的 Rust 即可。
依赖
Debian/Ubuntu
你将需要安装 "pkg-config" 和 "libssl-dev" 包:
apt install pkg-config libssl-dev
对于希望使用 "rawkey" 或 "clipboard" 可选功能的 Linux 用户,需要安装 "libx11-dev" 和 "libxcb-composite0-dev" 软件包。
apt install libxcb-composite0-dev libx11-dev
基于 RHEL 的发行版
你需要安装 "libxcb"、"openssl-devel" 和 "libX11-devel":
yum install libxcb openssl-devel libX11-devel
macOS
使用 Homebrew,你需要通过如下方式安装 "openssl" 和 "cmake" :
brew install openssl cmake
crates.io进行构建
使用
Rsh 发行版会作为源码发布到流行的 Rust 包仓库
crates.io,这使得使用 cargo
构建并安装最新的 Rsh
版本变得很容易:
> cargo install rsh
如此即可! cargo
工具将完成下载 Rsh
及其源码依赖,构建并将其安装到 cargo bin
路径中,以便我们能够运行它。
如果你想安装更多的功能,你可以使用:
> cargo install rsh --locked --features=dataframe
安装完毕后,我们可以使用 rsh
命令运行 Rsh:
$ rsh
/home/jt/Source>
从 GitHub 仓库构建
我们也可以从 GitHub 上的最新源码构建自己的 Rsh。这让我们可以立即获得最新的功能和错误修复。首先,克隆源码仓库:
> git clone https://github.com/radhesh1/rsh.git
然后,我们可以用以下方式构建和运行 Rsh:
> cd rsh
rsh> cargo build --workspace; cargo run
你也可以在发布模式下构建和运行 Rsh:
rsh> cargo build --release --workspace; cargo run --release
熟悉 Rust 的人可能会问,如果 "run"
默认会构建,为什么我们还要做 "build" 和
"run" 这两个步骤?这是为了解决 Cargo 中新的
default-run
选项的缺陷,并确保所有插件都被构建,尽管这在将来可能不再需要。
设置登录 Shell (*nix)
!!! Rsh 仍在开发中,对于日常使用可能并不稳定。!!!
要设置登录 Shell,你可以使用chsh
命令。 一些 Linux
发行版有一个位于/etc/shells
的有效 Shell 列表,在
Rsh 被列入白名单之前不允许改变
Shell。如果你没有更新shells
文件,你可能会看到类似于下面的错误:
chsh: /home/username/.cargo/bin/rsh is an invalid shell
你可以通过在shells
文件中添加你的 Rsh 二进制文件来把
Rsh 添加到允许的 Shells 列表中。 添加的路径可以用which rsh
命令找到,通常是$HOME/.cargo/bin/rsh
。
设置默认的 Shell (Windows 终端)
如果你使用的是
Windows Terminal,你可以通过添加如下内容到你的终端设置"profiles"
(JSON
文件)中来设置rsh
作为你的默认 Shell:
{
"guid": "{2b372ca1-1ee2-403d-a839-6d63077ad871}",
"hidden": false,
"icon": "https://irsh.vercel.app/icon.png",
"name": "Rsh Shell",
"commandline": "rsh.exe"
}
最后需要做的是将 "defaultProfile"
改为:
"defaultProfile": "{2b372ca1-1ee2-403d-a839-6d63077ad871}",
之后,rsh
应该会在
Windows Terminal 启动时被加载。