Skip to content

docs: macOS unsigned build open instructions #3

Description

@BigStrongSun

背景

当前 CCSwitchMulti 的 macOS Apple Silicon release 包暂未进行 Apple Developer ID 签名和 notarization。因此用户从浏览器下载 .dmg.app.zip 后,macOS 可能提示:

  • “CCSwitchMulti 已损坏,无法打开”
  • “无法验证开发者”
  • “Apple 无法检查此 App 是否包含恶意软件”

这通常不是文件真的损坏,而是下载文件带有 com.apple.quarantine 隔离标记,Gatekeeper 因为 App 未签名/未公证而阻止启动。

推荐给用户的打开方法

  1. 从 Releases 下载 CCSwitchMulti_<version>_aarch64.dmgCCSwitchMulti_<version>_aarch64.app.zip
  2. 打开 DMG 或解压 zip。
  3. CCSwitchMulti.app 拖到“应用程序”文件夹。
  4. 打开“终端”,运行:
xattr -dr com.apple.quarantine /Applications/CCSwitchMulti.app
open /Applications/CCSwitchMulti.app

这只会移除 CCSwitchMulti.app 的下载隔离标记,不会关闭系统 Gatekeeper,也不会修改全局安全策略。

Apple 官方图形界面替代路径

如果用户不想运行命令,可以:

  1. 先尝试打开一次 CCSwitchMulti.app
  2. 打开“系统设置” -> “隐私与安全性”。
  3. 在安全性区域选择“仍要打开 / Open Anyway”。
  4. 再次确认打开。

该方式会把此 App 保存为当前 Mac 的安全例外,之后可以正常双击打开。

后续改进

长期最佳解仍然是恢复 Apple Developer ID 签名和 notarization。当前说明只是为了让用户在未签名包阶段可以明确、安全地手动运行,不建议指导用户全局关闭 Gatekeeper。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions