Xcodeを開かずにMacおよびiOSアプリを構築・配信する方法

概要

Xcode.appのインストール は必須だが、GUIを開く必要はほぼ無し
xcodebuild, notarytool, stapler, devicectl は全てXcode内のCLIツール
一度だけ必要な手動作業
- Apple IDへのサインイン（Xcode）
- Developer ID証明書の作成（Xcode）
- ノータリゼーション用パスワードの保存（Terminal）
以降は 完全ヘッドレス でビルド・デプロイが可能

Xcode.app が正しくコマンドラインツールとして選択されているか確認
- xcode-select -p で /Applications/Xcode.app/Contents/Developer であることを確認
- 違う場合は sudo xcode-select -s /Applications/Xcode.app/Contents/Developer で修正
Command Line Tools （/Library/Developer/CommandLineTools）は不要
- iOS SDKやnotarytool等はXcode.app内にしか含まれない

ライセンス同意・追加コンポーネントのインストール
- sudo xcodebuild -license accept
- sudo xcodebuild -runFirstLaunch
Apple Developerアカウントの設定
- Xcode > 設定 > アカウント > + から追加
- 有料Apple Developerアカウント が必要
Developer ID Application証明書の作成
- Xcode > 設定 > アカウント > 証明書管理 > + > Developer ID Application
- 開発用証明書とは別物、配布・ノータリゼーション用
- 証明書と秘密鍵は loginキーチェーン に保存、バックアップ推奨

チームIDやバンドルプレフィックス等を Local.xconfig に記載し、.gitignoreへ追加
- 例：BUNDLE_PREFIX = your.real.prefix
- 例：DEVELOPMENT_TEAM = YOUR-TEAM-ID

release.sh で全工程を自動化
- プロジェクト生成 → アーカイブ → Developer ID署名 → ノータリゼーション → ステープル → /Applicationsへインストール
AI（Claude Code等） に要件を伝えれば、プロジェクト固有のスクリプトを自動生成可能
スクリプト例（主要ポイントのみ抜粋）
- set -euo pipefailで失敗時即停止
- cd "$(dirname "$0")/.."でリポジトリルートへ移動
- xcodegen/Notary Profileの事前チェック
- xcodebuildでアーカイブ・エクスポート
- notarytoolでノータリゼーション
- staplerでチケット付与
- spctlでGatekeeper検証
- /Applicationsへコピー、lsregisterで再登録
```
#!/usr/bin/env bash
set -euo pipefail
# ...（変数定義・事前チェックなど）
xcodegen generate
xcodebuild -project ... -archivePath ... archive
xcodebuild -exportArchive ...
xcrun notarytool submit ... --wait
xcrun stapler staple ...
spctl -a -vvv -t exec ...
cp -R ... /Applications/
```
スクリプトの特徴
- 途中失敗時は即停止、半端な状態を残さない
- どのディレクトリからも実行可能
- 事前チェックで無駄なビルドを防止
- インストール後のバリデーションも自動化