HN 日本語サマリー

← 一覧へ戻る
Web開発

Xcodeを開かずにMacおよびiOSアプリをビルド・配布する方法

Building and Shipping Mac and iOS Apps Without Ever Opening Xcode (scottwillsey.com)

509 pointsby speckx215 コメント

要約

この記事では、Xcodeを直接開くことなく、MacおよびiOSアプリケーションを開発し、配布するためのアプローチについて説明します。開発ワークフローを効率化し、よりモダンな開発環境を構築することを目指しています。

全文翻訳

Xcodeを開かずにMacおよびiOSアプリをビルド・配布する方法

最近、いくつかのApple関連のポッドキャスターがXcodeの悪口を言っているのを聞きました。彼らは、AppleはXcodeをより分かりやすくすることで、MacやiOSアプリの「雰囲気コーディング」を改善する必要があると言っています。彼らが間違っているわけではありませんが、そもそもなぜ彼らがXcodeを開いているのか理解できません。少しの事前準備をすれば、Xcodeを見ることなく、好きなだけMacやiOSアプリの「雰囲気コーディング」ができます。

そして、以下のいずれかの方法で作業を進めることに疑問がある場合は、Claude Codeや好みのLLMコーディングツールにこのブログ記事を提示し、それを解決させましょう。それが文字通り、あなたがやりたくないことを解決する仕事なのです。

TL;DR

  • Xcode.appはインストールされている必要がありますが、開く必要はありません。 xcodebuild、notarytool、stapler、devicectl はすべてXcode内にあり、シェルから問題なく実行できます。
  • いくつかの1回限りの手順はGUI(またはインタラクティブなターミナル)を必要とします:Apple IDへのサインイン、開発者ID証明書の作成、 notarizationパスワードの保存。その後は、ビルドとデプロイは完全にヘッドレスで行えます。
  • Macアプリは1つのスクリプト — scripts/release.sh — で配布されます。これは一度書けばOKです。アーカイブ → 開発者ID署名 → notarization → staple → /Applications へのインストールという一連の流れを実行します。
  • 署名は証明書とキーチェーンに基づいています。 署名キーはログインキーチェーンに保存され、xcodebuild が自動的に見つけます。リポジトリに秘密情報を保存する必要はありません。

1回限りのセットアップが唯一手間のかかる部分なので、まずそれを済ませましょう。

Xcodeのインストール

Xcodeはインストールする必要があります。それなしでは済まされません。なぜなら、ビルドはXcode内のツールに依存するからです。

Xcodeをインストールしたら、コマンドラインツールチェーンとしてXcodeが選択されていることを確認してください。/Library/Developer/CommandLineTools ではなくです。チェックの出力が /Applications/Xcode.app/Contents/Developer であれば、うまくいっています。

❯ xcode-select -p
/Applications/Xcode.app/Contents/Developer

もしスタンドアロンのCommandLineToolsのパスが返された場合は、Xcodeを指すようにしてください。

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

注意: 「Command Line Tools」という名前は紛らわしいことがあります。

これは、xcodebuild --install で利用可能なスタンドアロンのCommand Line Toolsパッケージ、つまり /Library/Developer/CommandLineTools バージョンが存在するためです。これにはclangとgitが含まれていますが、iOS SDK、notarytool、devicectl、その他の完全なアプリ開発に必要なアイテムは含まれていません。

完全なツールチェーンはXcode.app内の /Applications/Xcode.app/Developer にあり、必要なものはすべて揃っています。Xcodeがインストールされていれば、スタンドアロンのCommand Line Toolsは不要です。

XcodeGenのインストール

Xcodeとそのコマンドラインツールだけでは、Xcodeプロジェクトを自動的に生成・管理するには不十分です。そのためには、XcodeGen が必要になります。GitHubからダウンロードするか、Homebrewを使ってインストールできます。

brew install xcodegen

長話はさておき、Xcodeプロジェクトは実際にはmacOSがファイルのように見せかけているフォルダであり、アプリを作成・コンパイルするために必要なプロジェクトのすべてが含まれています。Xcodeはファイルやファイル参照を絶えず変更しており、gitリポジトリに問題を引き起こします。

