[iOS] CocoaPods - 명령어 및 에러 정리

🔑 코코아팟 명령어

---

# 작성한 Podfile을 통해 pod을 설정(추가,수정,삭제)해주는 명령어
$ pod install

• 해당 명령어를 실행한 후 .xcworkspace 파일이 생성됩니다. 해당 파일은 .xcodeproj의 모음입니다.
  • Xcode 프로젝트를 워크스페이스라는 하나의 작업공간으로 묶어놓은 단위입니다. 여러 Xcode 프로젝트의 의존성을 연결할 수 있는 방법입니다. 그래서 코코아팟을 통해 라이브러리를 가져오면 기존 프로젝트와 의존성을 맺어주기 위해 워크스페이스를 생성합니다. 처음에 생성한 프로젝트와 받아온 Pod들을 묶어서 하나의 워크스페이스로 구성하여 기존 프로젝트 이름과 동일한 이름의 워크스페이스를 생성합니다.

 

# 팟의 업데이트된 버전을 확인한 후 최신버전으로 업데이트 (Podfile.lock 참조하지 않습니다.)
$ pod update

# 모듈 하나에만 적용할 경우, pod update [모듈명] —no-repo-update
$ pod update {팟이름} -> 개별적인 pod에 대한 업데이트도 가능

# Podfile.lock에 작성되어있는 버전보다 새로운 버전을 가진 팟을 나열해주는 명령어
$ pod outdated

# /Users/{사용자이름}/.cocoapods/repos 경로에 있는 모든 podspec 파일을 업데이트 합니다.
$ pod repo update

# 개별적인 pod에 대한 업데이트도 가능
$ pod repo update {팟이름}

 

# 기존에 팟들 종속성 제거
$ pod deintegrate

 

🚨 코코아팟 에러

---

1. ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES 에러

[!] The `프로젝트명 [빌드configuration명]` target overrides the `ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES` build setting defined in `Pods/Target Support Files/Pods-PAPA/Pods-PAPA.stage.xcconfig'. This can lead to problems with the CocoaPods installation
    - Use the `$(inherited)` flag, or
    - Remove the build settings from the target.

• Build Settings → Build Options 의 Always Embed Swift Libraries를 $(inherited)로 변경합니다.

 

2. CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER 에러

[!] The `프로젝트명 [빌드configuration명]` target overrides the `CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER` build setting defined in `Pods/Target Support Files/Pods-CommonData/Pods-CommonData.debug.xcconfig'. This can lead to problems with the CocoaPods installation
    - Use the `$(inherited)` flag, or
    - Remove the build settings from the target.

 

• Build Settings → Build Options 의 Quoted Include In Framework Header를 $(inherited)로 변경합니다.

 

3. 코코아팟이나 서드파티라이브러리를 사용하는 경우 버전명시는 매우 중요

• 버전이 변경됨에 따라 다른 이슈가 발생할 수 있기 때문에 협업을 하는 경우 꼭 버전명시를 작성합니다.

 

4. 코코아팟 삭제 후 재설치

$ sudo gem install cocoapods-deintegrate cocoapods-clean

$ pod deintegrate 

$ pod clean

$ rm Podfile

• 참고링크 : https://medium.com/app-makers/how-to-remove-cocoapods-from-xcode-project-5166c19152

 

5. CocoaPod Refresh

$ pod cache clean --all
$ pod deintegrate
$ rm Podfile.lock

 

6. FireStore 빌드시간 기하급수적으로 증가된 이슈

• 🔗 FireStore - Github ReadMe.md 확인

pod 'FirebaseFirestore', :git => '<https://github.com/invertase/firestore-ios-sdk-frameworks.git>', :tag => '10.19.0'

 

참조 : CocoaPods binary cache (코코아팟 사용시 Xcode빌드시간 단축시키기)

간단히 Xcode에서 컴파일하기 전인 pod install 시점에 사전컴파일을 진행하여 Xcode 빌드시간을 단축시키는 방법입니다.

1. 사용자가 지정한 pod에 대해 사전 빌드를 수행해 바이너리 파일을 만들고, 이를 Pods 프로젝트에 연결하는 식으로 pods 빌드 시간을 없애줍니다.
2. 사전 빌드된 바이너리 파일 등을 Git 저장소의 형태로 제공해 로컬, 원격 경로를 통해(별도 지정 가능) 매번 따로 빌드할 필요없이 플러그인 명령어를 통해 빌드된 파일을 가져올 수 있게 합니다.

 

7. Sandbox: rsync.samba 이슈

Xcode 15부터 Pod을 추가하여 프로젝트를 빌드하는 경우 권한 문제로 인해 Sandbox 접근 거부 에러가 발생할 수 있습니다.
User Script Sandboxing을 No로 설정하면 간단하게 해결됩니다.
 

8. 구글로그인 Pod 설치 이슈

Firebase 제품들과 연결되어있어서 GoogleUtilites도 각각 다르게 설치될 수 있는 것 같습니다.
 

🧐 [CP] Copy Pods Resources 삭제 되었다??

[CP] Copy Pods Resources 스크립트의 목적은 CocoaPod에서 자동생성되는 스크립트인데 추가한 Pod에서 Resource(이미지, 폰트 등등)있는 경우 생성되는 스크립트입니다.  
Firebase, 또는 구글로그인 팟들 중에서 Resource가 없어졌기 때문에 삭제된 것입니다.
Firebase 제품들과 구글로그인 팟버전을 업그레이드하는 경우 Xcode → Build Phases에 pod install시 자동으로 생성되는 [CP] Copy Pods Resources가 추가되지 않았습니다.
 

9. CocoaPod의 Spec과 Github의 Releases Tag버전이 다른 경우

라이브러리별 Github 저장소의 Release태그버전을 확인 한 후 pod을 설치하여도 🔗 CocoaPods Spec에 없다면 설치가 안되므로 🔗 CocoaPods Spec기준으로 설치합니다.
 

🔗 참고링크

---

• cocoapods-binary (현재는 2019년 이후로 업데이트 ❎)
• cocoapods-binary-cache (우버에서 만든 오픈소스 2021년 까지 업데이트)
  • binary-cache 정리 (한국 블로그) - https://bonoogi.postype.com/post/10495540
  • binary-cache 정리 2 (강훈님 블로그) - https://medium.com/@okanghoon/cocoapods-binary-cache-로-개발-환경-빌드-속도를-더-빠르게-만들기-6920f61d9b2c