非沙箱macOS App开机自启动配置问题求助

问题排查 #

1. 重复点击报错原因：旧版launchctl load命令无法重复加载已存在的Launch Agent配置，会触发Input/output error。现代macOS（10.11+）推荐使用launchctl bootstrap替代load/unload命令。
2. 开机不启动原因：
   • 未使用新版launchctl命令，导致系统未正确注册自启动配置
   • Bundle.main.executablePath在部分场景下返回路径不可靠，需改用更稳定的路径构造方式

修复后的完整代码 #

主视图代码 #

struct ContentView: View {
    var body: some View {
        VStack(spacing: 20) {
            Button("Set Up Auto-Start") {
                setAutoStart(identifier: "bulletproofsoftwareengineer")
            }
            .buttonStyle(.borderedProminent)
            
            Button("Remove Auto-Start") {
                removeAutoStart(identifier: "bulletproofsoftwareengineer")
            }
            .buttonStyle(.bordered)
        }
        .frame(width: 300, height: 300)
    }
}

自启动配置核心函数 #

func setAutoStart(identifier: String) {
    let bundle = Bundle.main
    let executableName = bundle.bundleURL.deletingPathExtension().lastPathComponent
    let agentLabel = "com.\(identifier).\(executableName)"
    let executablePath = bundle.bundleURL.appendingPathComponent(executableName).path
    let plistPath = FileManager.default.homeDirectoryForCurrentUser
        .appendingPathComponent("Library/LaunchAgents/\(agentLabel).plist")
    
    // 构造Launch Agent plist内容
    let plistContent = """
    <?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>\(agentLabel)</string>
        <key>Program</key>
        <string>\(executablePath)</string>
        <key>RunAtLoad</key>
        <true/>
        <key>KeepAlive</key>
        <false/>
    </dict>
    </plist>
    """
    
    do {
        // 写入plist文件
        try plistContent.write(to: plistPath, atomically: true, encoding: .utf8)
        
        // 使用新版launchctl bootstrap命令注册配置
        let process = Process()
        process.executableURL = URL(fileURLWithPath: "/bin/launchctl")
        process.arguments = ["bootstrap", "gui/\(NSUserName())", plistPath.path]
        try process.run()
        process.waitUntilExit()
        
        print("Auto-start configured successfully")
    } catch {
        print("Set auto-start error: \(error.localizedDescription)")
    }
}

func removeAutoStart(identifier: String) {
    let bundle = Bundle.main
    let executableName = bundle.bundleURL.deletingPathExtension().lastPathComponent
    let agentLabel = "com.\(identifier).\(executableName)"
    let plistPath = FileManager.default.homeDirectoryForCurrentUser
        .appendingPathComponent("Library/LaunchAgents/\(agentLabel).plist")
    
    do {
        // 移除launchctl中的配置
        let process = Process()
        process.executableURL = URL(fileURLWithPath: "/bin/launchctl")
        process.arguments = ["bootout", "gui/\(NSUserName())", agentLabel]
        try process.run()
        process.waitUntilExit()
        
        // 删除plist文件
        if FileManager.default.fileExists(atPath: plistPath.path) {
            try FileManager.default.removeItem(at: plistPath)
        }
        
        print("Auto-start removed successfully")
    } catch {
        print("Remove auto-start error: \(error.localizedDescription)")
    }
}

关键修改说明 #

• 命令适配：用launchctl bootstrap/bootout替代旧的load/unload，适配现代macOS系统规则
• 路径优化：直接通过Bundle的bundleURL构造可执行文件路径，避免executablePath的潜在异常
• 重复执行处理：设置自启动时自动覆盖已有配置，无需额外判断；删除时同时清理launchctl注册记录和本地plist文件
• 后台行为控制：新增KeepAlive键并设为false，避免App被系统强制后台驻留（可根据需求调整为true）

测试注意事项 #

1. 设置自启动后需重启系统验证效果
2. 可通过终端命令launchctl list | grep 你的agentLabel检查配置是否成功注册
3. 若配置失败，可手动查看~/Library/LaunchAgents/目录下是否生成了对应plist文件

内容的提问来源于stack exchange，提问作者swiftPunk