Xcodegenは、プロジェクト設定すべてを含む project.yml (YAML) ファイルを作成し、ビルドごとにその project.yml ファイルを使って完全な .xcodeproj フォルダを再作成します。コミットする必要があるのはYAMLファイルだけで、.xcodeproj 全体はgitの観点からは無視できます。

Xcodeの設定(一度だけ)

Xcodeを二度と開かなくて済むように、初期設定を行う必要があります。

Xcodeライセンスと追加コンポーネント

まず、ライセンスに同意して追加コンポーネントをインストールするか、コマンドラインから実行してください。

sudo xcodebuild -license accept
sudo xcodebuild -runFirstLaunch
XcodeでのApple Developerアカウントの設定

次に、Xcodeを開き、Settings → Accounts をクリックして、アカウントを追加するために + をクリックします。

注意: アプリを配布し、notarizeするには、有料のApple Developerアカウントが必要です。

そして、MacやiOSデバイスにインストールした際にOSがマルウェアと判断して削除しないように、notarizeすることをお勧めします。

開発者IDアプリケーション証明書の作成

それが完了したら、開発者IDアプリケーション証明書を作成します(Settings → Accounts → あなたのApple ID → Manage Certificates… → + → Developer ID Application)。これにより、配布される.appバンドルに署名するための証明書が作成されます。

開発者IDアプリケーション証明書とApple開発者証明書は別物であることに注意してください。

Apple Development アイデンティティは、自分のデバイスでビルドして実行するため(iPhoneへのプッシュ、ローカルデバッグ)のものです。Developer ID Application アイデンティティは、Gatekeeperを通過し、他人のMacで実行されるnotarize済みの.appのためのものです。リリーススクリプトは後者の証明書を必要とします。

Xcodeで証明書を作成すると、証明書とそれに対応する秘密鍵の両方がログインキーチェーンにインストールされます。その秘密鍵が実際に署名を行うものであり、再ダウンロードすることはできません — ですので、削除せず、キーチェーンをバックアップしてください。

不明な点があれば、好みのLLMに尋ねてセットアップを手伝ってもらいましょう。結局のところ、Xcodeを使ってくれるのはLLMなのですから。

そして最後に、

Notarization認証情報の保存 – ターミナルで一度だけ

Notarizationは、署名されたアプリをマルウェアスキャン用にAppleにアップロードするプロセスです。notarytool は、一度だけ対話的に作成する保存されたキーチェーンプロファイルを使用して認証します — アプリケーション固有のパスワードを求められ、このプロンプトを回避する方法はありません。

xcrun notarytool store-credentials App-Name \
  --apple-id "[email protected]" --team-id YOUR-TEAM-ID
# プロンプトが表示されたら、アプリケーション固有のパスワードを貼り付けます

知っておくと良い点がいくつかあります。

  • プロファイルにはアプリの名前を付けます。 他のアプリのプロファイルを借りないでください — それはあなたのマシンでは動作しますが、他人のマシンではサイレントに失敗します。
  • アプリケーション固有のパスワードはApple IDのパスワードではありません。 appleid.apple.com → Sign-In & Security → App-Specific Passwords で生成してください。
  • これらのパスワードは、Apple IDのパスワードを変更するとサイレントに期限切れになります。 notarizationで 401 invalid credentials が発生した場合、それはほとんどの場合「新しいアプリケーション固有のパスワードを作成してください」という意味であり、「セットアップが壊れています」という意味ではありません。

保存されていることを確認します。

xcrun notarytool history --keychain-profile App-Name

余談ですが、私はアプリケーション固有のパスワードを1Passwordのボールトに保存しており、Claude Codeがそれにアクセスできるようにしています。これにより、新しいアプリを作成するたびに、Claudeに notarization認証情報を作成するように指示でき、ボールトからパスワードを確認することを認識します。LLMを使用するそもそもの目的は、手動で行いたくないことを避けることです。

Local.xconfig ファイルの設定と .gitignore への追加

実際の署名にはチームIDとバンドルプレフィックスが必要なので、私はそれらを Local.xconfig ファイルに保存しています。

