Lib.rs

向您的用户发送消息通知（简短自动过期的操作系统窗口元素）。也可以与 Notification Web API 一起使用。

安装

此插件需要至少 1.75 的 Rust 版本

我们可以推荐三种一般性的安装方法。

1. 使用 crates.io 和 npm（最简单，但需要您信任我们的发布管道）
2. 直接从 Github 使用 git 标签/修订哈希提取源代码（最安全）
3. 使用 Git 子模块安装此仓库到您的 Tauri 项目中，然后使用文件协议摄取源代码（最安全，但使用起来不方便）

通过添加以下内容到您的 Cargo.toml 文件安装核心插件

src-tauri/Cargo.toml

[dependencies]
tauri-plugin-notification = "2.0.0-rc"
# alternatively with Git:
tauri-plugin-notification = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }

您可以使用您喜欢的 JavaScript 包管理器安装 JavaScript 客户端绑定

注意：由于大多数 JavaScript 包管理器无法安装来自 git monorepos 的包，我们为每个插件提供了只读镜像。这使得安装选项更加直观。

pnpm add @tauri-apps/plugin-notification
# or
npm add @tauri-apps/plugin-notification
# or
yarn add @tauri-apps/plugin-notification

# alternatively with Git:
pnpm add https://github.com/tauri-apps/tauri-plugin-notification#v2
# or
npm add https://github.com/tauri-apps/tauri-plugin-notification#v2
# or
yarn add https://github.com/tauri-apps/tauri-plugin-notification#v2

用法

首先，您需要将核心插件注册到 Tauri 中

src-tauri/src/main.rs

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

然后，您需要将权限添加到您的能力文件中

src-tauri/能力/主要.json

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

之后，所有插件的 API 都将通过 JavaScript 客户端绑定提供

import { isPermissionGranted, requestPermission, sendNotification } from '@tauri-apps/plugin-notification';

async function checkPermission() {
  if (!(await isPermissionGranted())) {
    return (await requestPermission()) === 'granted';
  }
  return true;
}

export async function enqueueNotification(title, body) {
  if (!(await checkPermission())) {
    return;
  }
  sendNotification({ title, body });
}

贡献

PRs 被接受。在提交拉取请求之前，请确保您已阅读贡献指南。

合作伙伴

有关赞助商的完整列表，请访问我们的 网站 和 Open Collective。

许可证

代码：© 2015 - 至今 - The Commons Conservancy 中的 Tauri 项目。

适用于 MIT 或 MIT/Apache 2.0。