| name | macos-app-build |
| description | macOS ネイティブアプリのビルドと実行を行う。XcodeGen + xcodebuild のワークフロー、オートメーション権限のリセット、トラブルシューティングをカバーする。「アプリをビルドして」「実行して」「macOS アプリを作って」などのリクエストで使用する。 |
macOS App Build
XcodeGen ベースの macOS ネイティブアプリをビルド・実行する。
前提条件
- Xcode がインストール済み
- XcodeGen がインストール済み（
brew install xcodegen）
- project.yml が存在する
ワークフロー
Step 1: プロジェクトファイル生成
xcodegen generate
project.yml から .xcodeproj を生成する。
Step 2: ビルド
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME -configuration Debug build \
KEY1="value1" \
KEY2="value2"
ビルド設定（$(VAR) で Info.plist に展開される値）はコマンドライン引数として渡す。環境変数（export）では展開されない。
Step 3: オートメーション権限リセット（AppleScript 使用時）
Safari や Chrome を AppleScript で操作するアプリの場合:
tccutil reset AppleEvents BUNDLE_ID
これにより、次回起動時に権限ダイアログが表示される。
Step 4: アプリ起動
open ~/Library/Developer/Xcode/DerivedData/PROJECT-*/Build/Products/Debug/APP.app
トラブルシューティング
Entitlements file was modified during the build
error: Entitlements file "App.entitlements" was modified during the build
クリーンビルドで解決:
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME clean
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME -configuration Debug build ...
オートメーション権限が動作しない
症状: 権限は granted だがタブ/ウィンドウが 0 件
原因: アプリ再ビルドで署名が変わり、macOS が「別のアプリ」として扱っている
解決:
tccutil reset AppleEvents BUNDLE_ID
アプリを再起動し、表示されるダイアログで「OK」をクリック。
サンドボックスと AppleScript
AppleScript で他アプリを操作する場合、サンドボックスは無効にする必要がある:
<key>com.apple.security.app-sandbox</key>
<false/>
entitlements には以下も必要:
<key>com.apple.security.automation.apple-events</key>
<true/>
Hardened Runtime と adhoc 署名
ENABLE_HARDENED_RUNTIME: YES + adhoc 署名（開発者証明書なし）の組み合わせだと、オートメーション権限ダイアログが表示されないことがある。
開発中は project.yml で無効化:
settings:
base:
ENABLE_HARDENED_RUNTIME: NO
NSAppleScript で tab 定数が動作しない
NSAppleScript 経由で AppleScript を実行すると、tab 定数がタブ文字ではなく文字列 "tab" として評価されることがある。ターミナルの osascript では正常動作するため発見困難。
解決策: tab の代わりに ASCII character 9 を使用:
set delim to (ASCII character 9)
set output to output & winId & delim & tabIndex & delim & title & delim & url
ログ確認
アプリのログ出力先（~/Library/Application Support/APP_NAME/）を確認する。Console.app でシステムログも確認可能。
署名について
開発中はローカル署名（Sign to Run Locally）で十分。配布時は Developer ID が必要。
XcodeGen の project.yml で署名設定:
settings:
base:
CODE_SIGN_IDENTITY: "-"
CODE_SIGN_IDENTITY: "Apple Development"