cp Local.xcconfig.example Local.xcconfig
# 次に Local.xcconfig を編集して設定します:
#   BUNDLE_PREFIX     = your.real.prefix
#   DEVELOPMENT_TEAM  = YOUR-TEAM-ID

繰り返しになりますが、不明な点があれば、Claude Codeまたは好みのLLMに作成を依頼してください。

エージェントツールのセットアップ

デプロイスクリプトの作成

私のアプリでのデプロイは、リポジトリ内の scripts フォルダにある release.sh というスクリプトで処理されます。これがないと、自動化されたビルドパイプラインがありません。

私はClaude Codeに私のスクリプトを作成させました。Claudeには、おおよそ次のように伝えました。「Xcodeを開かずに、アーカイブ、開発者ID署名、notarization、staple、そしてこのアプリを/Applicationsにインストールしたい。この全プロセスを実行し、どのステップが失敗しても大声で知らせるスクリプトを書いてほしい。」

パイプラインを説明する必要はありませんでした。なぜなら、パイプラインは秘密ではないからです — xcodebuild でアーカイブし、-exportArchive と ExportOptions.plist でエクスポートし、notarytool --wait で提出し、stapler でチケットを添付し、spctl でチェックします。これは、開発者ID Macアプリを配布するための、文書化された標準的な方法であり、モデルはそれを知っています。私から必要だったのは、プロジェクト固有の情報でした:スキーム名、チームID、notaryプロファイルの名前、結果のインストール場所。

その後、最初のドラフトが書かれ、実行し、失敗し、修正しました。そのループは失敗モードではなく、単なるプロセスです。私は常にAIワークフローを進行中の作業と見なしますが、調整をやめて作業を開始するまでにはそれほど時間はかかりません。

これは私のアプリリポジトリの実際のスクリプトです。

#!/usr/bin/env bash
# scripts/release.sh — 開発者ID署名され、notarizeされたMY-APP-NAME.appを生成し、
# /Applications にインストールします。
#
# 必要条件(一度だけ):XcodeでApple IDにサインイン済み、有料開発者プログラム、
# およびnotarytool認証情報プロファイル。デフォルトは「MY-APP-NAME」プロファイルです。
# MY-APP-NAME_NOTARY_PROFILE=<name> で上書きできます。
#
# 使用法: ./scripts/release.sh

set -euo pipefail

PROJECT="MY-APP-NAME.xcodeproj"
SCHEME="MY-APP-NAME-macOS"
APP_NAME="MY-APP-NAME"
TEAM_ID="YOURTEAMID"
NOTARY_PROFILE="${MY-APP-NAME_NOTARY_PROFILE:-MY-APP-NAME}"

BUILD_DIR="build"
ARCHIVE_PATH="$BUILD_DIR/$APP_NAME.xcarchive"
EXPORT_PATH="$BUILD_DIR/Export"
APP_PATH="$EXPORT_PATH/$APP_NAME.app"
INSTALL_DIR="/Applications"
LSREGISTER="/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister"

cd "$(dirname "$0")/.."

step() { printf "\n\033[1;36m▸ %s\033[0m\n" "$*"; }
fail() { printf "\n\033[1;31m✗ %s\033[0m\n" "$*" >&2; exit 1; }

step "Pre-flight"
command -v xcodegen >/dev/null || fail "xcodegen not installed (brew install xcodegen)."
if ! xcrun notarytool history --keychain-profile "$NOTARY_PROFILE" >/dev/null 2>&1; then
  fail "notarytool profile '$NOTARY_PROFILE' missing. Create it with xcrun notarytool store-credentials."
fi

step "Regenerating project"
xcodegen generate

rm -rf "$BUILD_DIR"; mkdir -p "$BUILD_DIR"

step "Archiving (Release)"
xcodebuild -project "$PROJECT" -scheme "$SCHEME" -configuration Release \
  -derivedDataPath "$BUILD_DIR/derived" -archivePath "$ARCHIVE_PATH" \
  -allowProvisioningUpdates archive

