macOS SwiftPM App Packaging (Xcode なし)

概要

SwiftPM 対応の完全な macOS アプリフォルダをブートストラップしてから、Xcode なしでビルド、パッケージ化、実行します。スターター レイアウトは assets/templates/bootstrap/ を、パッケージ化とリリースの詳細は references/packaging.md + references/release.md を参照してください。

2 ステップのワークフロー

1. プロジェクトフォルダをブートストラップ

   • assets/templates/bootstrap/ を新しいリポジトリにコピーします。
   • Package.swift、Sources/MyApp/、version.env 内の MyApp をリネームします。
   • APP_NAME、BUNDLE_ID、バージョンをカスタマイズします。

2. ブートストラップされたアプリをビルド、パッケージ化、実行

   • assets/templates/ からスクリプトをリポジトリにコピーします（例：Scripts/）。
   • ビルド/テスト：swift build と swift test。
   • パッケージ化：Scripts/package_app.sh。
   • 実行：Scripts/compile_and_run.sh（推奨）または Scripts/launch.sh。
   • リリース（オプション）：Scripts/sign-and-notarize.sh と Scripts/make_appcast.sh。
   • タグ + GitHub リリース（オプション）：git タグを作成し、zip/appcast を GitHub リリースにアップロードして公開します。

最小限のエンドツーエンド例

ブートストラップから実行中のアプリまでの最短経路：

# 1. スケルトンをコピーしてリネーム
cp -R assets/templates/bootstrap/ ~/Projects/MyApp
cd ~/Projects/MyApp
sed -i '' 's/MyApp/HelloApp/g' Package.swift version.env

# 2. スクリプトをコピー
cp assets/templates/package_app.sh Scripts/
cp assets/templates/compile_and_run.sh Scripts/
chmod +x Scripts/*.sh

# 3. ビルドして起動
swift build
Scripts/compile_and_run.sh

検証チェックポイント

重要なステップ後に以下を実行して、次のステージに進む前に障害を早期に検出します。

パッケージ化後（Scripts/package_app.sh）:

# .app バンドル構造が無傷であることを確認
ls -R build/HelloApp.app/Contents

# バイナリが存在し実行可能であることを確認
file build/HelloApp.app/Contents/MacOS/HelloApp

署名後（Scripts/sign-and-notarize.sh または ad-hoc dev 署名）:

# 署名と権利を検査
codesign -dv --verbose=4 build/HelloApp.app

# バンドルがローカルで Gatekeeper チェックに合格することを確認
spctl --assess --type execute --verbose build/HelloApp.app

公証とステープリング後:

# ステープルチケットが添付されていることを確認
stapler validate build/HelloApp.app

# Gatekeeper を再実行して公証が認識されたことを確認
spctl --assess --type execute --verbose build/HelloApp.app

一般的な公証エラー

症状	原因の可能性	復旧方法
The software asset has already been uploaded	同じバージョンの重複送信	version.env 内の BUILD_NUMBER をアップして再パッケージ化します。
Package Invalid: Invalid Code Signing Entitlements	.entitlements ファイル内の権利がプロビジョニングと一致しない	権利を Apple が許可するセットと照合し、サポートされていないキーを削除します。
The executable does not have the hardened runtime enabled	codesign 呼び出しに --options runtime フラグが不足	sign-and-notarize.sh を編集して、すべての codesign 呼び出しに --options runtime を追加します。
公証がハング / ステータスメールなし	xcrun notarytool ネットワークまたは認証情報の問題	xcrun notarytool history でステータスを確認し、App Store Connect API キーが有効期限切れの場合は再エクスポートします。
公証成功後に stapler validate が失敗	チケットがまだ伝播していない	約 60 秒待ってから xcrun stapler staple を再実行します。

テンプレート

• assets/templates/package_app.sh: バイナリをビルド、.app バンドルを作成、リソースをコピー、署名します。
• assets/templates/compile_and_run.sh: 実行中のアプリをキル、パッケージ化、起動する開発ループ。
• assets/templates/build_icon.sh: Icon Composer ファイルから .icns を生成（Xcode インストール必須）。
• assets/templates/sign-and-notarize.sh: リリースビルドを公証、ステープル、zip 化します。
• assets/templates/make_appcast.sh: アップデート用に Sparkle appcast エントリを生成します。
• assets/templates/setup_dev_signing.sh: 安定した開発コード署名 ID を作成します。
• assets/templates/launch.sh: パッケージ化された .app 用の簡単なランチャー。
• assets/templates/version.env: パッケージ化スクリプトで使用されるバージョンファイルの例。
• assets/templates/bootstrap/: 最小限の SwiftPM macOS アプリスケルトン（Package.swift、Sources/、version.env）。

注記

• 権利と署名設定を明示的に保ち、テンプレートスクリプトを編集して再実装しないようにします。
• Sparkle をアップデートに使用しない場合は Sparkle ステップを削除します。
• Sparkle はバンドルビルド番号（CFBundleVersion）に依存するため、各アップデートで version.env 内の BUILD_NUMBER を増加させる必要があります。
• メニューバーアプリの場合、パッケージ化時に MENU_BAR_APP=1 を設定して LSUIElement を Info.plist に出力します。