操作系统信息

API Reference

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

支持的平台

本插件至少需要 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参考。

示例：操作系统平台

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	启用host命令而不设置任何预配置范围。
os:deny-hostname	禁止host命令而不设置任何预配置范围。
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命令而不设置任何预配置范围。