step "Exporting Developer ID-signed app"
cat > "$BUILD_DIR/ExportOptions.plist" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>method</key><string>developer-id</string>
  <key>teamID</key><string>$TEAM_ID</string>
  <key>signingStyle</key><string>automatic</string>
</dict></plist>
EOF
xcodebuild -exportArchive -archivePath "$ARCHIVE_PATH" -exportPath "$EXPORT_PATH" \
  -exportOptionsPlist "$BUILD_DIR/ExportOptions.plist" -allowProvisioningUpdates
[ -d "$APP_PATH" ] || fail "Exported app not found at $APP_PATH."

step "Notarizing (submitting to Apple, may take a few minutes)"
ditto -c -k --keepParent "$APP_PATH" "$BUILD_DIR/notarize.zip"
xcrun notarytool submit "$BUILD_DIR/notarize.zip" --keychain-profile "$NOTARY_PROFILE" --wait

step "Stapling ticket"
xcrun stapler staple "$APP_PATH"

step "Verifying Gatekeeper acceptance"
spctl -a -vvv -t exec "$APP_PATH"

step "Installing to $INSTALL_DIR/$APP_NAME.app"
pkill -x "$APP_NAME" 2>/dev/null || true
rm -rf "$INSTALL_DIR/$APP_NAME.app"
cp -R "$APP_PATH" "$INSTALL_DIR/"
[ -x "$LSREGISTER" ] && "$LSREGISTER" -f "$INSTALL_DIR/$APP_NAME.app" >/dev/null 2>&1 || true

step "Verifying installed bundle"
xcrun stapler validate "$INSTALL_DIR/$APP_NAME.app"
spctl -a -vvv -t exec "$INSTALL_DIR/$APP_NAME.app"
printf "\n\033[1;32m✓ %s notarized, stapled, installed.\033[0m\n" "$APP_NAME"

これは見た目よりも複雑ではありませんが、実行する必要があるステップのシリーズです。繰り返しになりますが、これがLLMに話しかけ、望むことを伝え、ワークフローの構築を手伝ってもらう理由です。

注意すべき点があります。

set -euo pipefail は、失敗したコマンドがあっても、そのまま進むのではなく、すぐにスクリプトを停止させます。成功したように見える半端な状態はありません。

cd "$(dirname "$0")/.." は、スクリプトがどこから呼び出されてもリポジトリのルートに移動することを意味します。そのため、リポジトリのルートにいても、3ディレクトリ下からでも ./scripts/release.sh は機能します。

プリフライトブロックは、xcodegen が存在し、notaryプロファイルが実際に保存されていることを、5分かかるアーカイブがステップ5で失敗する前にチェックします。

そして最後の2つのステップは、エクスポートされたバンドルだけでなく、インストールされたバンドルを再検証します。二重の安全策ですが、コピー操作でサイレントにバンドルが破損したことがあり、3日後にGatekeeperがアプリを削除するよりも、スクリプトでそれを知る方が良いです。

CLAUDE.md または AGENTS.md の作成

release.sh はワンコマンドデプロイを提供します。CLAUDE.md(または、ほぼすべての他のモデルでは AGENTS.md)は、エージェントが毎回指示されなくてもそれを使用できるようにするものです。

ビルドプロセスについて何度もやり取りした後、私はClaudeに自分の CLAUDE.md を作成させました。これにより、新しいアプリを作成するたびに、他のアプリのリポジトリを参照して同じ方法論を使用するように指示できます。

## ビルドコマンド

```bash
# project.yml またはソースファイルを追加した後、Xcodeプロジェクトを再生成します
xcodegen generate

# 単体テスト(YOUR-APP-NAMEKitのみ。高速でXcodeビルド不要)
swift test

# macOSアプリ
xcodebuild -project YOUR-APP-NAME.xcodeproj -scheme YOUR-APP-NAME-macOS \
    -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO build
```

## リリース(開発者ID + notarization)

```bash
./scripts/release.sh   # アーカイブ → 開発者IDエクスポート → notarize → staple → インストール
```

