2 Autostart

  2 分钟阅读  

原文链接: https://tauri.app/plugin/autostart/

在系统启动时自动运行你的应用。

支持的平台

平台支持程度说明
Windows完整支持
Linux完整支持
macOS完整支持
Android不支持
iOS不支持

设置

自动

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

1

npm run tauri add autostart

1

yarn run tauri add autostart

1

pnpm tauri add autostart

1

deno task tauri add autostart

1

bun tauri add autostart

1

cargo tauri add autostart

手动

  1. 在 src-tauri 文件夹中运行以下命令，把插件加入 Cargo.toml 里的项目依赖：

    1

    cargo add tauri-plugin-autostart

  2. 修改 lib.rs 初始化插件：

    1
2
3
4
5
6
7

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

  3. 用你偏好的 JavaScript 包管理器安装 JavaScript 端绑定：

1

npm install @tauri-apps/plugin-autostart

1

yarn add @tauri-apps/plugin-autostart

1

pnpm add @tauri-apps/plugin-autostart

1

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

1

bun add @tauri-apps/plugin-autostart

用法

autostart 插件在 JavaScript 和 Rust 中都可以使用。

语言

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

import { enable, isEnabled, disable } from '@tauri-apps/plugin-autostart';
// 使用 `"withGlobalTauri": true` 时，你可以这样写
// const { enable, isEnabled, disable } = window.__TAURI__.autostart;

// 启用自启动
await enable();
// 检查启用状态
console.log(`registered for autostart? ${await isEnabled()}`);
// 禁用自启动
disable();

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

pub fn run() {
    tauri::Builder::default()
        .setup(|app| {
            #[cfg(desktop)]
            {
                use tauri_plugin_autostart::MacosLauncher;
                use tauri_plugin_autostart::ManagerExt;

                app.handle().plugin(tauri_plugin_autostart::init(
                    MacosLauncher::LaunchAgent,
                    Some(vec!["--flag1", "--flag2"]),
                ));

                // 获取自启动管理器
                let autostart_manager = app.autolaunch();
                // 启用自启动
                let _ = autostart_manager.enable();
                // 检查启用状态
                println!("registered for autostart? {}", autostart_manager.is_enabled().unwrap());
                // 禁用自启动
                let _ = autostart_manager.disable();
            }
            Ok(())
        })
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

权限

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

更多信息请参阅能力概述，以及使用插件权限的分步指南。

1
2
3
4
5
6
7
8

{
  "permissions": [
    ...,
    "autostart:allow-enable",
    "autostart:allow-disable",
    "autostart:allow-is-enabled"
  ]
}
最后修改 September 26, 2026: 更新 (630b11f59)