Xcode GUI 不要！CLI だけで自動化する Apple アプリ開発ガイド

最近、「Xcode は使いにくい」という声がポッドキャストなどで上がっています。しかし、少しの事前準備を行えば、Xcode.app を起動せずに完全に自動化された macOS/iOS アプリ開発環境を構築できます。この記事は、一度だけ行うセットアップ手順と、その後「ヘッドレス（GUI なし）」でビルド・デプロイする方法を解説します。

基本コンセプト

• Xcode.app のインストールは必須ですが、起動する必要はありません。内部ツール（

  xcodebuild

  ,

  notarytool

  など）は CLI から直接呼び出せます。
• 初期設定: Apple ID シグアップ、証明書作成、ノタライゼーション資格情報の保存は、一度限りです。
• 自動化スクリプト: 単一のスクリプト (

  release.sh

  ) で、アーカイブ→署名→ノタライズ→スタップリング→インストールの全工程を制御します。
• 機密情報の安全: シーレット情報はキーチェーンに格納され、リポジトリ（Git）にコミットされません。

1. Xcode のインストールと設定

インストールの確認

Xcode をインストールした直後は、コマンドラインツールのパスが

/Library/Developer/CommandLineTools

確認・変更コマンド：

# 現在のパスを確認
xcode-select -p

# パスが /Applications/Xcode.app... でない場合は修正
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

NOTE

CommandLineTools

という名称は誤解を招きます。

• /Library/Developer/CommandLineTools

  : 軽量パッケージ（clang, git 含む）。iOS SDK や

  notarytool

  は含まれません。

• /Applications/Xcode.app/Contents/Developer

  : フルなツールチェーン。開発に必須。

XcodeGen のインストール

Xcode プロジェクトの自動生成・管理には

XcodeGen

.xcodeproj

brew install xcodegen

2. 一度限りの初期設定

このステップは初回のみ行います。これ以降はマウスを使わずに済みます。

2-1 ライセンスとコンポーネントの受け入れ

Xcode のライセンスをCLI から受け入れます。

sudo xcodebuild -license accept
sudo xcodebuild -runFirstLaunch

2-2 Apple Developer アカウントの登録

Xcode を一度起動して（または GUI ツール）、アカウントを追加します。

NOTE アプリを配布・ノタライズするには、有料の Apple Developer Programへの加入が必要です。 また、Gatekeeper（セキュリティフィルター）を通過させるにはアプリに「公证（ノタライゼーション）」処理を行っておくことが強く推奨されます。

2-3 開発者 ID 証明書の作成

出荷用

.app

Developer ID Application

Apple Development

証明書を作成すると、個人用キー（Private Key）がログインキーチェーンに格納されます。これらを削除しないでください。

2-4 ノタライゼーション資格情報の保存

notarytool

# プロフィール名とチーム ID を設定してください
xcrun notarytool store-credentials App-Name \
  --apple-id "[email protected]" \
  --team-id YOUR-TEAM-ID
# ※プロンプトに応じてアプリ固有のパスワードを入力

重要な注意点

1. プロフィール名の統一: 他アプリのプロフィールを使わず、独自の名称（例:

   App-Name

   ）を使用してください。
2. パスワードの種類: Apple ID のパスワードではありません。「アプリ固有のパスワード」が必要です。
   • appleid.apple.com → Sign-In & Security → App-Specific Passwords から作成してください。
3. 期限切れへの対処: Apple ID パスワード変更時に旧パスワードは無効になります。エラー

   401 invalid credentials

   はパスワード更新後の対応を意味します。

ヒント: 1Password などに保管し、Claude Code など AI ツールと連携させることで、パスワード管理も自動化できます。

3. プロジェクト設定の用意

ローカル設定ファイル (

Local.xcconfig

)

チーム ID とバンドルプレフィックスなどの機密情報を

.xcconfig

cp Local.xcconfig.example Local.xcconfig
# 以下の項目を編集してください:
#   BUNDLE_PREFIX     = your.real.prefix
#   DEVELOPMENT_TEAM  = YOUR-TEAM-ID

.gitignore

の追加

リポジトリに機密情報やビルド生成物を含まないようにします。

