PC パソコン

Xcode「Info.plist file not found」の原因と解決方法

XcodeでiOS・macOSなどのAppをBuildした際に、Info.plistに関係する次のようなErrorが表示されることがあります。

Info.plist file not found

またはBuild Logに:

Build input file cannot be found: '/path/to/Info.plist'

のようなMessageが表示されることもあります。

このErrorは、TargetのBuild Settingsで指定されているInfo.plistのPathと実際のFile配置が一致していない、Info.plistを削除・移動・Renameした、Build Configurationごとに異なるPathを指定しているなどの場合に発生します。

一方、現在のXcodeではInfo.plistの実FileをProjectへ置かず、Build時にInfo.plistを生成する構成もあります。そのため、「Project NavigatorにInfo.plistが見当たらない=異常」とは限りません。

最初にTargetの「Generate Info.plist File」と「Info.plist File」の設定を確認し、実Fileを使用する構成なのか、自動生成する構成なのかを切り分けることが重要です。

  1. 「Info.plist file not found」とは
  2. 代表的なError Message
  3. まず確認すること
    1. 1. Generate Info.plist Fileを確認する
    2. 2. Info.plist FileのPathを確認する
  4. 主な原因
    1. 1. Info.plistを削除した
    2. 2. Info.plistをRenameした
    3. 3. Info.plistを別Folderへ移動した
    4. 4. FinderでFileを移動した
    5. 5. INFOPLIST_FILEに絶対Pathを設定している
    6. 6. Project Nameを変更した
    7. 7. Targetを追加・Duplicateした
    8. 8. DebugとReleaseで設定が違う
    9. 9. .xcconfigに古いPathが残っている
    10. 10. Environment VariableやUser-defined Settingが間違っている
    11. 11. GitにInfo.plistが含まれていない
    12. 12. .gitignoreで除外している
    13. 13. Build ScriptがInfo.plistを生成する前提になっている
    14. 14. ScriptのOutput Pathが変わった
    15. 15. File Referenceだけ残って実Fileがない
    16. 16. Project Navigator上のReferenceが赤い
    17. 17. Case-sensitive File Systemで大文字・小文字が違う
    18. 18. 複数Targetで同じ設定を誤って共有している
    19. 19. Generate Info.plist FileをNOへ変更した
    20. 20. 自動生成構成なのに古いINFOPLIST_FILE設定が残っている
  5. 解決方法1:INFOPLIST_FILEのPathを修正する
  6. 解決方法2:Project-relative Pathを使用する
  7. 解決方法3:Fileを元の場所へ戻す
  8. 解決方法4:Rename後のFile名をBuild Settingsへ反映する
  9. 解決方法5:自動生成方式へ戻す
  10. 解決方法6:実Info.plistを作成する
  11. 解決方法7:GitからInfo.plistを復元する
  12. 解決方法8:File System上に本当に存在するか確認する
  13. 解決方法9:findでInfo.plistを検索する
  14. 解決方法10:Build Settingの実際の値を確認する
  15. 解決方法11:DebugとReleaseをそれぞれ確認する
  16. 解決方法12:Archiveだけ失敗する場合はRelease設定を見る
  17. 解決方法13:.xcconfigを確認する
  18. 解決方法14:project.pbxprojに残った古いPathを確認する
  19. 解決方法15:Targetごとの設定を確認する
  20. 解決方法16:Project Navigatorの赤いReferenceを修正する
  21. 解決方法17:Target Membershipだけを原因と思い込まない
  22. 解決方法18:Copy Bundle Resourcesを確認する
  23. 解決方法19:Build Script生成の場合はScript Phaseを確認する
  24. 解決方法20:Scriptを手動実行して確認する
  25. 解決方法21:CI環境だけ失敗する場合はRepositoryを確認する
  26. 解決方法22:.gitignoreを確認する
  27. 解決方法23:File名の大文字・小文字を確認する
  28. 解決方法24:Environment Variableを展開して確認する
  29. 解決方法25:Build Logから実際に参照したPathを確認する
  30. Generate Info.plist FileがYESなのにInfo.plistが見当たらない場合
  31. Generate Info.plist FileがNOの場合
  32. Info.plistを新しく作れば直るのか
  33. 複数のInfo.plistがある場合
  34. Debugでは成功してReleaseで失敗する場合
  35. Archive時だけ失敗する場合
  36. CIでだけ失敗する場合
  37. Build SettingをCommand Lineで確認する例
  38. Clean Build Folderで直るか
  39. DerivedData削除は必要か
  40. やってはいけない対処
  41. 最短で確認するチェックリスト
  42. まとめ

