SwiftPM製macOSアプリをDeveloper ID署名・Apple公証してHomebrew Tapへ自動公開する
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 で自動化する仕組みを実践しましたので、その手順を紹介します。
自動リリースパイプラインの全体像
本記事で構築するリリース自動化パイプラインは、リポジトリの 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 する
以降の手順では、初回のみ必要な証明書・キー・リポジトリの準備から、ワークフローの実装・日常運用まで順に見ていきます。
前提とするプロジェクト構成
実例となる Wintch は、Xcode のプロジェクトファイル(.xcodeproj)を持たず、SwiftPM(Package.swift)とシェルスクリプト(scripts/build-app.sh)で .app バンドルを組み立てる構成を採用しています。
- ビルド方式: SwiftPM(
Package.swift)およびscripts/build-app.sh - Bundle ID:
dev.wintch.Wintch(Resources/Info.plistで定義) - 最小対応 OS: macOS 14.0 Sonoma 以降(
LSMinimumSystemVersion=14.0) - App Sandbox: オフ(ウィンドウ操作用 API である
AXUIElementやCGEventTap、SMAppService.mainAppを使用するため) - Hardened Runtime: リリースビルド時に
codesign --options runtimeで有効化
.xcodeproj が存在しない構成では、Xcode GUI の「Signing & Capabilities」や xcodebuild archive ではなく、scripts/build-app.sh 内の codesign コマンドと GitHub Actions ワークフロー(.github/workflows/release.yml)側で署名・公証を制御します。
Developer ID Application 証明書の作成とエクスポート
Apple 外(GitHub Releases や Homebrew)でアプリを配布するには、Apple Developer Program に登録した上で Developer ID Application 証明書を発行する必要があります。
証明書の作成
Xcode の Settings... > Accounts から Apple Developer Program 登録済みのアカウントを選択し、Manage Certificates... から + > Developer ID Application を選んで証明書を作成します。
Xcode 上で「Communication with Apple failed / This operation can only be performed by the Account Holder.」といったエラーが出る場合は、以下の手順を確認します。
- Apple Developer Account にサインインし、未同意の規約(License Agreement)や更新通知があれば承認する。
- それでも Xcode から作成できない場合は、Web ブラウザ(Apple Developer Portal)から直接発行する。
- キーチェーンアクセス アプリのメニューから キーチェーンアクセス > 証明書アシスタント > 認証局に証明書を要求... を開く。
- Apple ID のメールアドレスと任意の通称を入力し、ディスクに保存 を選んで
.certSigningRequest(CSR)ファイルを保存する。 - Apple Developer Portal の Certificates を開き、
+> Developer ID Application(G2 Sub-CA)を選択して CSR をアップロードし、生成された.cerファイルをダウンロードする。 - ダウンロードした
.cerをダブルクリックして「ログイン」キーチェーンへ追加すると、CSR 作成時の秘密鍵と自動で紐づく。
証明書名の確認と .p12 エクスポート
証明書を GitHub Actions へ渡すため、秘密鍵を含んだ .p12 形式で書き出します。
- macOS の キーチェーンアクセス を開き、左ペインで「ログイン」>「自分の証明書」を選択します。
Developer ID Application: <Your Name> (<TEAM_ID>)の行を探し、左の>を展開して配下に「秘密鍵」が紐づいていることを確認します。この証明書名の文字列は、後の Secret 設定(MACOS_SIGN_IDENTITY)でそのまま使用します。- 秘密鍵ではなく 証明書の行を選択した状態 で右クリックし、書き出す... からフォーマット 個人情報交換 (.p12) を選んで保存します。このとき設定したパスワードは
MACOS_CERT_PASSWORD用に控えておきます。
Base64 文字列への変換
書き出した .p12 ファイルを GitHub Secrets へ登録できるよう、以下のコマンドで Base64 文字列へ変換します(macOS の pbcopy でそのままクリップボードへ入ります)。
base64 -i /path/to/certificate.p12 | tr -d '\n' | pbcopy
コピーされた文字列は MACOS_CERT_BASE64 用に控えておきます。
App Store Connect API Key(公証用)の発行
GitHub Actions 上から xcrun notarytool で公証を実行するには、Apple ID のパスワードではなく App Store Connect API Key を使用すると安定します。API Key 方式であれば、2 要素認証(2FA)の対話入力やアプリ用パスワードの再発行に影響されず CI を運用できます。
- App Store Connect にアクセスし、ユーザーとアクセス > 統合(Integrations) > App Store Connect API を開きます。
+ボタンから新規キーを作成します。- 名前: 用途が分かるラベル(例:
Wintch GitHub Actions Notary) - アクセス(ロール): Developer(公証用途であれば最小権限である Developer ロールで動作します)
- 名前: 用途が分かるラベル(例:
- 一覧に表示される Issuer ID と Key ID を控えます。
- API キーをダウンロード から
.p8ファイルを保存します(.p8ファイルのダウンロードは 1 回のみ可能です)。 - 以下のコマンドで
.p8ファイルを Base64 文字列へ変換し、NOTARY_KEY_BASE64用に控えておきます。
base64 -i /path/to/AuthKey_XXXXXXXXXX.p8 | tr -d '\n' | pbcopy
homebrew-tap リポジトリの作成とトークン発行
続いて、利用者が brew install --cask sawarame/tap/wintch のようにインストールできるようにするための専用リポジトリを用意します。
Tap 用リポジトリと初期 Cask の作成
GitHub 上で自分のアカウント配下に homebrew-tap という名前の 新規パブリックリポジトリ を作成します(ブランチではなく独立したリポジトリとして作 成します)。リポジトリ名を homebrew- プレフィックスにすることで、Homebrew 側で ユーザー名/tap という短縮指定が使えるようになります。
作成した homebrew-tap リポジトリの main ブランチに Casks/wintch.rb を配置し、コミットしておきます。初回リリース前の段階では sha256 :no_check としておき、初回リリース時に GitHub Actions から実際の値へ書き換えられるようにします。
cask "wintch" do
version "0.1.0"
sha256 :no_check
url "https://github.com/sawarame/Wintch/releases/download/v#{version}/Wintch-v#{version}.zip"
name "Wintch"
desc "Simple and lightweight window switcher for macOS"
homepage "https://github.com/sawarame/Wintch"
depends_on macos: ">= :sonoma"
app "Wintch.app"
zap trash: [
"~/Library/Preferences/dev.wintch.Wintch.plist",
]
end
更新用 Fine-grained PAT の発行
アプリ側(sawarame/Wintch)の GitHub Actions から別リポジトリ(sawarame/homebrew-tap)へ Cask の更新を push するため、スコープを絞った Fine-grained Personal Access Token を発行します。
- GitHub の Settings > Developer settings > Personal access tokens > Fine-grained tokens を開き、Generate new token をクリックします。
- 以下の内容を設定してトークンを発行し、
HOMEBREW_TAP_TOKEN用に控えておきます。- Token name: 例
wintch-homebrew-tap-updater - Expiration: 運用しやすい有効期限(例:90 days 〜 1 year)
- Repository access: Only select repositories を選び、
homebrew-tapリポジトリのみを指定 - Permissions > Repositories:
+ Add permissionsから Contents を追加し、権限を Read and write に設定
- Token name: 例
GitHub Secrets の登録
アプリ側リポジトリの Settings > Secrets and variables > Actions > New repository secret から、以下の 7 つの Secret を登録します。
- MACOS_CERT_BASE64: Base64 化した
.p12証明書の文字列 - MACOS_CERT_PASSWORD:
.p12書き出し時に設定したパスワード - MACOS_SIGN_IDENTITY: 証明書名(
Developer ID Application: <Your Name> (<TEAM_ID>)) - NOTARY_KEY_BASE64: Base64 化した
.p8API キーの文字列 - NOTARY_KEY_ID: App Store Connect API の Key ID
- NOTARY_ISSUER_ID: App Store Connect API の Issuer ID(Team API Key の場合は必須)
- HOMEBREW_TAP_TOKEN:
homebrew-tap更新用に発行した Fine-grained PAT