脚本安装程序
Deno 提供了 deno install
命令,便于安装和分发可执行代码。
deno install [OPTIONS...] [URL] [SCRIPT_ARGS...]
命令将在名称为 EXE_NAME
的情况下安装 URL
中提供的脚本。
此命令创建一个轻量级的可执行 shell 脚本,调用指定的 CLI 标志和主模块来调用
deno
。它被放置在安装根目录下的 bin
目录中。
示例:
$ deno install --allow-net --allow-read https://deno.land/std@$STD_VERSION/http/file_server.ts
[1/1] Compiling https://deno.land/std@$STD_VERSION/http/file_server.ts
✅ 文件服务安装成功。
/Users/deno/.deno/bin/file_server
要更改可执行文件名称,请使用 -n
/--name
:
deno install --allow-net --allow-read -n serve https://deno.land/std@$STD_VERSION/http/file_server.ts
默认情况下,可执行文件的名称是通过推理得到的:
- 尝试获取 URL 路径的文件名称。以上例为例,文件名称将变为“file_server”。
- 如果文件名称是一些通用的名称,如“main”、“mod”、“index”或“cli”,并且路径没有父级路径,则使用父级路径的文件名称。否则保持通用名称。
- 如果结果名有一个 '@...' 后缀,则删除该后缀。
要更改安装根目录,请使用 --root
:
deno install --allow-net --allow-read --root /usr/local https://deno.land/std@$STD_VERSION/http/file_server.ts
安装根目录的确定方法:
--root
选项DENO_INSTALL_ROOT
环境变量$HOME/.deno
如果需要,必须手动将它们添加到路径中。
echo 'export PATH="$HOME/.deno/bin:$PATH"' >> ~/.bashrc
您必须在安装时指定将用于运行脚本的权限。
deno install --allow-net --allow-read https://deno.land/std@$STD_VERSION/http/file_server.ts -p 8080
上述命令将创建一个名为 file_server
的可执行文件,该文件以网络和读取权限运行,并绑定到端口 8080。
为了保持良好的实践,使用 import.meta.main
习惯用法来指定可执行脚本中的入口点。
示例:
// https://example.com/awesome/cli.ts
async function myAwesomeCli(): Promise<void> {
// -- snip --
}
if (import.meta.main) {
myAwesomeCli();
}
创建可执行脚本时,请确保向用户展示一个示例安装命令,将其添加到仓库中:
# 使用 deno install 安装
$ deno install -n awesome_cli https://example.com/awesome/cli.ts
卸载
您可以通过 deno uninstall
命令卸载脚本。
$ deno uninstall file_server
文件服务已卸载
/Users/deno/.deno/bin/file_server 已删除
✅ 文件服务卸载成功。
有关更多详细信息,请参见 deno uninstall -h
。