入门（Getting Started）

安装 Rive CLI、创建项目，并打开实时预览。完成本指南后，你会得到一个可用 Rive 运行时加载的 .riv 文件。

1. 安装 CLI

CLI 可在搭载 Apple Silicon 的 macOS、Linux x86_64 以及 Windows 上运行。

Installer

curl -fsSL https://releases.rive.app/cli/install.sh | sh

把 CLI 加入 PATH，以便在每个新 shell 中都能使用 rive 命令，然后重新加载当前 shell 使改生效：

echo 'export PATH="$HOME/.rive/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows

irm https://releases.rive.app/cli/install.ps1 | iex

Homebrew

brew install --cask rive-app/tap/rive-cli

rive update、rive switch 和 rive uninstall 需要 ~/.rive 下的安装器构建，因此它们不适用于 Homebrew 安装。请改用 brew 管理 Homebrew 安装，例如 brew upgrade 和 brew uninstall --cask rive-cli。

运行 rive doctor 检查安装是否成功。

2. 创建项目

rive create myproject

这会写入一份 rive.yaml、供编码代理使用的 AGENTS.md 和 CLAUDE.md、一份 .gitignore，以及一份 scene.rml。scene.rml 与编辑器新建文件时给出的画面相同：一个画板、一条时间轴，以及加载时播放该时间轴的状态机。你添加并打上关键帧的形状会立即开始动画，无需额外配置。

之后放进文件夹的其他内容会按扩展名被自动拾取：.luau 脚本、.wgsl 着色器、图像和字体。生成的 rive.yaml 会设置 name 并打开构建日志；rive.yaml 中的其余项都是可选的。

3. 打开预览窗口

rive myproject

这会打开一个显示场景的窗口，并监视该目录。保存任意文件后，它会重建并重新加载，同时写出 myproject/build/myproject.riv——你可以用运行时加载的文件。

新项目里还没有绘制任何内容，因此你会看到一个深色矩形。让它在一个终端里保持运行，同时在另一个终端里编辑。

若要构建但不打开窗口，使用 rive myproject --once。若只要检查项目能否编译、不写出任何文件，使用 --verify。

从账户中的文件起步

如果作品已经存在于你的 Rive 账户中，把它下载到项目里：

rive create myproject --from-remote-file
rive myproject

CLI 会列出你的项目和文件供你选择。rive.yaml 会记录该链接，因此 rive push 可以把改动发回，rive pull 则可以把编辑器中的改动拉下来。这需要先用 rive login 登录。

从导出的 .rev 起步

你也可以把从编辑器导出的 .rev 转换成项目，这条路径不需要登录：

rive create myproject --from-rev=myfile.rev # --from-rev 接受 .rev 的路径
rive myproject

场景会写成 scene.rml，每个脚本、着色器和资源都会写成各自的文件，布局方式与编辑器 Assets 面板中的一致。你还会得到常规的 rive.yaml、AGENTS.md 和 .gitignore，从这一步起它就是一个普通项目。

项目名必须为空或全新。省略项目名时会使用 .rev 自身的名称，因此 myfile.rev 会变成 myfile/。

1. 安装 CLI​

Installer​

Windows​

Homebrew​

2. 创建项目​

3. 打开预览窗口​

从账户中的文件起步​

从导出的 .rev 起步​

登录​

更多资源​