에러: Unable to open base configuration reference file

Unable to open base configuration reference file ‘/Users/[USER]/Desktop/[PROJECT-DIR]/Pods/Target Support Files/Pods-[PROJECT]/Pods-[PROJECT].debug.xcconfig’.

 

Xcode에서 클론한 프로젝트를 열어서 빌드를 시도했을때 발생한 에러이다.

Xcode를 처음 써보는 것이기 때문에 추가적인 개발도구에 대해서는 몰랐었다.

 

해당 프로젝트는 CocoaPods이라는 Swift 및 Objective-C 코코아 프로젝트의 종속성 관리자를 사용하고 있었고, 다른 파일로 프로젝트를 열고, 커맨드에서 특정한 명령어를 사전 설정해야하는 것을 알게되었다.

 

 

해당글은 Mac OS 기준으로 작성되었다.

 

1. 커맨드 + 스페이스를 통해 검색창을 띄우고, Terminal(터미널)을 열고 아래의 명령어를 입력한다.

$ sudo gem install cocoapods

 

 

이때, 에러나 다른 이유로 설치가 안될 가능성이 존재한다.

이 경우, Homebrew를 설치한다.

 

https://brew.sh/

Homebrew

 

Homebrew란, 자유-오픈 소스 소프트웨어 패키지 관리 시스템이다.

설치방법은 다음과 같다.

 

1. 터미널에서 다음 명령어를 붙여넣는다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

입력하고나면 Password를 입력하라고 나온다. 이때 본인이 사용하는 MacBook의 패스워드를 입력한다.

이후 설치가 완료되면, brew --version을 입력한다.

 

brew --version
zsh: command not found: brew

 

위와 같은 오류가 발생한다면, Homebrew 환경변수를 추가해야한다.

 

vi ~/.zshrc

// vi 편집기에 들어간 후,
export PATH=/opt/homebrew/bin:$PATH

 

를 입력하여 vi 편집기에 들어간 뒤, 다음 명령어를 입력한다.

ESC를 누르고, shift + ;를 누른뒤 wq!를 입력하여 저장하고 나온다.

 

이후, source ~/.zshrc를 입력하여 적용시킨뒤 다시 brew --version을 쳤을때 정상적으로 버전이 표시된다면 성공이다.

source ~/.zshrc

 

 

다시 cocoapods 설치로 넘어가자.

homebrew를 설치했기 때문에, brew로 설치하면된다.

다음 명령어를 터미널에 입력하면, 자동으로 설치된다.

brew install cocoapods

 

다른 오픈 소스 패키지(openssl, SwiftyJSON, ...)도 위와 같이 설치하면 될 것이다.

 

 

2. Project dir에서 pod install 실행하기

pod install

 

 

예를 들어, 다음과 같이 프로젝트 폴더가 바탕화면의 A 폴더 안의 A with iOS 폴더 안에 Project 폴더가 있다고 치자.

\Desktop\A\A with iOS

 

예) 윈도우에서 구현시

 

터미널에 cd Desktop\A\"A with iOS"\Project로 이동한 뒤,

Project 폴더(PodFile이 존재하는 곳)에서 위의 pod install 명령어를 실행하면 된다.

그럼 이미 설정된 PodFile대로 필요한 라이브러리르 알아서 Pods 폴더를 만들며 설치한다.