【Xcode】CFBundleExecutableエラーの原因と完全な修正手順

はじめに (対象読者・この記事でわかること)

この記事は、SwiftでiOSアプリ開発を始めたばかりの方や、Xcodeでビルドエラーに遭遇して困っている開発者の方を対象にしています。特に、CFBundleExecutableに関するエラーで詰まっている方に最適です。

この記事を読むことで、CFBundleExecutableエラーの正確な意味と、それを解消するための具体的な手順が理解できます。また、Info.plistの正しい設定方法や、ビルド設定との関係性についても学ぶことができます。実際のプロジェクトでのトラブルシューティングの参考になるでしょう。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Swiftの基本的な文法の知識 - Xcodeの基本的な使い方（プロジェクトの作成、ビルド方法） - iOSアプリ開発の基礎知識

CFBundleExecutableエラーとは

CFBundleExecutableエラーは、Xcodeでアプリをビルドした際に、Info.plistファイル内のCFBundleExecutableキーに設定された実行ファイルが見つからない場合に発生します。このエラーは主に以下のような状況で発生します：

新規プロジェクト作成時に自動生成される設定に不整合がある
ターゲット名やプロダクト名を変更した後
複数のターゲットを持つプロジェクトで設定をミスした場合

CFBundleExecutableは、アプリケーションバンドル内の実行可能ファイルの名前を指定する重要なキーです。この値が正しく設定されていないと、App Storeへの審査提出時にも問題が発生する可能性があります。

エラーの具体的な修正手順

ここでは、実際にCFBundleExecutableエラーを解消するための詳細な手順を説明します。エラーメッセージの内容によって、対応方法が異なる場合があるため、いくつかのパターンを用意しました。

ステップ1：エラーメッセージの確認と問題の特定

まず、Xcodeのビルドログを確認して、エラーメッセージの詳細を把握します。

Error Domain=NSCocoaErrorDomain Code=4 "The file doesn't exist."
UserInfo={
    NSFilePath=/path/to/app.app/ExecutableName,
    NSUnderlyingError=0x7f8e8e400000 {
        Error Domain=NSPOSIXErrorDomain Code=2 "No such file or directory"
    }
}

このエラーが出た場合、以下の項目を確認します：

Info.plistの確認 - Project NavigatorからInfo.plistを開きます - CFBundleExecutableキーの値を確認します - 通常、この値は$(EXECUTABLE_NAME)という変数になっています
ビルド設定の確認 - ターゲットを選択してBuild Settingsタブを開きます - Packagingセクションを探します - Product NameとExecutable Nameの設定を確認します

ステップ2：Info.plistの修正方法

Info.plistの修正には、以下の2つの方法があります：

方法1：直接編集する場合

Xml

<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>

方法2：XcodeのGUIで編集する場合

Project NavigatorでInfo.plistを選択
Information Property Listを展開
Executable file項目を探して、値を$(EXECUTABLE_NAME)に設定

ステップ3：ビルド設定の整合性確認

Info.plistの設定を正しくしても、ビルド設定が不整合だとエラーが解消されません：

Bash

# ターミナルからプロジェクトルートで実行
xcodebuild -target YourTargetName -showBuildSettings | grep -E "(PRODUCT_NAME|EXECUTABLE_NAME)"

出力例：

PRODUCT_NAME = MyGreatApp
EXECUTABLE_NAME = MyGreatApp

もしPRODUCT_NAMEとEXECUTABLE_NAMEが異なる場合、以下のように修正します：

ターゲットのBuild Settingsを開く
Product Nameを確認
Packaging→Executable Nameが未設定の場合、$(PRODUCT_NAME)を設定

ハマった点やエラー解決

実際の開発現場でよくある落とし穴をいくつか紹介します：

パターン1：複数ターゲットの混乱 複数のターゲットを持つプロジェクトでは、各ターゲットの設定が独立しているため、1つのターゲットを修正しても他のターゲットのエラーが解消されないことがあります。

パターン2：スキームの設定ミス ビルドスキームで異なるターゲットが選択されている場合、意図しないターゲットの設定が適用されることがあります。

パターン3：キャッシュの問題 Xcodeはビルド成果物をキャッシュしており、設定を正しく修正しても古いキャッシュが使われることがあります。

解決策

上記の問題に対する具体的な解決策です：

複数ターゲントの場合：

Bash

# 各ターゲットの設定を一括確認
for target in $(xcodebuild -list | grep -A 100 "Targets:" | grep -v "Targets:" | grep -v "^$"); do
    echo "=== Target: $target ==="
    xcodebuild -target "$target" -showBuildSettings | grep -E "(PRODUCT_NAME|INFOPLIST_FILE)"
done

キャッシュクリア： 1. Product → Clean Build Folder（Shift+Cmd+K） 2. ~/Library/Developer/Xcode/DerivedDataから該当プロジェクトのフォルダを削除 3. Xcodeを再起動

最終手段：

Bash

# プロジェクトファイルのバックアップを取ってから
cp -r YourProject.xcodeproj YourProject.xcodeproj.backup

# プロジェクトファイルを再生成
# - プロジェクトを一度閉じる
# - .xcodeprojファイルを削除（ソースコードは残す）
# - フォルダから.xcodeprojを再作成

まとめ

本記事では、XcodeでSwiftプロジェクトをビルドした際に発生するCFBundleExecutableエラーの原因と解決方法について解説しました。

CFBundleExecutableエラーは、Info.plistとビルド設定の不整合が原因
正しい設定はCFBundleExecutable = $(EXECUTABLE_NAME)
複数ターゲットの場合は各ターゲットごとに設定を確認
エラーが解消しない場合はキャッシュクリアが有効

この記事を通して、Xcodeのビルドエラーに対するトラブルシューティングの基本的な考え方と、具体的な解決手順が身についたでしょう。今後は、より複雑なビルド設定や、CI/CD環境でのエラー対処についても記事にする予定です。

【Xcode】CFBundleExecutableエラーの原因と完全な修正手順🍎