macOS 安装

在 macOS 13 Ventura 及更高版本安装 Picorca。

系统与设备要求

Picorca 理论上支持 macOS 13 Ventura 及更高版本，包括搭载 Apple 芯片和 Intel 处理器的 64 位 Mac。macOS 12 及更早版本暂不在支持范围内。

可运行 macOS 13 的 Mac 机型包括：

在菜单栏选择  > 关于本机，即可查看 Mac 型号与芯片类型；也可以在“终端”中执行以下命令：

sw_vers -productVersion
uname -m

第一条命令会显示系统版本；第二条命令输出 arm64 时请选择 Apple 芯片版，输出 x86_64 时请选择 Intel 版。

请根据芯片类型下载对应的 DMG 安装包。安装包由 Picorca GitHub Releases 发布。

芯片类型	适用设备	安装包
Apple 芯片（Apple Silicon）	M1、M2、M3、M4 及后续芯片	下载 `picorca_0.9.6_aarch64.dmg`
Intel	搭载 Intel 处理器的 Mac	下载 `picorca_0.9.6_x64.dmg`

在终端执行下面的命令，计算下载文件的 SHA-256 值。默认浏览器下载到“下载”文件夹；如果文件在其他位置，请将命令中的路径替换为实际路径。

# Apple 芯片版
shasum -a 256 ~/Downloads/picorca_0.9.6_aarch64.dmg

# Intel 版
shasum -a 256 ~/Downloads/picorca_0.9.6_x64.dmg

输出应分别与下列值完全一致：

安装包	SHA-256
`picorca_0.9.6_aarch64.dmg`	`ae2a4bac6e166ada44a15147bf21207fe76b2020dacfa65fd9144cefb337b7b6`
`picorca_0.9.6_x64.dmg`	`638bfe4459e1897b9fcae6b1de23ddf72c9d2b39ca75aab523e6d8c8fba407b5`

若校验值不一致，请删除该 DMG 并从上方官方链接重新下载，不要继续安装。

双击下载完成的 .dmg 文件，等待安装镜像打开。
将 picorca.app 拖入“应用程序”（/Applications）文件夹。若系统要求验证管理员身份，请按提示完成。
拖拽完成后，在 Finder 边栏弹出 Picorca 安装镜像。请从“应用程序”文件夹运行 Picorca，不要直接从 DMG 中运行。
打开“终端”，执行下面的命令移除 Picorca 的隔离标记：
```
sudo xattr -dr com.apple.quarantine /Applications/picorca.app
```
输入当前 Mac 管理员密码后按回车。输入密码时终端不会显示字符，这是 macOS 的正常行为。
启动应用：
```
open /Applications/picorca.app
```

当前 Picorca 尚未完成 Apple 开发者签名与公证。因此，首次启动时 macOS 可能显示“无法验证开发者”“已损坏”或阻止打开的提示。确认 DMG 来自上方 GitHub 官方下载地址、并且应用已拖入 /Applications 后，执行上述 xattr 命令即可。

该命令仅移除 picorca.app 的下载隔离属性，不会授予 Picorca 额外的系统权限，也不会关闭 macOS 的全局安全保护。请勿使用 sudo spctl --master-disable 等关闭 Gatekeeper 的命令。

请确认系统为 macOS 13 或更高版本，并重新检查下载的架构：Apple 芯片选择 aarch64，Intel 选择 x64。

确认应用位于 /Applications/picorca.app，而不是仍在 DMG 安装镜像中；然后重新执行命令。若问题仍然存在，请删除当前下载的 DMG，从 GitHub Releases 重新下载对应架构的安装包后再安装。

退出 Picorca 后，下载新版 DMG，并将新版 picorca.app 拖入“应用程序”文件夹覆盖旧版本。由于当前版本未签名，安装新版后需要再次执行：

sudo xattr -dr com.apple.quarantine /Applications/picorca.app