告别手动启动！3种方法让Amethyst随macOS自动运行
项目地址: https://gitcode.com/gh_mirrors/am/Amethyst 你是否每天开机后都要手动启动Amethyst窗口管理器？频繁重复的操作不仅浪费时间，还会打断工作流。本文将详解三种登录自动启动方案，从图形界面到高级配置全面覆盖，帮你实现"开机即享"的窗口管理体验。
方法一：应用内配置（推荐）
Amethyst内置了登录启动开关，通过菜单栏即可快速配置。这是最简便且官方推荐的方法，适合大多数用户。
实现原理：应用通过LoginServiceKit框架与macOS登录项系统交互，源码中通过LoginServiceKit.isExistLoginItems(at:)检查当前状态，并使用addLoginItems和removeLoginItems方法修改启动配置。
操作步骤：
- 点击菜单栏中的Amethyst图标（紫色菱形图标）
- 在下拉菜单中找到"Start at Login"选项
- 确保选项前有勾选标记（状态通过Amethyst/AppDelegate.swift控制）
状态切换代码逻辑：
@IBAction func toggleStartAtLogin(_ sender: AnyObject) {
if startAtLoginMenuItem?.state == .off {
LoginServiceKit.addLoginItems(at: Bundle.main.bundlePath)
} else {
LoginServiceKit.removeLoginItems(at: Bundle.main.bundlePath)
}
startAtLoginMenuItem?.state = (LoginServiceKit.isExistLoginItems(at: Bundle.main.bundlePath) ? .on : .off)
}
方法二：系统偏好设置配置
如果应用内开关不可用或你需要更精细的系统级控制，可以通过macOS系统偏好设置手动添加Amethyst到登录项。
操作步骤：
- 打开"系统偏好设置" > "用户与群组"
- 选择当前用户，点击"登录项"标签
- 点击左下角"+"按钮，导航至
/Applications/Amethyst.app - 确保添加后的应用名称前勾选框处于选中状态
这种方法直接与macOS的LaunchServices交互，适用于需要管理多个用户登录项的场景。系统会在用户登录完成后启动添加的应用程序，启动顺序由列表中的位置决定。
方法三：高级用户的launchd配置
对于需要自定义启动参数、延迟启动或条件启动的高级用户，可以创建launchd配置文件实现更灵活的自动启动方案。
配置文件路径：~/Library/LaunchAgents/com.amethyst.Amethyst.plist
基础配置示例：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.amethyst.Amethyst</string>
<key>ProgramArguments</key>
<array>
<string>/Applications/Amethyst.app/Contents/MacOS/Amethyst</string>
<!-- 可添加自定义启动参数 -->
<!-- <string>--log</string> -->
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<false/>
<key>LaunchOnlyOnce</key>
<true/>
</dict>
</plist>
加载配置命令：
launchctl load ~/Library/LaunchAgents/com.amethyst.Amethyst.plist
这种方法适合需要：
- 自定义启动参数（如启用调试日志）
- 设置启动延迟避免与系统资源竞争
- 配置崩溃自动重启（设置
KeepAlive为true） - 基于特定条件的启动规则
常见问题解决
启动项设置不生效
如果尝试上述方法后Amethyst仍未自动启动，请按以下步骤排查：
-
权限检查：确保Amethyst具有辅助功能权限，路径："系统偏好设置" > "安全性与隐私" > "隐私" > "辅助功能"，检查Amethyst是否在列表中且已勾选。
-
配置冲突：如果同时使用了多种启动方法（如应用内开关和launchd配置）可能导致冲突，建议只保留一种启动方式。
-
系统完整性保护：对于开启SIP的系统，某些路径可能受到限制，建议使用标准应用目录
/Applications/存放Amethyst。 -
日志排查：通过Amethyst/Debug/DebugInfo.swift收集系统信息，或在终端中运行
/Applications/Amethyst.app/Contents/MacOS/Amethyst --log查看启动日志。
应用隐藏 Dock 图标
Amethyst默认在启动时会显示Dock图标，如果需要完全后台运行（仅显示菜单栏图标），可以修改应用配置：
- 显示包内容：右键Amethyst.app > "显示包内容"
- 编辑
Contents/Info.plist - 添加或修改
LSUIElement键为true - 保存文件并重启应用
注意：此修改会使应用不在Dock和Cmd+Tab切换器中显示，只能通过菜单栏图标访问。
总结与最佳实践
三种方法各有适用场景，推荐优先级：
- 应用内开关：最简单，适合普通用户
- 系统偏好设置：系统级控制，适合多用户环境
- launchd配置：高级自定义，适合开发人员和系统管理员
官方文档：配置指南
无论选择哪种方法，配置完成后建议注销并重新登录测试自动启动功能是否正常工作。对于企业环境或多用户部署，可以结合Amethyst/Managers/AppManager.swift中的relaunch()方法实现远程管理。
希望本文能帮助你彻底解决Amethyst的自动启动问题，享受无缝的窗口管理体验！如有其他问题，欢迎通过项目README.md中的反馈渠道提交issue。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
