Rork Max で SwiftUI ネイティブアプリを生成し、ダウンロードしてきたプロジェクトをいざ Xcode で開いてビルドすると、意外なところで赤いエラーが出て止まる — これは Rork を使い始めたばかりの方からよく聞く困りごとです。私自身、個人アプリを何本も Rork Max で生成して Xcode 経由で App Store に出してきた経験があり、典型的なエラーパターンと復旧手順はかなりはっきりしています。
ビルドエラーの厄介なところは、Xcode のエラーメッセージが長大で、本当に重要な情報が何十行もの警告の下に埋もれていることです。ここではRork Max 生成物特有の症状を軸に、「Xcode のどこを見ればいいか」「具体的にどう直すか」を手順として整理します。
ビルドエラーを読むときの基本姿勢
Xcode のエラー表示は、左ペインのナビゲーター（Report Navigator、三角警告マーク）で全体を確認できますが、ここに出ている赤いエラーの最初の 1 件 を直すのが鉄則です。2 件目以降は、1 件目のエラーがトリガーになって波及しているケースが多く、先頭を直すと自動的に消えることが多いです。
エラーの先頭を確認したら、そのエラーをクリックして詳細を右ペインに表示させ、該当ファイルの該当行を確認します。Rork Max が生成したコードそのものに構造的な問題があるケースは稀で、多くは「プロジェクト設定」「ビルド設定」「依存ライブラリ」のいずれかで起きています。
症状 1: Command SwiftCompile failed with nonzero exit code
これは最も汎用的なエラーで、ほぼ何が原因でも表示されます。このメッセージだけ見て直せるものはほとんどないので、ナビゲーターで「Build Log」を開き、より具体的なエラー行を探してください。
よくあるのは以下のパターンです。
パターン A: Swift バージョン不一致 Rork Max が Swift 6 系のコードを生成したが、Xcode のプロジェクト設定で Swift 5 指定になっています。Project Settings → Build Settings → Swift Language Version を確認し、6.0 以上に設定してください。
パターン B: iOS Deployment Target が低すぎる Rork Max は最新の iOS API を使ったコードを生成することがあります。Deployment Target が iOS 15 などに設定されていると、iOS 17 以降の API が使えずエラーになります。Deployment Target を iOS 17 または 18 に引き上げてください。
パターン C: 依存パッケージの未解決 Swift Package Manager で依存しているパッケージが解決されていないことがあります。File → Packages → Reset Package Caches を実行し、数秒待ってから再ビルドします。
症状 2: No such module 'XXX'
特定のモジュール（たとえば Combine、SwiftUI、外部ライブラリなど）が見つからないというエラーです。
もし SwiftUI / Combine のような標準モジュールが見つからない場合、プラットフォーム設定が意図通りになっていません。Target → General → Deployment Info で「iPhone」「iPad」にチェックが入っているか、Mac Catalyst が不要にチェックされていないかを確認してください。
外部ライブラリの場合、Package Dependencies に追加されていない、またはターゲットに紐付けられていないことが多いです。Target → General → Frameworks, Libraries, and Embedded Content にそのライブラリが表示されているかを確認します。
症状 3: Info.plist 関連のエラー
Rork Max は Info.plist を自動生成しますが、カメラ・マイク・位置情報など、権限が必要な機能を使うアプリでは、Usage Description の記述が不足することがあります。
NSCameraUsageDescriptionNSMicrophoneUsageDescriptionNSLocationWhenInUseUsageDescription
該当するキーを Info.plist に追加し、ユーザー向けの説明文（日本語でも OK）を記入してください。これらの記述がないと、実機でビルド・実行した瞬間にクラッシュします。App Store 審査でも、適切な説明がないと確実にリジェクトされます。
症状 4: Provisioning profile doesn't include the entitlement
Capabilities（Push Notifications、iCloud、Associated Domains など）を有効化しているのに、Provisioning Profile にその権限が含まれていない、というエラーです。
対処は以下の順序です。まず、Apple Developer のサイトにログインし、該当 App ID の Capabilities を確認・有効化します。次に、Provisioning Profile を再生成します。Xcode の Signing & Capabilities タブで、Team を一度別のものに切り替えてから戻すと、プロビジョニングプロファイルが自動的に更新されます。
Automatically manage signing が有効になっていれば、大抵はこれで解決します。手動管理をしている場合は、Apple Developer サイトで Profile を明示的に再発行してダウンロードする必要があります。
症状 5: Bundle Identifier 重複エラー
既に別アプリで使っている Bundle Identifier を、Rork Max で生成した新プロジェクトに使ってしまった場合のエラーです。
Bundle Identifier は App Store 全体でユニークである必要があり、一度使った ID は同じ Apple Developer アカウント内でも再利用できません。新しい一意な ID（逆ドメイン形式、例: net.dolice.myapp）を付け直してください。
症状 6: Signing requires a development team
Team が未設定の状態です。Xcode の Signing & Capabilities タブで、自分の Apple ID に紐付く Team を選択してください。個人開発者アカウントでも、無料の Apple ID でも、まずここにチームを設定しないとビルドできません。
症状 7: シミュレータでは動くが実機で動かない
これは「症状」として最も厄介です。原因は複数あり、順に切り分けます。
実機のロック状態: iPhone がロックされているとビルドできません。解除した状態にしてください。
実機が「信頼」されていない: 初めて接続する実機は、iPhone 側で「このコンピュータを信頼」を押す必要があります。設定 → 一般 → VPN とデバイス管理でデベロッパアプリを信頼する操作も必要な場合があります。
アーキテクチャの問題: Xcode 15 以降、Build Settings の Excluded Architectures を適切に設定していないと、M1/M2 Mac で実機向けビルドが失敗することがあります。Release 構成で arm64 が Excluded に入っていないかを確認してください。
症状 8: ビルドは通るがアプリが起動直後にクラッシュ
Xcode のビルドは成功するが、実行すると即座に終了する状態です。これはビルドエラーとは別カテゴリですが、混同されることが多いので触れておきます。
Xcode のコンソールに出る「why the app was terminated」のメッセージをまず読みます。Info.plist の Usage Description が不足しているケース（症状 3）が最多ですが、他にもメインスレッドで重い処理をしているウォッチドッグ起動、URL Scheme の設定ミスなどがあります。
復旧チェックリスト
Rork Max 生成物のビルドエラーに遭ったら、次の順序で確認するのが最短です。
- ナビゲーターの赤いエラーの最初の 1 件に集中する
- Swift Language Version が 6.0 以上になっているか
- Deployment Target が iOS 17 以上か
- Package Dependencies が正しく解決されているか
- Info.plist の Usage Description が必要なキーを全て含んでいるか
- Team と Signing が設定されているか
- Bundle Identifier が他と重複していないか
- Capabilities と Provisioning Profile が一致しているか
この 8 項目を押さえておけば、Rork Max で生成したプロジェクトを Xcode で初回ビルドするときの詰まりは、大半が解消できます。次にビルドエラーに出会ったときは、焦らず先頭のエラーだけに集中してみてください。