「Info.plist file not found」とは

Info.plistはApp Bundleに含まれるProperty Listで、Bundle Identifier、Version、対応する機能、Privacy関連設定など、AppのMetadataを保持します。

Xcodeが実Fileを入力として使用する構成では、Build Settingsで指定されたPathからInfo.plistを読み込みます。

例えば:

$(SRCROOT)/MyApp/Info.plist

を参照する設定になっているのに、その場所にFileが存在しなければBuildできません。

代表的なError Message

Info.plist file not found

Build input file cannot be found: '/Users/example/MyProject/MyApp/Info.plist'

error: Build input file cannot be found: '.../Info.plist'. Did you forget to declare this file as an output of a script phase or custom build rule which produces it?

実際のMessageはXcode VersionやBuild処理によって多少異なりますが、基本的には「設定されたPathに必要なInfo.plistがない」という意味です。

まず確認すること

1. Generate Info.plist Fileを確認する

Xcodeで:

Project → Target → Build Settings → Generate Info.plist File

を確認します。

Build Setting名では:

GENERATE_INFOPLIST_FILE

です。

YESの場合は、XcodeがBuild時にInfo.plistを生成する構成になっている可能性があります。

2. Info.plist FileのPathを確認する

同じBuild Settings内で:

Info.plist File

を検索します。

Build Setting名では:

INFOPLIST_FILE

です。

例えば:

MyApp/Info.plist

と設定されていれば、そのPathにFileが存在するか確認します。

重要:Generate Info.plist FileがYESなのか、実際のInfo.plist Fileを参照する構成なのかを最初に確認してください。両方を混同すると、不要なInfo.plistを新規作成して別のErrorを増やすことがあります。

主な原因

1. Info.plistを削除した

Project整理中にInfo.plistを削除したものの、Build Settingsには以前のPathが残っているケースです。

2. Info.plistをRenameした

例えば:

Info.plist

から:

App-Info.plist

へ変更したにもかかわらず、INFOPLIST_FILEが古いFile名を参照している場合です。

3. Info.plistを別Folderへ移動した

例えば以前:

MyApp/Info.plist

だったFileを:

MyApp/Resources/Info.plist

へ移動すると、Build Settingも更新する必要があります。

4. FinderでFileを移動した

Xcode外でFolder構成を変更すると、Project設定と実File SystemのPathがずれることがあります。

5. INFOPLIST_FILEに絶対Pathを設定している

/Users/username/Desktop/MyApp/Info.plist

のような絶対Pathは、Project移動や別MacでBuildした際に壊れやすくなります。

6. Project Nameを変更した

ProjectやFolder Nameを変更した際に:

OldApp/Info.plist

という古いPathが残っていることがあります。

7. Targetを追加・Duplicateした

既存TargetをDuplicateすると、元Target用のInfo.plist Pathをそのまま参照する場合があります。

8. DebugとReleaseで設定が違う

DebugではBuildできるのにArchiveで失敗する場合、Build ConfigurationごとのINFOPLIST_FILEを確認してください。

9. .xcconfigに古いPathが残っている

Build Settings画面では気付きにくい場合でも、Configuration Fileに:

INFOPLIST_FILE = MyApp/Info.plist

