Unity开发MacOS应用：AgoraRTC Wrapper签名方法及脚本咨询

一、手动签名步骤（最可靠的验证方式） #

如果修改Agora官方脚本失败，先尝试手动完成签名，确认流程可行后再调整脚本：

• 确认你的Mac开发者证书（Developer ID或Apple Development）在Keychain Access中状态正常，无过期或权限问题。
• 找到Unity打包后应用包内的AgoraRTC Wrapper文件，通常路径为：你的应用.app/Contents/Plugins/AgoraRTCWrapper.bundle（或对应.framework格式）。
• 执行签名命令（替换证书名称为你实际的证书全称，比如Developer ID Application: XXX (XXXXXX)）：

  codesign --force --deep --sign "你的开发者证书名称" "你的应用.app/Contents/Plugins/AgoraRTCWrapper.bundle"
  

• 验证签名有效性：

  codesign --verify --verbose=4 "你的应用.app/Contents/Plugins/AgoraRTCWrapper.bundle"
  

  输出包含valid on disk和satisfies its Designated Requirement即为签名成功。

二、适配AgoraTools脚本的修改方案 #

针对AgoraTools中的prep_codesign.sh和signcode.sh，需要调整脚本逻辑以覆盖AgoraRTC Wrapper：

修改prep_codesign.sh #

在脚本中添加对Wrapper库的预处理（移除旧签名）：

# 在原有处理逻辑后添加
APP_PATH="你的应用.app"
# 遍历Plugins目录下的Agora相关bundle/framework
find "$APP_PATH/Contents/Plugins" -name "AgoraRTCWrapper.bundle" -o -name "AgoraRTCWrapper.framework" | while read -r PLUGIN; do
    echo "Clearing old signature for $PLUGIN"
    codesign --remove-signature "$PLUGIN"
done

修改signcode.sh #

在签名主应用前，优先签名AgoraRTC Wrapper：

CERT_NAME="你的开发者证书名称"
APP_PATH="你的应用.app"
AGORA_WRAPPER_PATH="$APP_PATH/Contents/Plugins/AgoraRTCWrapper.bundle"

# 先签名Wrapper库
if [ -d "$AGORA_WRAPPER_PATH" ]; then
    codesign --force --deep --sign "$CERT_NAME" "$AGORA_WRAPPER_PATH"
    echo "Signed AgoraRTC Wrapper successfully"
fi

# 再签名主应用
codesign --force --deep --sign "$CERT_NAME" "$APP_PATH"

三、初始化失败的排查要点 #

如果签名后仍无法初始化Wrapper，按以下顺序排查：

• 用codesign -dvvv "你的应用.app/Contents/Plugins/AgoraRTCWrapper.bundle"查看签名详情，确认证书主体、权限与主应用一致。
• 检查应用Info.plist是否添加了麦克风、摄像头权限（若你的应用用到音视频功能），缺失权限可能导致AgoraRTC初始化失败，容易与签名问题混淆。
• 确认AgoraRTC Wrapper版本与Unity集成的SDK版本匹配，旧版本可能存在签名兼容性问题。
• 必须使用--deep参数签名，Agora内部依赖的子组件需要被递归签名，否则会出现加载失败。

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