How do I install the Macos Notarization skill?

Run npx skillmds@latest add iml1s/macos-notarization in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Macos Notarization skill do?

macOS 應用公證指南。當用戶需要打包 macOS 應用、進行公證（notarization）、或建立 DMG 時使用此 skill。包含 API 金鑰資訊和完整的公證流程。 It is listed under Integrations & APIs on SkillMD.

Is Macos Notarization safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Macos Notarization?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Macos Notarization free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Macos Notarization?

ImL1s (@iml1s) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Macos Notarization by iml1s — Agent Skill

Name: Macos Notarization
Author: ImL1s

File contents

macOS 應用公證指南

公證憑證資訊

Your Project

項目	值
帳號名稱	`<Your Apple Developer Account Name>`
Issuer ID	`<your-issuer-uuid-from-appstoreconnect>`
Key ID	`<YOUR_KEY_ID>`
私鑰位置	`~/.appstoreconnect/private_keys/AuthKey_<KEY_ID>.p8`
鑰匙圈憑證名稱	`<YOUR_PROFILE_NAME>`
Team ID	`<YOUR_TEAM_ID>`
Bundle ID	`com.example.yourapp`

在 App Store Connect → Users and Access → Keys 創建 ASC API key 拿到 Issuer/Key ID 和下載 .p8 私鑰。

完整公證流程

1. 打包 Release 版本

cd /path/to/your/macos/app

# 清理並打包
fvm flutter clean && fvm flutter pub get
fvm flutter build macos --release --dart-define=environment=103

輸出位置：build/macos/Build/Products/Release/<YourApp>.app

2. 建立 DMG

方法一：使用 flutter_distributor

fvm dart pub global run flutter_distributor:flutter_distributor release \
  --name prod --jobs macos-dmg-release

方法二：手動建立

create-dmg --volname "<YourApp>" \
  --icon-size 140 \
  --icon "<YourApp>.app" 162 269 \
  --app-drop-link 640 269 \
  "<YourApp>.dmg" \
  "build/macos/Build/Products/Release/<YourApp>.app"

3. 提交公證

xcrun notarytool submit <YourApp>.dmg \
  --keychain-profile "YOUR_PROFILE_NAME" \
  --wait

4. 裝訂票據 (Staple)

xcrun stapler staple <YourApp>.dmg

5. 驗證

xcrun stapler validate <YourApp>.dmg
spctl -a -t open --context context:primary-signature -v <YourApp>.dmg

常用指令

查看公證歷史

xcrun notarytool history --keychain-profile "YOUR_PROFILE_NAME"

查看公證詳情（如果失敗）

xcrun notarytool log <submission-id> --keychain-profile "YOUR_PROFILE_NAME"

重新儲存憑證（如果遺失）

xcrun notarytool store-credentials "YOUR_PROFILE_NAME" \
  --key ~/.appstoreconnect/private_keys/AuthKey_<YOUR_KEY_ID>.p8 \
  --key-id "<YOUR_KEY_ID>" \
  --issuer "<YOUR_ISSUER_UUID>"

注意事項

.p8 私鑰只能下載一次，請妥善保管 ~/.appstoreconnect/private_keys/ 目錄
Hardened Runtime 必須啟用（專案已配置）
簽名身份必須是 Developer ID Application
DMG 和 .app 都可以單獨公證，但通常公證 DMG 即可

Related skills

release-preflight → release-app — use macos-notarization as part of the macOS-specific release workflow. Handle notarization after preflight and before release-app submits.
apple-appstore-manager — manage App Store metadata after notarization completes.

---name: macos-notarizationdescription: macOS 應用公證指南。當用戶需要打包 macOS 應用、進行公證（notarization）、或建立 DMG 時使用此 skill。包含 API 金鑰資訊和完整的公證流程。---# macOS 應用公證指南## 公證憑證資訊### Your Project| 項目 | 值 ||------|-----|| **帳號名稱** | `<Your Apple Developer Account Name>` || **Issuer ID** | `<your-issuer-uuid-from-appstoreconnect>` || **Key ID** | `<YOUR_KEY_ID>` || **私鑰位置** | `~/.appstoreconnect/private_keys/AuthKey_<KEY_ID>.p8` || **鑰匙圈憑證名稱** | `<YOUR_PROFILE_NAME>` || **Team ID** | `<YOUR_TEAM_ID>` || **Bundle ID** | `com.example.yourapp` |> 在 App Store Connect → Users and Access → Keys 創建 ASC API key 拿到 Issuer/Key ID 和下載 `.p8` 私鑰。---## 完整公證流程### 1. 打包 Release 版本```bashcd /path/to/your/macos/app# 清理並打包fvm flutter clean && fvm flutter pub getfvm flutter build macos --release --dart-define=environment=103```輸出位置：`build/macos/Build/Products/Release/<YourApp>.app`### 2. 建立 DMG**方法一：使用 flutter_distributor**```bashfvm dart pub global run flutter_distributor:flutter_distributor release \ --name prod --jobs macos-dmg-release```**方法二：手動建立**```bashcreate-dmg --volname "<YourApp>" \ --icon-size 140 \ --icon "<YourApp>.app" 162 269 \ --app-drop-link 640 269 \ "<YourApp>.dmg" \ "build/macos/Build/Products/Release/<YourApp>.app"```### 3. 提交公證```bashxcrun notarytool submit <YourApp>.dmg \ --keychain-profile "YOUR_PROFILE_NAME" \ --wait```### 4. 裝訂票據 (Staple)```bashxcrun stapler staple <YourApp>.dmg```### 5. 驗證```bashxcrun stapler validate <YourApp>.dmgspctl -a -t open --context context:primary-signature -v <YourApp>.dmg```---## 常用指令### 查看公證歷史```bashxcrun notarytool history --keychain-profile "YOUR_PROFILE_NAME"```### 查看公證詳情（如果失敗）```bashxcrun notarytool log <submission-id> --keychain-profile "YOUR_PROFILE_NAME"```### 重新儲存憑證（如果遺失）```bashxcrun notarytool store-credentials "YOUR_PROFILE_NAME" \ --key ~/.appstoreconnect/private_keys/AuthKey_<YOUR_KEY_ID>.p8 \ --key-id "<YOUR_KEY_ID>" \ --issuer "<YOUR_ISSUER_UUID>"```---## 注意事項1. **.p8 私鑰只能下載一次**，請妥善保管 `~/.appstoreconnect/private_keys/` 目錄2. **Hardened Runtime** 必須啟用（專案已配置）3. **簽名身份**必須是 `Developer ID Application`4. DMG 和 .app 都可以單獨公證，但通常公證 DMG 即可## Related skills- **`release-preflight`** → **`release-app`** — use macos-notarization as part of the macOS-specific release workflow. Handle notarization after preflight and before release-app submits.- **`apple-appstore-manager`** — manage App Store metadata after notarization completes.

Frequently asked questions