のような設定が残っている場合があります。

10. Environment VariableやUser-defined Settingが間違っている

例えば:

INFOPLIST_FILE = $(APP_CONFIG_PATH)/Info.plist

としている場合、APP_CONFIG_PATHが正しく展開されているか確認します。

11. GitにInfo.plistが含まれていない

別MacやCI環境だけBuildに失敗する場合、必要なInfo.plistがGitへCommitされていない可能性があります。

12. .gitignoreで除外している

誤った.gitignore設定によってInfo.plistがRepositoryへ追加されていないことがあります。

13. Build ScriptがInfo.plistを生成する前提になっている

ScriptでInfo.plistを生成する構成の場合、Scriptが失敗すると後続Build StepからFileが見つかりません。

14. ScriptのOutput Pathが変わった

生成先とINFOPLIST_FILEの参照先が一致しているか確認します。

15. File Referenceだけ残って実Fileがない

Project NavigatorにInfo.plistが表示されていても、実体が移動・削除されている場合があります。

16. Project Navigator上のReferenceが赤い

赤いFile Referenceは、Xcodeがその場所にFileを見つけられない状態を示している場合があります。

17. Case-sensitive File Systemで大文字・小文字が違う

例えば:

Info.plist

と:

info.plist

はCase-sensitive環境では別Fileです。

18. 複数Targetで同じ設定を誤って共有している

App、Widget、Notification Service Extensionなどは、それぞれ異なるMetadata設定を持つ場合があります。

19. Generate Info.plist FileをNOへ変更した

それまで自動生成していたTargetで:

GENERATE_INFOPLIST_FILE = NO

へ変更したにもかかわらず、実Info.plistを用意していない場合に問題になります。

20. 自動生成構成なのに古いINFOPLIST_FILE設定が残っている

ProjectをMigrationした後などに、現在は不要な古いPath設定が残っている場合があります。

解決方法1:INFOPLIST_FILEのPathを修正する

Xcodeで:

Target → Build Settings → Info.plist File

を開きます。

実Fileが:

MyApp/Resources/Info.plist

にあるなら:

INFOPLIST_FILE = MyApp/Resources/Info.plist

となるよう修正します。

解決方法2:Project-relative Pathを使用する

可能であれば、特定ユーザーのHome Directoryを含む絶対PathではなくProject-relativeなPathを使用します。

例えば:

MyApp/Info.plist

のような設定にします。

解決方法3:Fileを元の場所へ戻す

Build Settingsを変更したくない場合は、Info.plistをINFOPLIST_FILEが指定する元のFolderへ戻します。

解決方法4:Rename後のFile名をBuild Settingsへ反映する

例えばFileを:

App-Info.plist

へRenameした場合:

INFOPLIST_FILE = MyApp/App-Info.plist

のように更新します。

解決方法5:自動生成方式へ戻す

TargetがXcodeによるInfo.plist生成を利用する設計なら:

GENERATE_INFOPLIST_FILE = YES

になっているか確認します。

必要なKeyはTarget設定やBuild SettingsのInfo.plist関連項目から設定します。

注意:既存Projectを理由なく自動生成方式へ変更する必要はありません。現在のProjectが実File方式なのか生成方式なのかを確認したうえで、設定を統一してください。

解決方法6:実Info.plistを作成する

Generate Info.plist Fileを使用しない構成で、Info.plistを本当に削除してしまった場合は新しいProperty Listを作成できます。

Xcodeで:

File → New → File

からProperty Listを作成し、Targetで必要なInfo.plistとして指定します。

ただし、必要なKeyを既存ProjectやVersion Controlから復元できる場合は、新規作成より復元する方が安全です。

解決方法7:GitからInfo.plistを復元する

誤って削除した場合、Git管理されていれば復元できます。

git status

削除状態を確認したうえで、例えば:

git restore MyApp/Info.plist

で復元できます。

