跳到正文
本页目录

安装依赖

lip 提供了灵活的依赖安装方式。

基础安装

按包 ID 安装包:

sh
lip install <PACKAGES>

示例:

sh
lip install github.com/user/repo

这会把该包中有对应工作区运行端和平台条目的最新版本,及其声明的依赖安装到工作区,并记录到状态文件中,但不会修改任何 lip.toml。

指定版本

可通过 @ 语法安装某个确切版本:

sh
lip install github.com/user/repo@1.0.0

如需选择变体,请在路径后追加 #<variant>,例如 github.com/user/repo#lua@1.0.0。

安装分支、标签或提交

如需试用尚未发布的改动,可安装分支的头、任意标签或某个提交:

sh
lip install github.com/user/repo@branch:main
lip install github.com/user/repo@tag:nightly
lip install github.com/user/repo@rev:0123456789abcdef0123456789abcdef01234567

状态文件会记录该提交,因此在 lip update 之前工作区始终保持该提交;lip update 会跟随分支到新的头。参见 git 引用。

从本地文件和目录安装

可直接从根部带有 lip.toml 的本地 ZIP 文件或目录安装,使用相对于当前目录的路径或绝对路径:

sh
lip install ./path/to/package.zip
lip install C:\Downloads\package.zip
lip install ../MyTool

这对发布前测试包很有用。

从远程 URL 安装

也可以直接从 HTTPS URL 安装根部带有 lip.toml 的 ZIP 归档:

sh
lip install https://example.com/package.zip

仅限服务端工作区

lip 管理服务端工作区:mod 安装到 mods/<name>/(参见环境)。客户端工作区由 LeviLauncher 等启动器管理,它们读取同样的包。

在 lip install、lip uninstall 或 lip update 在工作区中写入或删除文件之前,lip 会在 mods 不存在时创建它;不写入也不删除任何文件的操作(例如安装一个没有资源的包)不会触及 mods。若 mods 是链接,lip 停止,不做任何改动。

命令参数

  • -n, --dry-run:仅模拟安装,不做实际更改,可用于预览结果。