# Macos App Build

> macOS ネイティブアプリのビルド、実行、Homebrew Cask 管理アプリの更新を行う。XcodeGen + xcodebuild、正規インストール経路、オートメーション権限、トラブルシューティングをカバーする。「アプリをビルドして」「実行して」「macOS アプリを作って」「Homebrew 経由で更新して」などのリクエストで使用する。

- Skill: `schroneko/macos-app-build` (Agent Skill)
- Install (CLI): `npx skillmds@latest add schroneko/macos-app-build`
- Raw SKILL.md: https://api.skillmd.com/api/skills/schroneko/macos-app-build/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: schroneko (https://skillmd.com/u/schroneko)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/schroneko/macos-app-build

---


# macOS App Build

XcodeGen ベースの macOS ネイティブアプリをビルド・実行する。

## 前提条件

- Xcode がインストール済み
- XcodeGen がインストール済み（`brew install xcodegen`）
- project.yml が存在する

## ワークフロー

### Step 1: プロジェクトファイル生成

```bash
xcodegen generate
```

project.yml から .xcodeproj を生成する。

### Step 2: ビルド

```bash
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME -configuration Debug build \
  KEY1="value1" \
  KEY2="value2"
```

ビルド設定（`$(VAR)` で Info.plist に展開される値）はコマンドライン引数として渡す。環境変数（`export`）では展開されない。

### Step 3: オートメーション権限リセット（AppleScript 使用時）

Safari や Chrome を AppleScript で操作するアプリの場合:

```bash
tccutil reset AppleEvents BUNDLE_ID
```

これにより、次回起動時に権限ダイアログが表示される。

### Step 4: アプリ起動

```bash
open ~/Library/Developer/Xcode/DerivedData/PROJECT-*/Build/Products/Debug/APP.app
```

## Homebrew Cask 管理アプリ

Homebrew Cask で導入済みのアプリは、ビルド成果物を `/Applications` へ `ditto`、`cp`、`mv` で直接配置しない。直接配置は Homebrew の receipt と実体を不整合にするため、インストール完了として扱わない。

1. 新しいバージョンの配布アーカイブを正規の release 手順で公開する
2. Cask の `version` と `sha256` を更新して commit、反映対象ブランチへ push する
3. 更新後の Cask を取得して `brew upgrade --cask TOKEN` を実行する。同じバージョンを再導入する正当な理由がある場合だけ `brew reinstall --cask TOKEN` を使う
4. Cask が定める post-install または常駐起動手順を実行する
5. `brew info --cask TOKEN`、Caskroom、`/Applications` のバージョンと checksum、実行中プロセスを確認する

Cask が新しい配布物を参照する前に `brew reinstall` しない。公開済みの旧アーカイブへ戻るため、ローカルビルド成功の検証にはならない。

## トラブルシューティング

### Entitlements file was modified during the build

```
error: Entitlements file "App.entitlements" was modified during the build
```

クリーンビルドで解決:

```bash
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME clean
xcodebuild -project PROJECT.xcodeproj -scheme SCHEME -configuration Debug build ...
```

### オートメーション権限が動作しない

症状: 権限は granted だがタブ/ウィンドウが 0 件

原因: アプリ再ビルドで署名が変わり、macOS が「別のアプリ」として扱っている

解決:

```bash
tccutil reset AppleEvents BUNDLE_ID
```

アプリを再起動し、表示されるダイアログで「OK」をクリック。

### サンドボックスと AppleScript

AppleScript で他アプリを操作する場合、サンドボックスは無効にする必要がある:

```xml
<key>com.apple.security.app-sandbox</key>
<false/>
```

entitlements には以下も必要:

```xml
<key>com.apple.security.automation.apple-events</key>
<true/>
```

### Hardened Runtime と adhoc 署名

`ENABLE_HARDENED_RUNTIME: YES` + adhoc 署名（開発者証明書なし）の組み合わせだと、オートメーション権限ダイアログが表示されないことがある。

開発中は project.yml で無効化:

```yaml
settings:
  base:
    ENABLE_HARDENED_RUNTIME: NO
```

### NSAppleScript で `tab` 定数が動作しない

NSAppleScript 経由で AppleScript を実行すると、`tab` 定数がタブ文字ではなく文字列 "tab" として評価されることがある。ターミナルの `osascript` では正常動作するため発見困難。

解決策: `tab` の代わりに `ASCII character 9` を使用:

```applescript
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 で署名設定:

```yaml
settings:
  base:
    CODE_SIGN_IDENTITY: "-"  # ローカル署名
    # または
    CODE_SIGN_IDENTITY: "Apple Development"  # 開発証明書
```