操作系统信息

GitHub npm crates.io

API 参考

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

支持的平台

此插件需要 Rust 版本至少为 **1.77.2**

平台	级别	备注
Windows
Linux
macOS
Android
iOS

设置

安装 OS 信息插件即可开始使用。

自动

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

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 参考资料中的所有可用函数。

示例：OS 平台

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"
  ]
}

默认权限

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

已授予权限

除了主机名以外的所有信息都可用。

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

• 允许-架构
• 允许-可执行文件扩展名
• 允许-家族
• 允许-区域设置
• 允许-操作系统类型
• 允许-平台
• 允许-版本

权限表

标识符	描述
os:允许-架构	启用 arch 命令，不带任何预配置范围。
os:拒绝-架构	拒绝 arch 命令，不带任何预配置范围。
os:允许-可执行文件扩展名	启用 exe_extension 命令，不带任何预配置范围。
os:拒绝-可执行文件扩展名	拒绝 exe_extension 命令，不带任何预配置范围。
os:允许-家族	启用 family 命令，不带任何预配置范围。
os:拒绝-家族	拒绝 family 命令，不带任何预配置范围。
os:允许-主机名	启用 hostname 命令，不带任何预配置范围。
os:拒绝-主机名	拒绝 hostname 命令，不带任何预配置范围。
os:允许-区域设置	启用 locale 命令，不带任何预配置范围。
os:拒绝-区域设置	拒绝 locale 命令，不带任何预配置范围。
os:允许-操作系统类型	启用 os_type 命令，不带任何预配置范围。
os:拒绝-操作系统类型	拒绝 os_type 命令，不带任何预配置范围。
os:允许-平台	启用 platform 命令，不带任何预配置范围。
os:拒绝-平台	拒绝 platform 命令，不带任何预配置范围。
os:允许-版本	启用 version 命令，不带任何预配置范围。
os:拒绝-版本	拒绝 version 命令，不带任何预配置范围。