アプリとビルドループのひな形作成

新しい Mac アプリでは、まず Codex に、適切なシーンモデルとして WindowGroup、Window、Settings、MenuBarExtra、DocumentGroup のいずれかを選ばせます。そうすれば、iOS 風の ContentView を起点に拡張していくのではなく、最初からデスクトップネイティブなアプリにできます。

実行ループはシェル中心に保ちます。Xcode プロジェクトでは xcodebuild を使います。パッケージ中心のアプリでは swift build と、古いプロセスの停止、アプリのビルド、新しい成果物の起動を行い、必要に応じてログやテレメトリも参照できるようにするプロジェクトローカルの script/build_and_run.sh ラッパーを使います。

SwiftPM のみで構成されたアプリが GUI アプリの場合は、生の実行可能ファイルを直接実行するのではなく、.app としてバンドルして起動します。これにより、ローカル検証時に Dock への表示、アクティベーション、バンドル識別情報が欠ける問題を回避できます。

スキルの活用

作業内容がデスクトップ固有になってきたら Build macOS Apps プラグイン を追加します。このプラグインには、シェル中心のビルド・デバッグループ、SwiftPM アプリのパッケージング、ネイティブな SwiftUI のシーンとウィンドウのパターン、AppKit 連携、統合ロギング、テストのトリアージ、署名と公証のワークフローが含まれています。

プラグインとスキルのインストール方法や使い方について詳しくは プラグインのドキュメント と スキルのドキュメント を参照してください。

デスクトップネイティブ UI の構築

iOS のナビゲーションパターンより、Mac の慣例を優先します。サイドバー／詳細レイアウトには NavigationSplitView、環境設定には明示的な Settings シーン、見つけやすい操作にはツールバーとコマンド、常時利用できる軽量ユーティリティにはメニューバーの追加項目を使用します。

まず、システムマテリアル、セマンティックカラー、標準コントロールを使用します。製品で独自のデスクトップ表現が必要な場合に限り、カスタムウィンドウスタイル、ドラッグ領域、Liquid Glass サーフェスを追加します。

SwiftUI だけでは必要な動作を完全に実現できない場合は、可能な限り小さな AppKit ブリッジを追加します。たとえば、開く／保存パネル、ファーストレスポンダー制御、メニュー検証、ドラッグ＆ドロップの細かな制御、特殊なコントロール 1 つのためにラップした NSView などです。

デバッグ、テスト、リリース準備

実行時の動作を確認するには、ウィンドウを開く処理、サイドバーの選択、メニューコマンド、バックグラウンド同期の周辺に Logger イベントをいくつか追加するよう Codex に依頼し、アプリ起動後に log stream でそれらのイベントを検証します。

テストが失敗した場合は、まず問題の切り分けに必要な最小範囲で xcodebuild test または swift test を Codex に実行させ、問題がコンパイルエラー、アサーション失敗、クラッシュ、テストの不安定性、環境／セットアップの問題のいずれに起因するかを分類させます。

ローカルでの反復作業から配布へ移行するときは、Xcode での手動アーカイブ手順と、繰り返しリリースできるスクリプトベースのアーカイブ・公証手順の両方を用意するよう Codex に依頼します。codesign と plutil でアプリバンドル、エンタイトルメント、Hardened Runtime を検査させ、アップロードもターミナル内で完結させたい場合は App Store Connect CLI を使用します。

プロンプト例

実践的なヒント

シーンの明示的な定義

アプリ全体を 1 つの巨大なビューに押し込むのではなく、メインウィンドウ、設定ウィンドウ、ユーティリティウィンドウ、メニューバーの追加項目をそれぞれ独立したシーンルートとしてモデル化します。

システム標準 UI の活用

カスタムのサイドバー、ツールバー、マテリアルを作成する前に、標準の SwiftUI シーン API とウィンドウ API で目的の Mac 動作をすでに実現できるか確認します。

AppKit 連携の最小化

不足しているデスクトップ機能 1 つを補うために、NSViewRepresentable、NSViewControllerRepresentable、または対象を絞った NSWindow ヘルパーを使用します。ただし、選択状態とアプリ状態の情報源は SwiftUI に一本化します。

ローカルビルドと分けた署名・公証の検証

ローカルで正常に起動できても、アプリが署名済みで、公証の準備も整っていることの証明にはなりません。単発のリリース確認用に Xcode の手動アーカイブフローを維持し、再現可能な配布用にスクリプト化したアーカイブ・公証フローを追加します。ローカルでの反復作業だけでなくリリースが目的のタスクでは、codesign と plutil によるチェックも実行します。