3. Swift CocoaPods Tutorial_CocoaPods 설치 및 오류 해결

www.raywenderlich.com/7076593-cocoapods-tutorial-for-swift-getting-started

CocoaPods Tutorial for Swift: Getting Started

CocoaPods를 설치하고, 기초 사용법을 익혀보자!

< 시작하기 전에 >

(쉬운 이해를 돕기 위해 이하 library, framework, dependency 등의 용어를 '라이브러리'로 총칭하겠다.)

✓  Third party 란?

편하고 효율적인 개발을 위해 프로그래밍을 도와주는 plug-in이나 library, framework 혹은 이들을 만드는 회사를 말한다.

프로그래밍과 개발자, 서비스와 사용자 등을 이어주는 제 3자, 중간 다리 역할을 말한다고 하는데,

✓   Third party library ?  

쉽게 말하면, Xcode에서 제공하는 내장 라이브러리 외에도, 외부에서 누군가 만들어놓은 라이브러리를 가져와서 사용할 수 있다는 뜻이다. 특정 기능을 구현하기 위해 모든 코드를 내가 직접 작성할 필요 없이, 그 기능을 구현해주는 외부 라이브러리를 설치하고 갖다 쓰기만 하면 된다는 것!! 아주 편리하쥬? 😆

✓   CocoaPods ?   (a popular *dependency manager for iOS projects)

iOS 앱 개발과정에서, 이러한 외부에서 제공되는 library들을 쉽게 추가, 제거, 업데이트 및 관리할 수 있도록 도와주는 Tool이 바로 이 CocoaPods라고 할 수 있다.

⇨  따라서 이 튜토리얼에서는 CocoaPods 설치부터, 이를 활용해 third party library들을 Xcode 프로젝트에 설치하고 적용하는 CocoaPods의 기초 사용법을 익혀보도록 하자.

 

< 튜토리얼 순서 >

1. CocoaPods 설치

2. Podfile 생성 및 library 설치

3. Xcode 파일에 설치한 라이브러리들을 import 해주기

1. CocoaPods 설치하기

튜토리얼 시작 전, 터미널서 cocoapods 설치하기위해

sudo gem install cocoapods

입력했더니... 오류코드가 한가득..

나같은 초보자는 무슨말들인지 잘 모르겠으나 암튼

Error installing cocoapods:
ERROR: Failed to build gem native extension.

...

우선 내 mac은 얼마 전 업데이트를 하여 카탈리나 10.15.7 버전을 사용중이고, Xcode 버전은 12.2 사용중인데,

구글링 해서 해보라는 거 막 다 해봐도 안돼던 찰나,

brew install cocoapods --build-from-source

라고 명령을 바꿨더니 된다!!!!

homebrew에서 설치하는 걸로 변경하는거라는 거같던데

왜 그런지는 잘 모르겠다. ㅋㅋㅋㅋ 뭐 일단 되니까 감사합니다.. 😅🙏🏻

2. Podfile 생성 및 라이브러리 추가

1) 디렉터리 찾기 (터미널에서 cd ~/Path/… 로 연결해줘도 되지만, 나는 귀찮아서 걍 해당 폴더 우클릭 후 ’New Terminal at Folder’로 열어줌. ㅎㅎㅎ)

2) 터미널의 해당 폴더 위치에서 pod init 하여 Podfile을 생성해준다.

3) open -a Xcode Podfile 입력하여 생성된 Podfile을 열고, Alamofire를 추가해준다.

이렇게 하면 해당 프로젝트가 iOS 9.0을 대상으로, 정적 라이브러리 대신 프레임 워크를 사용하게 될 것이라는 점을 CocoaPods에게 알려준다. 그리고 원하는 기능을 구현해줄 라이브러리 이름과 버전을 입력해준다.

4) 다시 터미널로 돌아와 pod install 해주면 끝!

+ 추후 원하는 라이브러리를 새로 추가할 때에도, podfile에서 pod '이름', '버전' 을 입력하고 터미널에서 pod install 해주면 된다. 넘 편하고 쉽쥬?? ㅎㅎㅎ

3. 설치된 Pods 사용하기

새로 생성된 .xcworkspace 파일을 열어 ViewController에 import Alamofire 를 해주면 사용할 준비가 모두 완료되었다.

(기존 Xcode 파일 대신에 앞으로는 프로젝트에 사용되는 CocoaPods의 라이브러리들이 모두 저장된 .xcworkspace 파일로 열어서 작업을 해야한다.)

4. Dependency 버전 설정하는 법

• = 0.1 Version 0.1.
• > 0.1 Any version higher than 0.1.
• >= 0.1 Version 0.1 and any higher version.
• < 0.1 Any version lower than 0.1.
• <= 0.1 Version 0.1 and any lower version.
• ~> 0.1.2 Version 0.1.2 and the versions up to 0.2, not including 0.2. This operator works based on the last component that you specify in your version requirement. The example is equal to >= 0.1.2 combined with < 0.2.0 and will always match the latest known version matching your requirements.
• ~> 0 Version 0 and the versions up to 1, not including 1.
• ~> 0.1.3-beta.0 Beta and release versions for 0.1.3, release versions up to 0.2 excluding 0.2. Components separated by a dash (-) will not be considered for the version requirement.

참고 : cocoapods podfile syntax reference

 

 

< 용어 정리 >

● dependency manager (종속성 관리자) : 앱에서 사용하는 third-party dependencies(종속성?)을 쉽게 추가, 제거, 업데이트 및 관리할 수 있음.

● Plist : 프로퍼티 리스트

● Sementic Versioning