Shell

API Reference

访问系统 shell。允许您生成子进程并使用其默认应用程序管理文件和 URL。

支持的平台

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android		Only allows to open URLs via `open`
ios		Only allows to open URLs via `open`

设置

请安装 shell 插件。

自动
手动

使用项目的包管理器来添加依赖。

npm run tauri add shell

yarn run tauri add shell

pnpm tauri add shell

bun tauri add shell

cargo tauri add shell

在你的 Cargo.toml 文件中添加以下内容来安装 shell 插件。

[dependencies]
tauri-plugin-shell = "2.0.0"
# 或者使用 Git：
tauri-plugin-shell = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }

修改 lib.rs 来初始化插件。

fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_shell::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

使用你喜欢的 JavaScript 包管理器安装 JavaScript Guest 绑定。

npm install @tauri-apps/plugin-shell

yarn add @tauri-apps/plugin-shell

pnpm add @tauri-apps/plugin-shell

bun add @tauri-apps/plugin-shell

用法

Shell 插件有 JavaScript 和 Rust 两种版本。

JavaScript
Rust

import { Command } from '@tauri-apps/plugin-shell';

let result = await Command.create('exec-sh', [
  '-c',
  "echo 'Hello World!'",
]).execute();
console.log(result);

use tauri_plugin_shell::ShellExt;

let shell = app_handle.shell();
let output = tauri::async_runtime::block_on(async move {
    shell
        .command("echo")
        .args(["Hello from Rust!"])
        .output()
        .await
        .unwrap()
});
if output.status.success() {
    println!("Result: {:?}", String::from_utf8(output.stdout));
} else {
    println!("Exit with code: {}", output.status.code().unwrap());
}

权限

默认情况下，所有插件命令都被阻止，无法访问。你必须在你的 capabilities 配置中定义一个权限列表。

更多信息请参见访问控制列表。

{
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "main-capability",
  "description": "Capability for the main window",
  "windows": ["main"],
  "permissions": [
    {
      "identifier": "shell:allow-execute",
      "allow": [
        {
          "name": "exec-sh",
          "cmd": "sh",
          "args": [
            "-c",
            {
              "validator": "\\S+"
            }
          ],
          "sidecar": false
        }
      ]
    }
  ]
}

权限	描述
`shell:allow-execute`	在没有预先配置的作用域的情况下启用 execute 命令。
`shell:deny-execute`	拒绝没有任何预配置范围的 execute 命令。
`shell:allow-kill`	在没有预先配置的作用域的情况下启用 kill 命令。
`shell:deny-kill`	拒绝没有任何预配置范围的 kill 命令。
`shell:allow-open`	在没有预先配置的作用域的情况下启用 open 命令。
`shell:deny-open`	拒绝没有任何预配置范围的 open 命令。
`shell:allow-stdin-write`	在没有预先配置的作用域的情况下启用 stdin_write 命令。
`shell:deny-stdin-write`	拒绝没有任何预配置范围的 stdin_write 命令。