Lib.rs

为您的Tauri应用程序提供可配置的日志记录。

安装

此插件需要至少Rust 1.75 版本

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

1. 使用crates.io和npm（最简单，但需要您信任我们的发布管道）
2. 直接从Github使用git标签/版本号拉取源代码（最安全）
3. 将此仓库作为Git子模块安装到您的Tauri项目中，然后使用文件协议导入源代码（最安全，但使用不便）

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

src-tauri/Cargo.toml

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

如果您希望单实例机制仅对与您的应用程序semver兼容的实例触发，例如，如果您预计用户会安装多个您的应用程序，则可以将 features = ["semver"] 添加到 Cargo.toml 中的依赖声明。

然后，您可以使用您首选的JavaScript包管理器安装JavaScript客户端绑定

注意：由于大多数JavaScript包管理器无法从git单仓库中安装包，我们为每个插件提供了只读镜像。这使得选项2更易于使用。

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

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

用法

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

src-tauri/src/main.rs

use tauri_plugin_log::{Target, TargetKind};

fn main() {
    tauri::Builder::default()
        .plugin(tauri_plugin_log::Builder::new().targets([
            Target::new(TargetKind::Stdout),
            Target::new(TargetKind::LogDir { file_name: None }),
            Target::new(TargetKind::Webview),
        ]).build())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

之后，所有插件API都可通过JavaScript客户端绑定使用

import { trace, info, error, attachConsole } from "@tauri-apps/plugin-log";

// with TargetKind::Webview enabled this function will print logs to the browser console
const detach = await attachConsole();

trace("Trace");
info("Info");
error("Error");

// detach the browser console from the log stream
detach();

要从Rust代码中记录日志，将log包添加到您的 Cargo.toml

[dependencies]
log = "^0.4"

现在，您可以使用由log包提供的宏从后端记录消息。有关更多详细信息，请参阅文档。

贡献

接受PR。在提交拉取请求之前，请务必阅读贡献指南。

合作伙伴

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

许可证

代码：© 2015 - 现今 - Commons Conservancy 旗下的 Tauri 项目。

适用于 MIT 或 MIT/Apache 2.0。