Persisted Scope（永続スコープ）

《訳注》

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

GitHubcrates.io

API Reference:

ファイルシステムとアセット^※のスコープ（有効範囲）を保存し、アプリが再開されたときにその状態を復元します。

《訳注》

・アセット　（asset）：　デジタル化された「資産（アセット）」で、アプリが利用するローカル内のメディア・ファイルやリソース（画像・動画・音声・文書など）を指します。

対応プラットフォーム

This plugin requires a Rust version of at least 1.90

Platform	Level	Notes
windows
linux
macos
android
ios

セットアップ

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

自動で設定

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

npm

npm run tauri add persisted-scope

yarn

yarn run tauri add persisted-scope

pnpm

pnpm tauri add persisted-scope

deno

deno task tauri add persisted-scope

bun

bun tauri add persisted-scope

cargo

cargo tauri add persisted-scope

手動で設定

1. src-tauri フォルダで次のコマンドを実行して、このプラグインを Cargo.toml 内のプロジェクトの依存関係に追加します：

   cargo add tauri-plugin-persisted-scope

2. 追加したプラグインを初期化するために lib.rs を修正します：

   src-tauri/src/lib.rs

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

注意

persisted-scope プラグインは、以下の例に示すように、「fs プラグイン」の後に 登録および初期化されていなければなりません。

#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_fs::init()) // fs は persisted scope の前に記載!
        .plugin(tauri_plugin_persisted_scope::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

fs を先にしないと、persisted scope が機能しません！　また、開発者モードでアプリを起動すると、次のような警告メッセージ^※が表示されます：

Please make sure to register the `fs` plugin before the `persisted-scope` plugin!

Note

〈警告メッセージの内容〉　必ず persisted-scope プラグインの前に fs プラグインを登録してください。

使用法

セットアップ後、このプラグインは自動的にファイルシステムとアセット・スコープを保存および復元します。

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