上記の `xcodebuild` コマンドは `CODE_SIGNING_ALLOWED=NO` を使用しており、これは**アドホック**ビルドを生成します。CIやクイックローカルチェックには問題ありませんが、Gatekeeperはこれを拒否し、iCloud KVS / App Groupのエンタイトルメントはバインドされません(チームプレフィックスなし)。クォランティンを通過し、iCloud同期を可能にする実際のメニューバービルドには、`scripts/release.sh` を使用してください。これは開発者IDで署名し、`YOUR-APP-NAME` notarytoolキーチェーンプロファイル経由でnotarizeし、チケットをstapleし、`/Applications/YOUR-APP-NAME.app` にインストールします。

それだけです

そして、これがすべての1回限りのセットアップです。ここからは、マウスを必要とするものは何もありません。

ビルドは実際にはどのように実行されるか — GUIは不要

以下のすべてはプレーンなコマンドライン呼び出しです。Xcode.appは起動しません。これらのツールはXcode内にありますが、スタンドアロンで実行されます。これはまさにClaude Codeがシェルを通じて実行していることです。

高速な未署名チェック

「コンパイルできるか / テストはパスするか」という場合、署名はまったく必要ありません。

# 単体テスト — 純粋なSPM、Xcodeビルドは一切不要
swift test

# macOSアプリのコンパイル(アドホック、未署名 — CI/ローカルの健全性チェックに十分)
xcodebuild -project TZed.xcodeproj -scheme TZed-macOS \
    -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO build

# シミュレータ用のiOSアプリ + ウィジェット拡張のコンパイル
xcodebuild -project TZed.xcodeproj -scheme TZed-iOS \
    -destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NO build

CODE_SIGNING_ALLOWED=NO はアドホックビルドを提供します。コンパイルしてシミュレータで実行できますが、Gatekeeperはこれを拒否し、iCloud KVSやApp Groupのようなエンタイトルメントはバインドされません。これが高速な内部ループです。

Macリリースパイプライン

1つのコマンドで、配布可能な全チェーンを実行します — パート2のスクリプトです。

./scripts/release.sh

アーカイブ、開発者IDエクスポート、notarize、staple、検証、インストール。いずれかのステップが失敗すると停止し、どのステップが壊れたかを通知します。別のnotaryプロファイルが必要ですか?上書きしてください: TZED_NOTARY_PROFILE=<name> ./scripts/release.sh。

実機iPhoneへのデプロイ、ヘッドレスで

iOSにはnotarizationステップはありません — それはMac配布の概念です。ビルドを接続されたiPhoneに転送するには、xcodebuild と devicectl を使用します。どちらもXcodeのツールチェーン内にあります。

# 実機用のビルドと署名(Apple Development証明書 + プロビジョニングを使用)
xcodebuild -project TZed.xcodeproj -scheme TZed-iOS \
    -destination 'generic/platform=iOS' \
    -allowProvisioningUpdates \
    -derivedDataPath build/ios archive -archivePath build/TZed-iOS.xcarchive

# ビルドされた.appをUDIDで接続されたデバイスにインストール
xcrun devicectl device install app \
    --device <DEVICE-UDID> build/ios/…/TZed.app

devicectl list devices は、接続およびペアリングされたデバイスとそのUDIDを一覧表示します。デバイスビルドは、Apple Development アイデンティティ(開発者IDではない)と開発用プロビジョニングプロファイルで署名され、-allowProvisioningUpdates がそれを取得します。

GUIがない場合のコード署名の仕組み

もしあなたがアプリの署名をボックスにチェックを入れるだけで行ってきたなら、実際に何が起こっているのかを理解する価値があります。なぜなら、ビルド時にはGUIは何も必要ないからです。

秘密鍵が署名を行います。 開発者IDアプリケーション証明書を作成したとき、Appleは証明書を発行し、あなたのMacは対応する秘密鍵を生成しました。どちらもログインキーチェーンに配置されます。codesign(xcodebuild が呼び出すもの)は、秘密鍵を使用してバイナリに署名します。証明書 — Appleのルートにチェーンアップしているもの — が埋め込まれ、誰でも検証できるようにします。

自動署名は、アイデンティティを自動選択します。 リリーススクリプトは signingStyle: automatic を使用するため、xcodebuild はチームIDによって適切なアイデンティティを選択し、必要なプロビジョニングプロファイルをオンザフライでAppleから取得します。リポジトリにプロファイルはチェックインされません。