注意:git restoreは未Commitの変更を失う可能性があります。対象Fileに必要な変更が残っていないか確認してから実行してください。

解決方法8:File System上に本当に存在するか確認する

Terminalで:

ls -l MyApp/Info.plist

を実行します。

存在しなければ:

ls -la MyApp

などで実際のFile名や配置を確認します。

解決方法9:findでInfo.plistを検索する

Project内の場所が分からない場合:

find . -name "Info.plist" -print

で検索できます。

Case違いも疑う場合:

find . -iname "info.plist" -print

解決方法10:Build Settingの実際の値を確認する

Command Lineから:

xcodebuild -showBuildSettings

を使ってBuild Settingsを確認できます。

Info.plist関連だけを見る例:

xcodebuild -showBuildSettings | grep -E "INFOPLIST_FILE|GENERATE_INFOPLIST_FILE"

WorkspaceやSchemeを指定するProjectでは、実際に使用しているWorkspace・Scheme・Configurationを指定して確認してください。

解決方法11:DebugとReleaseをそれぞれ確認する

Build Settings画面を:

Levels

表示にすると、Project、Target、Configurationなど、どのLevelから値が設定されているか確認しやすくなります。

DebugだけではなくReleaseのINFOPLIST_FILEも確認してください。

解決方法12:Archiveだけ失敗する場合はRelease設定を見る

通常Buildが成功してArchiveだけ失敗する場合は:

Product → Scheme → Edit Scheme → Archive

で使用Configurationを確認し、そのConfigurationのInfo.plist設定を調べます。

解決方法13:.xcconfigを確認する

ProjectでConfiguration Fileを使っている場合:

INFOPLIST_FILE = MyApp/Info.plist

のような古い設定がないか検索します。

Terminalなら:

grep -R "INFOPLIST_FILE" .

でProject内を検索できます。

解決方法14:project.pbxprojに残った古いPathを確認する

通常はXcode UIから修正する方が安全ですが、原因調査として:

grep -R "INFOPLIST_FILE" *.xcodeproj/project.pbxproj

などで設定を確認できます。

注意:project.pbxprojを手作業で編集するとProjectを破損する可能性があります。確認目的で利用し、通常の修正はXcodeのBuild Settingsから行う方が安全です。

解決方法15:Targetごとの設定を確認する

App本体のほかに:

  • Widget Extension
  • Share Extension
  • Notification Service Extension
  • Tests
  • UI Tests

などがある場合、ErrorがどのTargetから出ているか確認します。

App Targetの設定が正しくても、Extension Targetだけ古いPathを参照している場合があります。

解決方法16:Project Navigatorの赤いReferenceを修正する

Info.plistが赤く表示されている場合、一度Referenceを確認します。

Fileが別の場所へ移動しているなら、正しいFileをProjectへ追加し直すかBuild SettingsのPathを修正してください。

解決方法17:Target Membershipだけを原因と思い込まない

Info.plistは通常のSwift Source FileやResourceと同じ扱いとは限りません。

重要なのはBuild SettingsがどのInfo.plistを入力として指定しているかです。

「Target MembershipへCheckを入れれば必ず直る」とは限りません。

解決方法18:Copy Bundle Resourcesを確認する

Info.plistを手動でCopy Bundle Resourcesへ追加する必要は通常ありません。

Targetの:

Build Phases → Copy Bundle Resources

にInfo.plistを追加して解決しようとすると、別のInfo.plist関連WarningやBundle構成の問題につながる可能性があります。

注意:Info.plist file not foundは基本的にINFOPLIST_FILEや生成設定の問題として確認してください。単純にCopy Bundle Resourcesへ追加する対処は推奨されません。

解決方法19:Build Script生成の場合はScript Phaseを確認する

Info.plistをScriptで生成している特殊な構成では:

Target → Build Phases

からScript Phaseを確認します。

生成Commandが失敗していないか、生成先PathがINFOPLIST_FILEと一致しているか確認します。

