如何让Compose Multiplatform应用的无障碍权限在重装/更新后持久？

问题背景 #

开发Compose Multiplatform应用，通过Compose Gradle插件打包为.app放入/Applications，使用JNativeHook注册全局键盘监听器需要Mac无障碍权限。首次安装权限流程正常，但重装/重建应用时，系统设置面板显示权限已开启，实际应用无权限，开关操作无效，需手动删除权限条目才能重新授权。

问题1：如何避免每次重装都需删除权限条目？ #

核心原因是macOS无障碍权限与应用的Bundle ID和签名身份强绑定，若重装时这两个信息变化，系统会将新应用判定为独立实体，导致旧权限条目失效但残留显示。解决思路如下：

• 固定签名与Bundle ID
  开发阶段确保每次构建使用相同的签名身份和Bundle ID：
  在Compose Multiplatform的Gradle配置中，为macOS目标设置固定签名参数，示例：

  kotlin {
      macosX64 {
          binaries {
              executable {
                  signing {
                      identity = "Developer ID Application: Your Name (XXXXXXXXXX)"
                      signUnsigned = true
                  }
              }
          }
          bundleID = "com.yourcompany.yourapp" // 固定不变的Bundle ID
      }
  }
  

  本地开发可使用自签名证书，确保每次构建签名一致，系统会识别为同一应用，权限自动保留。

• 避免直接替换整个.app Bundle
  开发阶段不要删除旧.app后再复制新包，改用增量同步工具（如rsync）只替换变化的文件：

  rsync -av --delete ./build/bin/macosX64/releaseExecutable/YourApp.app/ /Applications/YourApp.app/
  

  这种方式不会触发系统对应用实体的重新识别，权限状态不受影响。

• 开发阶段自动化重置权限
  若必须重装，可编写Shell脚本自动清理无效权限条目（仅适合开发环境，发布版本不可用）：

  # 针对macOS Ventura及以上版本，TCC数据库路径
  sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db "DELETE FROM access WHERE client='com.yourcompany.yourapp' AND service='kTCCServiceAccessibility';"
  

  执行脚本后重启应用，即可重新触发权限请求流程。

问题2：如何让应用更新时无障碍权限持久生效？替换整个.app bundle是否为不正确的更新方式？ #

1. 替换整个.app bundle属于非正规更新方式
   直接替换.app会被系统判定为新应用（即使Bundle ID相同，若文件校验或签名有变化），导致权限失效。正规更新应遵循macOS的应用更新机制：

   • 开发阶段：使用增量同步（如上述rsync方式）更新应用文件，而非替换整个bundle。
   • 发布阶段：使用成熟的更新框架（如Sparkle），这类框架会通过系统认可的方式更新应用，确保权限状态被系统正确继承。

2. 确保更新包与原应用的一致性
   无论采用哪种更新方式，必须保证：

   • 更新包的Bundle ID与原应用完全一致；
   • 更新包使用相同的签名身份签名（开发阶段用同一自签名证书，发布阶段用同一开发者ID证书）。
     满足这两个条件，系统会识别为同一应用的版本更新，无障碍权限会自动保留。

3. 权限有效性检测与引导
   在应用启动时添加权限有效性检测逻辑：

   • 通过JNativeHook的API（或调用macOS系统API）判断全局监听器是否正常工作；
   • 若检测到权限异常（如开关显示开启但监听器无效），向用户清晰说明问题，并引导用户通过「系统设置→隐私与安全性→无障碍」删除旧条目后重新授权，优化用户体验。

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