# .xcodeproj フォルダ全体を無視
.xcodeproj/

# ローカル設定ファイル（チーム ID 等）をバージョン管理外
Local.xcconfig
build/
*.xcarchive

4. デプロイ自動化スクリプト (

release.sh

) の作成

Xcode.app を起動せず、完全自動化を実現するメインのスクリプトです。以下は生成されたスクリプトの構造例です（AI に作成させる場合が推奨されます）。

スクリプトの流れ

1. プレフライト:

   xcodegen

   とノタライプロファイルの存在確認。
2. プロジェクト再生成: YAML 設定から

   .xcodeproj

   を生成。
3. アーカイブ作成: Release ブィルドを

   .xcarchive

   に出力。
4. 開発者 ID エクスポート: アーカイブを署名した

   .app

   に変換。
5. ノタライゼーション: Apple サーバーでウイルススキャンと署名認証。
6. スタップリング: 署名チケットを添着し、Gatekeeper 通過の準備。
7. 検証とインストール:

   /Applications

   へのコピーと登録。

#!/usr/bin/env bash
# scripts/release.sh — Developer ID-signed, notarized MY-APP-NAME.app install
set -euo pipefail

# 設定変数
PROJECT="MY-APP-NAME.xcodeproj"
SCHEME="MY-APP-NAME-macOS"
APP_NAME="MY-APP-NAME"
TEAM_ID="YOUR-TEAM-ID"
NOTARY_PROFILE="${MY-APP-NAME_NOTARY_PROFILE:-MY-APP-NAME}"
BUILD_DIR="build"

# 実装詳細（アーカイブ→署名→ノタライズ→スタップリング→インストールのロジック）
# ... (略)

スクリプトの実行

一度

release.sh

• 失敗時の挙動:

  set -e

  によりエラー時点で停止し、どこで失敗したかを報告します。
• ローカルの高速テスト用コマンド:
  • 署名なしでビルド＆テスト：

    swift test
    xcodebuild -project YOUR-PROJECT.xcodeproj -scheme YOUR-SCHEME \
      -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO build
    

5. AI エージェント向けマニュアル (

CLAUDE.md

)

自動化を確実に行うために、AI ツール（Claude Code など）に動作方針を記述します。

## Build commands
\`\`\`bash
# プロジェクト再生成
xcodegen generate

# テスト (署名なしで高速)
swift test

# ローカルビルド (署名なし: CI またはサニタチェック用)
xcodebuild -project YOUR-APP.xcodeproj -scheme YOUR-SCHEME \
    -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO build

# 本番リリース用コマンド
./scripts/release.sh   # archive → Developer ID → notarize → staple → install
\`\`\`

## Notes for Agent
- Ad-hoc builds (`CODE_SIGNING_ALLOWED=NO`) are fast but cannot be distributed. Use `./scripts/release.sh` for real distribution.
- Signatures and notarization credentials are stored in the login Keychain, NOT in git.

6. なぜ Xcode を開かなくて済むのか？（技術解説）

.xcodeproj

xcodegen generate from project.yml

xcodebuild … build

xcodebuild … archive

xcodebuild -exportArchive

xcrun notarytool submit --wait

xcrun stapler staple

cp -R + lsregister

• 署名の仕組み: 開発者 ID 証明書と個人用キーがログインキーチェーンに格納されており、

  xcodebuild

  が自動的に検出してバイナリを署名します。
• 機密情報の安全性: パスワードや証明書を Git にコミットしません。すべて CLI ツールの標準機能で処理されます。
• ノタライゼーションの位置づけ: 署名（作者の確認）とは別に、Apple がマルウェアを判定した際の「チケット（スタップル）」を添着するセキュリティプロセスです。

まとめ

このガイドに従ってセットアップを行えば、「Xcode を開く」という行為は不要になります。

1. 初期設定: 一度の GUI 操作とパスワード入力。
2. 日常的な作業:

   swift test

   や

   release.sh

   の実行のみ。

残りの時間は、マウスを操作する代わりに、コードレビューや新規機能の開発に注力できます。最初の数時間を投資してスクリプト化すれば、その後の開発速度は劇的に向上します。