ElectronJS开发Mac App卸载时停止/移除Daemon问题求助

我之前开发Electron Mac应用时也碰到过完全一样的问题——用户拖应用到废纸篓后，后台daemon还在偷偷跑，下面是我验证过的几种可行方案，你可以根据daemon的类型（用户级/系统级）来选择：

1. 给应用加主动卸载入口（最可靠的方案） #

Mac默认的拖废纸篓卸载不会触发任何清理逻辑，所以最好在应用里加一个「彻底卸载」的功能按钮，引导用户通过这个入口完成清理：

• 在Electron主进程中监听按钮点击，执行以下步骤：
  • 停止并卸载daemon：根据daemon的位置执行launchctl unload

    # 用户级daemon（~/Library/LaunchAgents）
    launchctl unload ~/Library/LaunchAgents/com.your-app.daemon.plist
    # 系统级daemon（/Library/LaunchDaemons）需要sudo权限
    sudo launchctl unload /Library/LaunchDaemons/com.your-app.daemon.plist
    

  • 删除daemon配置文件和可执行文件：

    # 删除用户级plist
    rm ~/Library/LaunchAgents/com.your-app.daemon.plist
    # 删除daemon二进制文件（假设存在App Support目录）
    rm ~/Library/Application\ Support/YourApp/daemon-bin
    

  • 最后把应用移到废纸篓：用Electron的shell API实现

    const { app, shell } = require('electron');
    shell.moveItemToTrash(app.getPath('exe'));
    

  • 系统级daemon需要权限的话，可以用sudo-prompt这类npm包弹出系统权限请求窗口，不用让用户手动输命令。

2. 用pkg安装包的卸载脚本（适合pkg分发的应用） #

如果你是用pkg安装器分发应用，可以在pkg里嵌入卸载脚本，用户通过系统卸载流程（比如Launchpad删除或pkg卸载）时自动清理：

• 写一个shell脚本clean-daemon.sh：

  #!/bin/sh
  # 忽略不存在文件的错误，避免卸载时报错
  set +e
  
  # 清理用户级daemon
  launchctl unload ~/Library/LaunchAgents/com.your-app.daemon.plist
  rm -f ~/Library/LaunchAgents/com.your-app.daemon.plist
  
  # 清理系统级daemon（需要pkg有root权限）
  launchctl unload /Library/LaunchDaemons/com.your-app.daemon.plist
  rm -f /Library/LaunchDaemons/com.your-app.daemon.plist
  
  # 删除daemon相关文件
  rm -rf ~/Library/Application\ Support/YourApp/daemon*
  

• 用pkgbuild工具或者Packages可视化软件，把这个脚本设置为pkg的post-uninstall脚本，这样卸载时会自动执行。

3. 让daemon自我清理（兜底方案） #

针对那些直接拖废纸篓的用户，可以让daemon定期检查主应用是否存在，不存在就自我销毁：

• 在daemon的代码里加一个定时检查逻辑（伪代码，根据daemon开发语言调整）：

  // 每5分钟检查一次主应用是否存在
  ticker := time.NewTicker(5 * time.Minute)
  defer ticker.Stop()
  
  for range ticker.C {
      if _, err := os.Stat("/Applications/YourApp.app"); os.IsNotExist(err) {
          // 卸载自身的launchctl注册
          exec.Command("launchctl", "unload", "~/Library/LaunchAgents/com.your-app.daemon.plist").Run()
          // 删除配置文件和自身
          os.Remove("~/Library/LaunchAgents/com.your-app.daemon.plist")
          os.Remove(os.Args[0])
          os.Exit(0)
      }
  }
  

• 注意：系统级daemon需要root权限才能自我删除，所以如果是系统级的，这个方案可能需要配合其他逻辑，或者优先引导用户用应用内的卸载入口。

关键注意事项 #

• 权限：系统级daemon的清理必须要有root权限，要么用pkg的卸载脚本，要么在应用内请求sudo权限。
• 唯一性：daemon的plist文件名一定要用反向域名格式（比如com.yourcompany.yourapp.daemon），避免和其他应用冲突。
• 测试：一定要在不同macOS版本上测试卸载流程，确保daemon进程被彻底终止，没有残留。

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