解決方法20:Scriptを手動実行して確認する

例えばScriptが:

./Scripts/generate-info-plist.sh

ならTerminalから実行し、Expected PathへFileが作成されるか確認できます。

解決方法21:CI環境だけ失敗する場合はRepositoryを確認する

Local Macでは存在するInfo.plistがGit管理されていない場合、CIではFileがありません。

確認:

git ls-files | grep -i "info.plist"

必要なFileが表示されない場合、Repository管理状況を確認してください。

解決方法22:.gitignoreを確認する

git check-ignore -v MyApp/Info.plist

これでInfo.plistがどのIgnore Ruleに一致しているか確認できます。

解決方法23:File名の大文字・小文字を確認する

Repository上で:

Info.plist

なのか:

info.plist

なのか確認します。

Localでは動いてCIで失敗する場合、File SystemのCase Sensitivity差が原因になることがあります。

解決方法24:Environment Variableを展開して確認する

例えば:

INFOPLIST_FILE = $(CONFIGURATION_DIR)/Info.plist

のような設定なら、CONFIGURATION_DIRが期待どおりの値になっているかBuild Settingsで確認します。

解決方法25:Build Logから実際に参照したPathを確認する

XcodeのReport Navigatorで失敗したBuildを開き:

ProcessInfoPlistFile

や:

Info.plist

を検索します。

Compilerが実際にどのPathを参照しているか確認してください。

Generate Info.plist FileがYESなのにInfo.plistが見当たらない場合

これは必ずしも問題ではありません。

XcodeがBuild時にInfo.plistを生成するTargetでは、Project Navigator上に従来のInfo.plist Fileが存在しないことがあります。

この場合は、必要なMetadataをTarget設定やBuild Settingsで管理します。

例えばBuild Settingとして:

GENERATE_INFOPLIST_FILE = YES

になっているか確認してください。

従来型Projectの記事を参考にして、存在しないInfo.plistを無理に探す必要はありません。

Generate Info.plist FileがNOの場合

自動生成しない構成なら、通常はINFOPLIST_FILEで指定した入力Fileが必要です。

例えば:

GENERATE_INFOPLIST_FILE = NO INFOPLIST_FILE = MyApp/Info.plist

なら:

MyApp/Info.plist

が実際に存在するか確認します。

Info.plistを新しく作れば直るのか

場合によります。

本当に実Fileを使うProjectでFileを誤って削除した場合は、復元または再作成で解決できます。

しかし、Xcodeの自動生成方式を使うTargetなら、新しいInfo.plistを作る必要がない場合があります。

また、適当な空Info.plistを作ると、Privacy Key、URL Scheme、Document Type、Scene設定など、以前の設定が失われる可能性があります。

重要:可能ならVersion Controlから元のInfo.plistを復元してください。内容を確認せず空のProperty Listへ置き換えるのは避けてください。

複数のInfo.plistがある場合

Project内に:

MyApp/Info.plist Widget/Info.plist ShareExtension/Info.plist

など複数Fileが存在することがあります。

Errorが出ているTargetを確認し、そのTargetのINFOPLIST_FILEが正しいFileを参照しているか確認します。

Debugでは成功してReleaseで失敗する場合

Configurationごとの値を確認します。

例えば:

Debug: MyApp/Info-Debug.plist

Release:
MyApp/Info-Release.plist

という構成なら、Release用Fileだけ存在しない可能性があります。

Archive時だけ失敗する場合

ArchiveがRelease Configurationを使用しているProjectでは、通常Buildと違うINFOPLIST_FILEが使われることがあります。

次を確認します。

  1. SchemeのArchive Configuration
  2. ReleaseのINFOPLIST_FILE
  3. Release用.xcconfig
  4. CIやArchive用Environment Variable

CIでだけ失敗する場合

