從 GitHub 下載的 Demo 專案常使用 CocoaPods 管理相依套件。若 Podfile、Podfile.lock 與目前工作區狀態不一致,就可能出現 The sandbox is not in sync with the Podfile.lock 的錯誤。
這個錯誤通常代表 CocoaPods 產生的 workspace 與 Podfile.lock 之間沒有同步。常見原因包括缺少 Podfile.lock、Manifest.lock 不一致,或套件版本已變動但尚未重新安裝。
可以先關閉 Xcode 工作區,刪除既有的 xcworkspace,再重新執行 pod install。完成後,使用新的 workspace 開啟專案,再進行 clean 與 build。
常用指令如下:
rm -rf MyProject.xcworkspace
pod install
若之前沒有初始化 CocoaPods 設定,也應先確認已執行 pod setup。重新安裝後,Pod 會依 Podfile 重新產生一致的 workspace 與 lock 狀態。