Electron 客户端开机自启动

app.setLoginItemSettings 与 auto-launch 对比分析

一、稳定性对比

1. app.setLoginItemSettings

• 优点：作为Electron官方API，有官方维护和支持
• 缺点：
  • 在某些Windows版本上存在已知问题
  • 部分Windows 10/11更新后可能失效
  • 在macOS权限更严格的版本上可能需要额外授权
  • 不支持Linux

2. auto-launch

• 优点：
  • 针对各平台做了特殊适配（Windows用注册表，macOS用Launch Services，Linux用.desktop文件）
  • 对系统权限问题有更好的处理和反馈
  • 经过多年实践验证，在各种系统环境下更稳定
• 缺点：
  • 依赖第三方库，理论上有维护风险（但该库活跃度良好）

二、易用性对比

1. app.setLoginItemSettings

// 设置自启动
app.setLoginItemSettings({openAtLogin: true,openAsHidden: false
})// 检查状态 - 没有Promise支持
const status = app.getLoginItemSettings()
console.log('是否自启动:', status.openAtLogin)

2. auto-launch

// 创建实例
const autoLauncher = new AutoLaunch({name: app.getName(),path: app.getPath('exe')
})// 检查状态 - 支持Promise
const isEnabled = await autoLauncher.isEnabled()// 启用/禁用 - 链式调用友好
autoLauncher.isEnabled().then(isEnabled => {if (!isEnabled) return autoLauncher.enable()}).then(() => console.log('自启动已启用')).catch(err => console.error('操作失败', err))

三、功能对比

功能	app.setLoginItemSettings	auto-launch
Windows支持	✅	✅
macOS支持	✅	✅
Linux支持	❌	✅
Promise支持	❌	✅
错误处理	有限	完善
状态检查	简单	完善
隐藏启动	✅ (macOS 已弃用)	✅
维护状态	官方维护	社区活跃

四、实际使用

1. auto-launch.ts 文件

pnpm install auto-launch

import AutoLaunch from 'auto-launch'
import { app } from 'electron'
import log from 'electron-log/main'/*** 设置应用开机自启动* @param enable 是否启用自启动，默认为true*/
export function setupAutoLaunch(enable: boolean = true): void {const autoLauncher = new AutoLaunch({name: app.getName(),path: process.execPath,})if (enable) {autoLauncher.isEnabled().then((isEnabled) => {if (!isEnabled) {autoLauncher.enable().then(() => log.info('已启用自启动')).catch(err => log.error('启用自启动失败:', err))}else {log.info('自启动已经启用')}}).catch(err => log.error('检查自启动状态失败:', err))}else {autoLauncher.isEnabled().then((isEnabled) => {if (isEnabled) {autoLauncher.disable().then(() => log.info('已禁用自启动')).catch(err => log.error('禁用自启动失败:', err))}else {log.info('自启动已经禁用')}}).catch(err => log.error('检查自启动状态失败:', err))}
}

2. 在 main/index.ts 文件中使用

import { setupAutoLaunch } from './utils/auto-launch'async function electronAppInit() {log.info('主进程已启动')// 设置应用自启动setupAutoLaunch(true)app.on('window-all-closed', () => {if (process.platform !== PLATFORM.DARWIN) {log.info('主进程已关闭')app.quit()}})
}

3. 体验

实际开发中，auto-launch 提供了更一致的开发体验：

1. 错误处理更清晰：当遇到权限问题时，auto-launch 提供明确的错误信息，而 app.setLoginItemSettings 可能静默失败
2. Windows兼容性更好：Windows系统更新频繁，auto-launch 通过直接操作注册表提供了更稳定的行为
3. 跨平台一致性：如果你的应用需要支持Linux，只能选择 auto-launch
4. 代码组织更清晰：Promise支持让异步操作处理更优雅

五、结论

综合稳定性和易用性考虑，推荐使用 auto-launch，特别是：

1. 如果你的应用需要支持Linux
2. 如果你重视更好的错误处理和用户反馈
3. 如果你的应用在Windows平台有较多用户（Windows更新可能影响原生API）

app.setLoginItemSettings 更适合简单场景，或者你特别关注减少依赖项的情况。但整体而言，auto-launch 提供了更可靠和一致的开发体验。