Xcode 프로젝트 컴파일 오류 - CocoaPods 설치해서 문제해결(.xcworkspace)

Xcode 프로젝트 컴파일 오류 - CocoaPods 설치해서 문제해결(.xcworkspace)

Xcode 프로젝트 컴파일 오류와 Workspace 파일

Xcode에서 프로젝트를 빌드할때 컴파일 오류가 발생합니다. 프로젝트에서 라이브러리 및 종속성 관리가 필요한경우 macOS에 패키지 관리도구인 CocoaPods이 설치되어있어야합니다. macOS에 CocoaPods이 설치되어있는 경우 유니티(Unity)에서 iOS 프로젝트를 빌드하면 생성한 Xcode 프로젝트에 Workspace 파일(.xcworkspace)과 Pods폴더를 포함합니다. 

 

CocoaPods이 설치되어있지않은 macOS 또는 윈도우(Window) - 유니티에서 iOS 프로젝트를 빌드하면 생성한 Xcode 프로젝트에  Workspace 파일(.xcworkspace)과 Pods폴더가 포함되지않습니다. .xcodeproj를 사용하여 Xcode 프로젝트를 열기 및 빌드를 진행하면 오류가 발생합니다(외부 라이브러리 관리 필요한 경우)

.xcworkspace와 .xcodeproj

.xcworkspace - 여러 프로젝트 또는 외부 라이브러리 관리 목적, CocoaPods 사용 시 자동 생성

.xcodeproj - 단일 프로젝트일 경우 사용 가능, Xcode 프로젝트 생성 시 기본 생성

CocoaPods(코코아팟)

iOS 및 macOS 프로젝트에서 라이브러리 및 종속성을 관리하기 위한 패키지 관리 도구입니다. Objective-C 및 Swift 언어로 작성된 프로젝트에 외부 라이브러리 및 프레임워크를 쉽게 통합하고 관리할 수 있도록 도와줍니다.
CocoaPods는 macOS 운영 체제에서 사용할 수 있습니다. 일반적으로 CocoaPods를 사용하여 iOS 또는 macOS 프로젝트를 관리하려면 Mac에 CocoaPods를 설치해야 합니다. 일반적으로 CocoaPods는 Ruby 패키지 관리 도구인 RubyGems를 통해 설치되며 대부분의 경우 터미널을 사용하여 설치를 진행할수있습니다.

 

 

문제해결

일반적으로 유니티(macOS)에서 CocoaPods 설치를 진행할수있으며 빌드한 결과 Xcode 프로젝트에 Workspace파일이 포함됩니다. 만약 유니티에서 CocoaPods 설치를 실패하면 터미널을 사용하여 CocoaPods를 설치해야합니다. CocoaPods 설치를 완료하면 유니티에서 생성한 Xcode 프로젝트에 Workspace 파일이 포함합됩니다. 

Xcode에서  workspace 파일을 열기하고 정상적으로 빌드를 진행할수있습니다.

 

- 유니티에서 빌드 및 생성한 Xcode 프로젝트에 Workspace pods 파일이 포함되어야함
- macOS에 CocoaPods이 설치되어있어야 유니티에서 Xcode 프로젝트를 생성할때 Workspace pods 파일이 포함됨
- 일반적으로 유니티에서 CocoaPods 설치를 진행할수있으며 Xcode 프로젝트에 Workspace pods 파일이 포함됨
- 유니티에서 CocoaPods 설치를 실패하는 경우가 있음(drb와 ruby 버전 호환성, ruby 버전 업데이트, 기타)

- macOS에 CocoaPods를 설치해야함(터미널을 사용하여 설치)

- CocoaPods 설치완료 이후에 유니티에서 iOS 프로젝트 빌드 오류가 발생하는 경우 환경변수 설정이 필요함

- 유니티에서 iOS 프로젝트를 정상적으로 빌드하면 Xcode 프로젝트에 Workspace pods 파일이 포함됨

- Xcode에서 프로젝트를 정상적으로 빌드할수있음