次を確認してください。

  • Info.plistがGitにCommitされているか
  • .gitignoreで除外されていないか
  • Case-sensitiveなFile名が一致しているか
  • Secret生成Scriptが実行されているか
  • Environment Variableが設定されているか
  • Build ConfigurationがLocalと同じか

Build SettingをCommand Lineで確認する例

Projectの場合:

xcodebuild \ -project MyApp.xcodeproj \ -scheme MyApp \ -showBuildSettings | grep -E "INFOPLIST_FILE|GENERATE_INFOPLIST_FILE"

Workspaceの場合:

xcodebuild \ -workspace MyApp.xcworkspace \ -scheme MyApp \ -showBuildSettings | grep -E "INFOPLIST_FILE|GENERATE_INFOPLIST_FILE"

Releaseを確認する場合:

xcodebuild \ -project MyApp.xcodeproj \ -scheme MyApp \ -configuration Release \ -showBuildSettings | grep -E "INFOPLIST_FILE|GENERATE_INFOPLIST_FILE"

Clean Build Folderで直るか

Info.plistのPathが本当に間違っている場合、Clean Build Folderだけでは直りません。

補助的に:

Product → Clean Build Folder

を実行できますが、まずINFOPLIST_FILEとFileの存在を確認してください。

DerivedData削除は必要か

設定を修正した後も古いBuild Artifactの影響が疑われる場合は:

rm -rf ~/Library/Developer/Xcode/DerivedData/*

を補助的に試すことができます。

ただし:

INFOPLIST_FILE = MyApp/Info.plist

なのにFile自体が存在しない場合、DerivedDataを削除しても解決しません。

やってはいけない対処

原因を確認せず、空のInfo.plistを適当な場所へ作成するのは避けてください。

それによってBuild Errorだけは変わっても、既存のApp MetadataやPrivacy設定が失われる可能性があります。

また、Info.plistをCopy Bundle Resourcesへ追加するだけでは、INFOPLIST_FILEの入力Path問題を正しく解決できません。

最初に「実File方式なのか、自動生成方式なのか」「XcodeがどのPathを参照しているのか」を確認してください。

最短で確認するチェックリスト

  1. Errorが出ているTargetを確認する
  2. Generate Info.plist Fileを確認する
  3. INFOPLIST_FILEを確認する
  4. 指定PathにFileが存在するか確認する
  5. Info.plistを移動・Renameしていないか確認する
  6. DebugとReleaseの値を比較する
  7. Archive Configurationを確認する
  8. .xcconfig内のINFOPLIST_FILEを確認する
  9. Project Navigatorで赤いReferenceがないか確認する
  10. GitにInfo.plistが含まれているか確認する
  11. .gitignoreを確認する
  12. File名の大文字・小文字を確認する
  13. 複数TargetのInfo.plistを取り違えていないか確認する
  14. Script生成の場合は生成先を確認する
  15. 必要に応じてxcodebuild -showBuildSettingsで実値を確認する

まとめ

Xcodeの「Info.plist file not found」は、主にTargetが参照しているInfo.plistのPathと、実際のFile配置が一致していない場合に発生します。

代表的な原因は、Info.plistの削除、Rename、Folder移動、古いINFOPLIST_FILE、DebugとReleaseの設定差、.xcconfig、Gitへの追加漏れ、Build Scriptの失敗などです。

まずTargetの「Generate Info.plist File」と「Info.plist File」を確認してください。

実Fileを使用する構成ならINFOPLIST_FILEが指す場所にFileが存在する必要があります。自動生成方式ならProject NavigatorにInfo.plistが存在しなくても正常な場合があります。

Archiveだけ失敗する場合はRelease Configuration、CIだけ失敗する場合はGit管理・File名・Environment Variableも確認してください。

Clean Build FolderやDerivedData削除は補助策にすぎません。最も重要なのは、Xcodeが実際にどのInfo.plistを使用しようとしているかを確認し、Build SettingsとFile配置を一致させることです。