Mac 打包与公证
给出导出的 app 包或项目设置,检查包结构、签名与强化运行时,判断是否可分发并指出最关键的缺口和下一步验证命令。
功能与用途
Mac 应用本地跑得好好的,打包给别人用就被 Gatekeeper 拦下,报错信息通常又只说「已损坏」。这个技能专门处理分发环节而不是本地运行:先确认你的分发目标(只是本地归档验证、要签名分发、还是公证报错排查),再检查 app 包结构、嵌套框架与辅助工具、entitlements,然后检查强化运行时、签名身份与嵌套代码签名,最后把打包问题和信任策略问题分开解释,告诉你缺了哪个前置条件、接下来该跑哪条最小验证命令。
适用场景
- 导出 App 包结构与依赖完整性审查:检查导出包内部的嵌套框架、辅助可执行文件及资源结构,确保符合分发容器规范。
- 强化运行时与代码签名预检:核验 Hardened Runtime 开启状态、证书签名链以及权限声明文件,防止遗漏嵌套签名。
- 排查 Gatekeeper 拦截与公证失败:针对分发后提示损坏或公证拒绝的问题,区分权限缺失与信任策略故障,给出定位验证命令。
适用人群
- 要发布 macOS 桌面应用的独立开发者
- 负责客户端打包发布的构建工程师
- 被公证失败报错卡住的 Mac 应用维护者
使用步骤
- 先确认分发目标:只是本地归档验证、要出可签名分发的 app,还是排查公证失败。
- 让它检查产物本身:验证 app 包结构,检查嵌套框架、辅助工具和 entitlements。
- 再检查签名与运行时前置条件:强化运行时是否开启、签名身份、嵌套代码签名、必需 entitlements。
- 拿到判断:这个 app 看起来能不能直接分发,最关键的缺失前置条件或失败模式是什么。
- 按它给出的最小验证或修复命令继续排查,并注意它是否在缺产物的情况下仅凭项目设置推断。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Prepare macOS packaging and notarization workflows. Use when archiving apps, validating bundles, or explaining distribution-only failures.
使用前准备
- 需要能提供实际导出的 app 产物或相关项目设置
- 排查涉及 codesign、spctl、stapler 等 macOS 工具链,以及 Apple 开发者签名身份与公证凭据。
依赖与权限
- 读取用户主动提供的内容