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