18 Opener

原文链接: https://tauri.app/plugin/opener/

用指定的应用或默认应用打开文件和 URL，并可在系统文件管理器中“显示”文件。

支持的平台

设置

自动

使用你的项目包管理器添加依赖：

• npm
• yarn
• pnpm
• deno
• bun
• cargo

1

npm run tauri add opener

1

yarn run tauri add opener

1

pnpm tauri add opener

1

deno task tauri add opener

1

bun tauri add opener

1

cargo tauri add opener

手动

1. 在 src-tauri 文件夹中运行以下命令，把插件加入 Cargo.toml 里的项目依赖：

   1	cargo add tauri-plugin-opener

2. 修改 lib.rs 初始化插件：

   1 2 3 4 5 6 7

   #[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run() { tauri::Builder::default() .plugin(tauri_plugin_opener::init()) .run(tauri::generate_context!()) .expect("error while running tauri application"); }

3. 用你偏好的 JavaScript 包管理器安装 JavaScript 端绑定：

• npm
• yarn
• pnpm
• deno
• bun

1

npm install @tauri-apps/plugin-opener

1

yarn add @tauri-apps/plugin-opener

1

pnpm add @tauri-apps/plugin-opener

1

deno add npm:@tauri-apps/plugin-opener

1

bun add @tauri-apps/plugin-opener

用法

opener 插件在 JavaScript 和 Rust 中都可以使用。

语言

• JavaScript
• Rust

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

import { openPath, openUrl } from '@tauri-apps/plugin-opener';
// 使用 `"withGlobalTauri": true` 时，你可以这样写
// const { openPath } = window.__TAURI__.opener;

// 用默认程序打开文件：
await openPath('/path/to/file');
// 在 Windows 上用 `vlc` 命令打开文件：
await openPath('C:/path/to/file', 'vlc');
// 用默认程序打开 URL：
await openUrl('https://tauri.app');

1
2
3
4
5
6
7
8

use tauri_plugin_opener::OpenerExt;

// 用默认程序打开文件：
app.opener().open_path("/path/to/file", None::<&str>);
// 在 Windows 上用 `vlc` 命令打开文件：
app.opener().open_path("C:/path/to/file", Some("vlc"));
// 用默认程序打开 URL：
app.opener().open_url("https://tauri.app", None::<&str>);

权限

默认情况下，所有有潜在危险的插件命令和作用域都被阻止，无法访问。你必须在 capabilities 配置中修改权限才能启用它们。

更多信息请参阅能力概述，以及使用插件权限的分步指南。

1
2
3
4
5
6

{
  "permissions": [
    ...,
    "opener:default"
  ]
}