操作系统信息

GitHub npm crates.io

API 参考

使用操作系统信息插件读取有关操作系统的信息。

支持的平台

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

平台	级别	注释
windows
linux
macos
android
ios

设置

安装操作系统信息插件以开始使用。

自动

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

npm

npm run tauri add os

yarn

yarn run tauri add os

pnpm

pnpm tauri add os

deno

deno task tauri add os

bun

bun tauri add os

cargo

cargo tauri add os

手动

1. 在 src-tauri 文件夹中运行以下命令，将插件添加到 Cargo.toml 项目的依赖项中

   cargo add tauri-plugin-os

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

   src-tauri/src/lib.rs

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

3. 如果你想在 JavaScript 中使用，也请安装 npm 包

   npm

   npm install @tauri-apps/plugin-os

   yarn

   yarn add @tauri-apps/plugin-os

   pnpm

   pnpm add @tauri-apps/plugin-os

   deno

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

   bun

   bun add @tauri-apps/plugin-os

用法

使用此插件，你可以查询当前操作系统的多项信息。请参阅 JavaScript API 或 Rust API 参考文档中的所有可用函数。

示例：操作系统平台

platform 返回一个字符串，描述正在使用的特定操作系统。该值在编译时设置。可能的值为 linux、macos、ios、freebsd、dragonfly、netbsd、openbsd、solaris、android、windows。

JavaScript

import { platform } from '@tauri-apps/plugin-os';
// when using `"withGlobalTauri": true`, you may use
// const { platform } = window.__TAURI__.os;

const currentPlatform = platform();
console.log(currentPlatform);
// Prints "windows" to the console

Rust

let platform = tauri_plugin_os::platform();
println!("Platform: {}", platform);
// Prints "windows" to the terminal

权限

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

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

src-tauri/capabilities/default.json

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

默认权限

此权限集配置可以从前端收集哪些操作系统信息。

已授予的权限

除主机名外的所有信息均可用。

此默认权限集包括以下内容

• allow-arch
• allow-exe-extension
• allow-family
• allow-locale
• allow-os-type
• allow-platform
• allow-version

权限表

标识符	描述
os:allow-arch	启用 arch 命令，无需任何预配置的作用域。
os:deny-arch	拒绝 arch 命令，无需任何预配置的作用域。
os:allow-exe-extension	启用 exe_extension 命令，无需任何预配置的作用域。
os:deny-exe-extension	拒绝 exe_extension 命令，无需任何预配置的作用域。
os:allow-family	启用 family 命令，无需任何预配置的作用域。
os:deny-family	拒绝 family 命令，无需任何预配置的作用域。
os:allow-hostname	启用 hostname 命令，无需任何预配置的作用域。
os:deny-hostname	拒绝 hostname 命令，无需任何预配置的作用域。
os:allow-locale	启用 locale 命令，无需任何预配置的作用域。
os:deny-locale	拒绝 locale 命令，无需任何预配置的作用域。
os:allow-os-type	启用 os_type 命令，无需任何预配置的作用域。
os:deny-os-type	拒绝 os_type 命令，无需任何预配置的作用域。
os:allow-platform	启用 platform 命令，无需任何预配置的作用域。
os:deny-platform	拒绝 platform 命令，无需任何预配置的作用域。
os:allow-version	启用 version 命令，无需任何预配置的作用域。
os:deny-version	拒绝 version 命令，无需任何预配置的作用域。