macOS应用启动前执行自定义脚本指南

一、macOS 应用启动原理

macOS 的 .app 本质上是一个特定结构的文件夹（Bundle）：

/Applications/AppName.app
└── Contents
    ├── Info.plist              <-- 定义 CFBundleExecutable（启动入口名）
    ├── MacOS
    │   └── AppName             <-- 真正的可执行入口文件
    └── Resources

当你在访达 (Finder)、启动台 (Launchpad)、程序坞 (Dock) 点击图标，或在终端执行 open -a AppName 时，系统底层的 LaunchServices 服务都会读取 Contents/Info.plist，并执行 Contents/MacOS/ 下的对应可执行文件。

核心思路：将原二进制文件重命名（例如 AppName_real），用一个同名的 Shell 脚本替换原可执行文件。在 Shell 脚本中先执行自定义逻辑，最后通过 exec 拉起真正的原程序。

---

二、前置准备：解决「Operation not permitted」权限拦截

在对 /Applications 内的应用进行修改时，即使使用 sudo，也经常会遭遇 Operation not permitted 报错。这是因为 macOS 的 TCC（透明度、同意与控制）隐私安全机制 优先级高于 root/sudo。

授权完全磁盘访问权限（必须）：

1. 打开 “系统设置” (System Settings)。
2. 进入 “隐私与安全性” (Privacy & Security) -> “完全磁盘访问权限” (Full Disk Access)。
3. 找到并勾选你所使用的终端（如 终端 (Terminal)、iTerm2 或 VS Code 等）。
4. ⚠️ 关键步骤：按 Command + Q 彻底退出终端并重新打开，权限方可生效。

---

三、核心方案：App 入口无感包装法（推荐）

以 Navicat Premium 为例，其他应用只需替换对应的 App 路径和文件名。

步骤 1：重命名原二进制文件

进入应用的二进制目录，将原可执行文件重命名备份：

cd "/Applications/Navicat Premium.app/Contents/MacOS"

# 解除可能存在的文件锁定
sudo chflags -R noschg,nouchg,nodump "/Applications/Navicat Premium.app"

# 将原主程序重命名为 Navicat Premium_real
sudo mv "Navicat Premium" "Navicat Premium_real"

---

步骤 2：创建同名 Shell 包装脚本

创建一个与原二进制同名的脚本文件 Navicat Premium：

cat << 'EOF' | sudo tee "/Applications/Navicat Premium.app/Contents/MacOS/Navicat Premium" > /dev/null
#!/bin/bash

# ==========================================
# 1. 在这里写入你的自定义前置脚本逻辑
# ==========================================
# 示例：记录启动日志、清空临时目录、执行其他脚本等
echo "Navicat pre-launch hook executed at $(date)" >> /tmp/navicat_launch.log

# 如果有外部脚本，也可以在此调用，例如：
# bash /Users/guojc/scripts/my_pre_launch.sh


# ==========================================
# 2. 启动真正的 Navicat 二进制文件
# ==========================================
DIR="$(cd "$(dirname "$0")" && pwd)"
exec "$DIR/Navicat Premium_real" "$@"
EOF

---

步骤 3：赋予脚本可执行权限

sudo chmod +x "/Applications/Navicat Premium.app/Contents/MacOS/Navicat Premium"

---

步骤 4：修复 Gatekeeper 隔离与代码签名

因为修改了 .app 包体内容，会破坏原有的开发者签名，可能导致 macOS 提示“应用已损坏”或拒绝启动。需清除扩展属性并重新进行本地 Ad-hoc 签名：

# 1. 移除 macOS Quarantine 隔离属性
sudo xattr -c -r "/Applications/Navicat Premium.app"

# 2. 对 App 重新进行本地签名
sudo codesign --force --deep --sign - "/Applications/Navicat Premium.app"

完成上述步骤后，无论通过 Launchpad、Dock 还是命令行启动应用，都会自动先行触发自定义脚本。

---

四、备选方案：Automator 独立启动器

如果不希望改动 .app 内部结构，可以使用 macOS 自带的“自动操作 (Automator)”：

1. 打开 “自动操作” (Automator) -> 新建文稿 -> 选择 “应用程序”。
2. 左侧搜索并添加 “运行 Shell 脚本”。
3. 填入脚本逻辑：

   # 1. 自定义前置逻辑
   echo "Pre-launch..."
   
   # 2. 打开原 App
   open -a "Navicat Premium"
   

4. 导出保存为 启动Navicat.app，放置在 /Applications 或程序坞中启动。

---

五、常见问题与排错（FAQ）

Q1: chmod 或 xattr 提示 [Errno 1] Operation not permitted？

• 原因：当前终端应用未获得 macOS 的“完全磁盘访问权限”。
• 解决：在“系统设置 -> 隐私与安全性 -> 完全磁盘访问权限”中添加终端并勾选，退出终端 (Cmd+Q) 后重新打开。

Q2: 启动时提示“应用程序已损坏，无法打开”？

• 原因：修改包内文件后签名校验失败。
• 解决：执行以下修复命令：

  sudo xattr -r -d com.apple.quarantine "/Applications/Navicat Premium.app"
  sudo codesign --force --deep --sign - "/Applications/Navicat Premium.app"
  

Q3: 软件更新后脚本失效了？

• 原因：应用通过覆盖安装或自动更新时，会重新拉取完整的 .app 包，导致包装脚本被覆盖。
• 解决：软件升级后重新执行一次上述 步骤 1 ~ 4 即可。