[Pod/iOS] Pod 라이브러리 생성하고 관리하기

터미널에서 

pod lib create [pod name]

https://guides.cocoapods.org/making/using-pod-lib-create

위 명령어를 입력하면 플랫폼을 선택할 수 있는 문구가 나옴

지금은 로컬에서 작업하고 있기 때문에 이전에 작업한 같은 이름의 라이브러리가 있지 않은한, 충돌이 발생하지 않는다 

 

What platform do you want to use?? [ iOS / macOS ]
> iOS

이때 iOS 선택 (맥용 라이브러리를 생성한다면 macOS를 선택하면 됨)

 

What language do you want to use?? [ Swift / ObjC ]
 > Swift

팟 라이브러리에서 사용할 언어 선택

Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

데모앱을 포함 시킬 것인지 여부를 묻는 것으로 Yes로 설정하면 라이브러리를 수정하면서 데모앱을 실행 시킬 수 있나봄

 

Which testing frameworks will you use? [ Quick / None ]
 > None

테스트에 사용할 프레임워크를 지정하는 것으로 Quick 혹은 지정 안할 수 있음

 

Would you like to do view based testing? [ Yes / No ]
 > No

뷰 단위의 테스팅을 할 것인지 묻는 것

 

What platform do you want to use?? [ iOS / macOS ]
 > iOS

What language do you want to use?? [ Swift / ObjC ]
 > Swift

Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

Which testing frameworks will you use? [ Quick / None ]
 > None      

Would you like to do view based testing? [ Yes / No ]
 > No

설정이 끝나면 자동으로 해당 프로젝트가 Xcode로 실행됨

 

 

이미 생성된 이름으로 프로젝트를 다시 만들려고 하는 경우 user 파일에 들어가면 pod name으로 지정한 프로젝트 파일이 생성됨 -> 해당 파일 삭제

 

Pods > Development Pods에서 코드를 작성할 수 있음

여기에 작성된 코드는 해당 라이브러리를 사용하는 다른 사람이 사용가능하게 함

 

 

깃허브 연결

레포지토리 생성하기 이때 기존에 있는 레포지토리 이름은 사용할 수 없음

public으로 생성해서 다른 사람도 팟 라이브러리를 사용할 수 있게 함

 

이제 터미널의 cd 명령어를 사용해서 라이브러리가 있는 파일로 이동함 

 

 

git init
git config user.name ""
git config user.email ""
git add README.md
git add .
git commit -m "first commit"
git tag -a 0.0.1 -m "Version 0.0.1"
git remote add origin https://github.com/[user name]/[your repository name].git
git push -u origin main

하나의 맥에서 여러 계정을 사용하고 있다면 계정을 config 명령어를 사용해서 지정해 줄 수 있음

push 시 깃허브의 username과 access token 정보를 입력하면 정상적으로 푸시가 이루어짐

태그는 버전 관리를 위해 사용되므로 푸시 할때 태그 정보를 작성해 줘야 함

 

projectName.podspec 에서 dependency와 정보를 관리할 수 잇음

s.version의 값을 태그의 값과 동일하게 변경함

변경 후 리모트에 푸시하고 싶은 경우 터미널에서

git add .
git commit -m "CNG version and tag"
git push

 

아무 작업도 없이 푸시를 하니 너무 허술하다

 

릴리즈 정보 작성

오른쪽 네비게이션을 보면 Releases를 작성하는 곳이 있음

Create a new release를 눌러서 릴리즈 정보를 작성한다

처음에 상단에 태그 선택란에 태그 정보가 없으므로 생성하고자 하는 버전으로 태그를 생성해 줌
(이거 안해 주면 CocoaPods 배포가 안된다... ㅠ)

그러면 이렇게 create a new release 작성란에 이렇게 태그 정보가 보인다

 

CocoaPods에 푸시

처음 CocoaPods에 푸시하려면 이메일 등록과 인증이 필요함

pod trunk push --allow-warnings

이제 레포지토리 루트파일에서 해당 명령어를 입력한다

이때 발생할 수 있는 몇가지 에러(혹은 이슈) 가 있다. CocoaPods 라이브러리 최초 배포시 발생할 수 있는 문제들이다!

 

[!] Specify at least your email address.

    $ pod trunk register EMAIL [YOUR_NAME]

    Register a new account, or create a new session.

 

이메일과 이름 (깃허브에서 사용하고 있는 이메일과 이름입력해 주엇음) 을 위 명령어 형태로 입력하면

해당 주소로 인증가능한 메일을 보내준다

Please verify the session by clicking the link in the verification email that has been sent to

메일 인증 없이 진행하면 위 문구가 나타난다

메일로 보내준 url로 들어가면 CocoaPods 홈페이지에서 해당 문구가 나타난다

이제 준비가 됬다

pod trunk push --allow-warnings

위 명령어를 입력하고 팟 등록을 마무리 한다

 

혹시 하나의 맥에서 여러 계정을 사용하고 있는 경우 깃허브 정보가 꼬일 수 있다

그럴 경우 podspec 의 자동으로 입력된 정보도 꼬이게 되는데, username이 꼬인 경우 

projectName.podspec으로 들어가서

  s.homepage         = 'https://github.com//'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '' => '' }
  s.source           = { :git => 'https://github.com//.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

이 부분이 레포지토리 정보가 맞는지 확인한다

s.homepage와 s.author, s.source의 정보가 레포지토리 정보와 일치해야 등록 가능하다.

(등록하기 전에 로컬 저장소에 있는 podspec의 정보가 제대로 되어 있는지 확인 필요)

 

warning: Could not find remote branch 0.0.1 to clone.
fatal: Remote branch 0.0.1 not found in upstream origin

위 오류가 나오는 경우 깃허브에 등록한 릴리즈 정보가 정확한지 태그가 생성된 것이 맞는지 확인한다

 

 

참고 사이트 및 도서

https://medium.com/@jeantimex/create-your-own-cocoapods-library-da589d5cd270

https://betterprogramming.pub/how-to-create-a-public-cocoapods-library-23e9c8f773f8

https://stackoverflow.com/questions/37038659/issue-when-creating-my-first-cocoapod