📦
SwiftPM製macOSアプリをDeveloper ID署名・Apple公証してHomebrew Tapへ自動公開する
· 약 15분
macOS 向けのネイティブアプリケーションを App Store を経由せず GitHub Releases や Homebrew で配布する場合、適切なコード署名と Apple による公証(Notarization)を行わなければ、利用者の環境で Gatekeeper による警告(「開発元を検証できないため開けません」など)が表示されてしまいます。
また、手元の Mac で毎回アーカイブの作成、署名、notarytool による公証申請、Staple(公証チケットの埋め込み)、そして Homebrew Tap リポジトリの更新を手作業で繰り返すと、作業の負担が大きいだけでなく手順漏れなどのヒューマンエラーも起きやすくなります。
今回 Wintch という Swift Package Manager(SwiftPM)製の macOS アプリを作成し、その中で Developer ID 署名・Apple 公証・Staple 付きのビルドから GitHub Releases 公開、自作の Homebrew Tap(sawarame/homebrew-tap)更新までを GitHub Actions で自動化する仕組みを実践しましたので、その手順を紹介します。
🪟
Wintch — macOS 向けウィンドウ単位スイッチャー&検索ランチャー
今回自動リリース環境を構築したアプリの紹介・インストールページです。
自動リリースパイプラインの全体像
本記事で構築するリリース自動化パイプラインは、リポジトリの VERSION ファイル更新(または手動実行・タグ push)を起点として、テストから Homebrew Tap の更新までを一貫して実行します。
- 検証とタグ作成(
prepareジョブ):VERSIONの SemVer 形式チェックとswift testを実行し、タグ(vX.Y.Z)を自動作成・push する - 証明書復元: ランナー内の一時キーチェーンへ Developer ID 証明書をインポートする
- ビルドと署名:
scripts/build-app.shで Universal Binary(arm64+x86_64)の.appをビルドし、Hardened Runtime 付きで署名する - 公証と Staple:
xcrun notarytoolで Apple 公証サーバーへ提出・完了待機したあと、xcrun staplerで公証チケットを添付しspctlで検証する - GitHub Releases 公開: 公証済み ZIP と SHA256 を生成し、GitHub Releases を作成・公開する
- Homebrew Tap 更新:
homebrew-tapリポジトリの Cask ファイル(version/sha256)を自動で書き換えて push する
以降の手順では、初回のみ必要な証明書・キー・リポジトリの準備から、ワークフローの実装・日常運用まで順に見ていきます。