操作系统信息

API Reference

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

🌐 Read information about the operating system using the OS Information plugin.

支持的平台

🌐 Supported Platforms

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

设置

🌐 Setup

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

🌐 Install the OS Information plugin to get started.

Automatic
Manual

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

npm run tauri add os

yarn run tauri add os

pnpm tauri add os

deno task tauri add os

bun tauri add os

cargo tauri add os

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

修改 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");
}

如果你想在 JavaScript 中使用，那么也请安装 npm 包：

npm install @tauri-apps/plugin-os

yarn add @tauri-apps/plugin-os

pnpm add @tauri-apps/plugin-os

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

bun add @tauri-apps/plugin-os

使用

🌐 Usage

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

🌐 With this plugin you can query multiple information from current operational system. See all available functions in the JavaScript API or Rust API references.

示例：操作系统平台

🌐 Example: OS Platform

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

JavaScript
Rust

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

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

权限

🌐 Permissions

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

🌐 By default all potentially dangerous plugin commands and scopes are blocked and cannot be accessed. You must modify the permissions in your capabilities configuration to enable these.

有关更多信息，请参见功能概览，有关使用插件权限的分步指南，请参见分步指南。

🌐 See the Capabilities Overview for more information and the step by step guide to use plugin permissions.

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

Default Permission

This permission set configures which operating system information are available to gather from the frontend.

Granted Permissions

All information except the host name are available.

This default permission set includes the following:

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

Permission Table

Identifier	Description
`os:allow-arch`	Enables the arch command without any pre-configured scope.
`os:deny-arch`	Denies the arch command without any pre-configured scope.
`os:allow-exe-extension`	Enables the exe_extension command without any pre-configured scope.
`os:deny-exe-extension`	Denies the exe_extension command without any pre-configured scope.
`os:allow-family`	Enables the family command without any pre-configured scope.
`os:deny-family`	Denies the family command without any pre-configured scope.
`os:allow-hostname`	Enables the hostname command without any pre-configured scope.
`os:deny-hostname`	Denies the hostname command without any pre-configured scope.
`os:allow-locale`	Enables the locale command without any pre-configured scope.
`os:deny-locale`	Denies the locale command without any pre-configured scope.
`os:allow-os-type`	Enables the os_type command without any pre-configured scope.
`os:deny-os-type`	Denies the os_type command without any pre-configured scope.
`os:allow-platform`	Enables the platform command without any pre-configured scope.
`os:deny-platform`	Denies the platform command without any pre-configured scope.
`os:allow-version`	Enables the version command without any pre-configured scope.
`os:deny-version`	Denies the version command without any pre-configured scope.