⛑️
XcodeでCocoaPodsの依存関係が正しく同期されない時のエラー対処法
Xcodeで実機にビルドする際によく失敗してしまうことがあるので、メモとして対処方法を記録します。
エラーメッセージの内容
ビルドする際に、以下のエラーによって失敗。
↑ 直訳すると「サンドボックスがPodfile.lockと同期していません。pod install'を実行するか、CocoaPodsのインストールを更新してください。」
このエラーは、CocoaPodsの依存関係が正しく同期されていないときに発生することがある。
対処方法
いくつか方法を試しましたが、以下の手順で対処するとうまくいきました。
①既存のPodfile.lockを一旦削除
Podfile.lockのファイル自体を削除
②iOSのディレクトリに移動
cd iOS
ターミナルでiOSの階層に移動するコマンドを実行。
③CocoaPodsのキャッシュをクリア
pod cache clean --all
ターミナルでCocoaPodsのキャッシュをクリアにするコマンドを実行。
④Podfile.lockを最新の状態に更新
pod install
Podfileに定義された依存関係をインストールし、Podfile.lockを最新の状態に更新するコマンドを実行。
上記①〜④ではエラーが解消されないことがあったため以下の手順を追加すると解消された。
⑤XcodeのDerived Dataを削除
rm -rf ~/Library/Developer/Xcode/DerivedData
Xcodeのビルドキャッシュと一時ファイル（Derived Data）を削除するためのコマンドを実行。
削除することで、Xcode がこれらのデータを再生成してくれるため、古いキャッシュが邪魔をしている場合はこのコマンドで解決する可能性あり。
⑤まで完了したら、Xcodeを再度立ち上げて再ビルド
他にもっと良い方法があれば是非教えていただきたいです！！
Discussion