OS Information（OS 情報）

《訳注》

Plugin 説明内容の英語表記部分について　Plugin の各章は、原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

API Reference

「OS Information（OS 情報）」プラグインを使用して、オペレーティング・システムに関する情報を読み取ります。

対応プラットフォーム

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

セットアップ

はじめに、「OS Information」プラグインをインストールしてください。

自動で設定
手動で設定

自分のプロジェクトのパッケージ・マネージャーを使用して依存関係を追加します：

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

使用法

このプラグインを使用すると、現在のオペレーティング・システム^*から複数の情報を照会できます。利用可能なすべての関数については、JavaScript API または Rust API の各リファレンスをご覧ください。

《訳注》

^* オペレーション・システム：　原文は operational system で、直訳では「運用システム」の意味になりますが、ここでは「オペレーション・システム」の意味に解釈しています。

例： OS プラットフォーム

platform は、使用中のオペレーティング・システムを表す文字列を返します。この値がコンパイル時に設定されます。取り得る値は linux、macos、ios、freebsd、dragonfly、netbsd、openbsd、solaris、android、windows です。

JavaScript
Rust

import { platform } from '@tauri-apps/plugin-os';
// `"withGlobalTauri": true` を使用する場合は、
// const { platform } = window.__TAURI__.os;　を使用できます

const currentPlatform = platform();
console.log(currentPlatform);
// コンソールに「windows」と表示します

let platform = tauri_plugin_os::platform();
println!("Platform: {}", platform);
// ターミナルに「windows」と表示します

アクセス権限 Permissions

デフォルトでは、潜在的に危険なプラグイン・コマンドとそのスコープ（有効範囲）はすべてブロックされており、アクセスできません。これらを有効にするには、capabilities 設定でアクセス権限を変更する必要があります。

詳細については「セキュリティ・レベル Capabilities」の章を参照してください。また、プラグインのアクセス権限を設定するには「プライグン・アクセス権の使用」の章のステップ・バイ・ステップ・ガイドを参照してください。

{
  "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.

【※ この日本語版は、「Feb 22, 2025 英語版」に基づいています】

Support on Open Collective Sponsor on GitHub