エンタイトルメントは署名時にバインドされます。 各ターゲットには .entitlements ファイル(サンドボックス、ネットワーククライアント、iCloud KVS、App Group)があります。これらは、アプリが実際のチームアイデンティティで署名されたときにのみ有効になります。これが、アドホックビルドが配布できないもう1つの理由です:iCloudとApp-Groupのエンタイトルメントは、チームプレフィックスなしではサイレントにバインドされず、キーバリューストアが空である理由を1時間かけて悩むことになります。

Notarizationは署名ではありません。 署名は、誰がアプリをビルドしたかを証明します。Notarizationは、Appleが署名されたアプリをマルウェアスキャンし、チケットを発行する別のステップです。staplingは、Gatekeeperがオフラインでアプリを信頼できるように、そのチケットを添付します。隠しUIのメニューバーアプリ(LSUIElement)の場合、XProtectがそれをフラグ付けしないようにするのはnotarizationです。

秘密情報はgitに触れることはありません。 署名用の秘密鍵はログインキーチェーンにあります。notarization用のアプリケーション固有のパスワードは、notarytoolキーチェーンプロファイルにあります。どちらもリポジトリに書き込まれることはありません。

署名されたビルドは、手動で検証できます。

codesign -dv --verbose=4 /Applications/TZed.app   # 誰が、どの証明書で署名したか
spctl -a -vvv -t exec   /Applications/TZed.app     # Gatekeeperは許可するか?
stapler validate        /Applications/TZed.app     # notarizationチケットは添付されているか?

エージェントが実際に使用するもの

ここには魔法はありません。Claude Codeは、特別な「ビルド」MCPサーバーや賢いプラグインを使わずに、プレーンな非対話型シェルを通じてこれらすべてを操作します。それは xcodebuild、xcrun notarytool、xcrun stapler、spctl、codesign、devicectl、xcodegen、そして swift です。標準的なCLIツールであり、私たち自身が使用するものと同じです。

連携の鍵はパート2の CLAUDE.md です。これはエージェントに、notary-profileの規約、2つのビルドパス、そして配布が release.sh を意味することを伝えます。結果として、Claudeは私が毎回再説明することなく、それを実行するだけです。

対話的なままなのは notarytool store-credentials の1ステップだけで、これは制限ではなく選択です:--password を渡してスクリプト化することも可能ですが、それはアプリケーション固有のパスワードをシェル履歴に入れることを意味します。一度手で入力し、キーチェーンまたは1Passwordに保存させれば、それ以降はすべて自動化されます。

なぜXcodeを開く必要がないのか

GUIワークフローとヘッドレスワークフローを並べると、すべてが明確になります。

ジョブGUIの方法ヘッドレスの方法
プロジェクト生成Xcodeが.xcodeprojを管理project.yml から xcodegen generate
ビルド⌘B / 実行ボタンxcodebuild … build
アーカイブProduct → Archivexcodebuild … archive
署名済みアプリのエクスポートOrganizer → Distributexcodebuild -exportArchive
NotarizeOrganizerアップロードxcrun notarytool submit --wait
Staple(Organizerで自動)xcrun stapler staple
/Applications へのインストールドラッグ&ドロップcp -R + lsregister
iPhoneへのデプロイデバイスで実行xcodebuild archive + devicectl device install

GUIが必要なのは、その1回限りの認証情報セットアップだけです。その後は、ライフサイクル全体がスクリプト化可能になり、まさに release.sh が完成させるものであり、エージェントがエンドツーエンドでそれを所有できる理由です。その間、私はプログレスバーを見つめるよりも面白いことをしています。

自分で試したい場合は、順序は次のようになります:Xcodeとxcodegenをインストールし、認証情報の設定を行い、それからClaudeと一緒に独自の release.sh と CLAUDE.md を作成します。最後の部分が実際の作業であり、最大で1〜2時間です。その後、「新しいビルドを配布する」は1文になります。最初のアプリセットアップの後、Claude Codeは将来のアプリにも同じセットアップをコピーして適用できます。