[iOS] 나만의 라이브러리 만들기(feat. CocoaPods)

 

안녕하세요 Foma 👟입니다!

 

평소에 라이브러리를 사용하고 언젠가 나만의 라이브러리를 만들어서 써봐야지했는데

 

드디어 그런 날이 오네요...

 

그래서 오늘은 자기만의 라이브러리를 만들고 사용해보는 것을 정리해보려고 합니다!

 

바로 시작할게요~

---

Terminal

 

라이브러리를 만들 경로로 이동하신 뒤 아래와 같이 입력하셔서 라이브러리를 만들어주세요!

 

pod lib create 원하는이름

 

이렇게 하면 총 5가지 질문이 나올거에요.

 

 

1. 어떤 플랫폼을 사용하거니? iOS /macOS -> iOS

 

2. 어떤 언어를 사용할거니? Swift/Objc -> Swift

 

3. 너 데모앱 포함할거야? -> Yes

 

4. 테스트는 뭘로 할거야? Quick/None -> None

 

5. 뷰 기반으로 테스트 할거야? No

 

이렇게 입력하시면 새로운 라이브러리를 pod에 설치하고 Xcode 프로젝트가 자동으로 실행될거에요!

---

Xcode

 

Development Pods -> 라이브러리이름 -> ReplaceMe.Swift로 이동해주세요!

 

 

ReplaceMe.Swift 파일을 라이브러리명.swift로 해주세요!

 

 

그리곤 간단하게 이름과 함께 인사하는 코드를 작성해볼게요! 

 

외부에서 사용해야 하니 반드시 open이나 public으로 작성하셔야 합니다!

 

import Foundation

public struct Foma {
    public static func sayHello(with name:String) {
        print("\(name)님 안녕하세요.")
    }
}

 

Example 앱으로 이동해서 테스트 해볼까요? (처음에 5가지 질문에서 데모앱 만들거야?가 바로 이것입니다.)

 

뷰컨트롤러로 이동해서 자신의 라이브러리를 import하고 작성한 코드를 실행해봅니다.

 

 

그러면 다음과 같이 라이브러리 이름이 뜨면서 실행될거에요.

 

 

 

 

이렇게 이름과 함께 잘 출력이 되었습니다.

 

 

그 다음으론 Podspec 파일로 이동해주세요!

 

 

팟스펙은 아래와 같이 형식에 맞게 작성해주세요!

 

(특히 s.source_files 경로를 잘 작성해주세요 ㅜ 이것 때문에 몇 시간은 고생한듯...ㅜ)

 

Pod::Spec.new do |s|
  //원하는 라이브러리 이름
  s.name             = 'FomaPrint'
  //라이브러리 버전
  s.version          = '0.1.0'
  //라이브러리 요약내용
  s.summary          = '이것은 인사를 출력해주는 라이브러리입니다!'
  //깃허브 주소
  s.homepage         = 'https://github.com/fomagran/FomaPrint'
  //MIT 라이센스
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  //만든 사람 이름과 주소
  s.author           = { 'fomagran' => 'fomagran6@naver.com' }
  //깃 소스
  s.source           = { :git => 'https://github.com/fomagran/FomaPrint.git', :tag => s.version.to_s }
  //최소 배포 타겟
  s.ios.deployment_target = '9.0'
  //소스파일 경로
  s.source_files = 'FomaPrint/Classes/**/*'
  //현재 swift 버전
  s.swift_versions = '5.0'

end

 

그리곤 git을 관리하는 탭으로 이동해서 새로운 원격 저장소를 만들어줍니다.

 

 

레포지토리 이름은 라이브러리랑 똑같이 해주시고 Create를 눌러주세요!

 

 

이제 깃허브로 가서 확인해보면 새로운 레포지토리가 만들어져 있을거에요!

 

(이거 보고 진짜 뿌듯했는데...)

 

---

Terminal

 

이제 다시 터미널로 이동해서 본격적으로 배포를 해볼까요?

 

아래와 같이 입력해 .podspec 파일에 아무런 이상이 없는지 체크합니다.

 

pod spec lint

 

이렇게 실행하면 경고와 오류가 뜨는데요.

 

먼저 경고는 요약한 내용이 별로 의미있지 않다라는 내용이구요. 

(summary를 고치기 전에 뜬 경고에요. 위에서 요약을 제대로 쓰셨으면 안뜨실거에요,)

 

에러는 원격 저장소에 0.1.0 버전 태그가 없다는 거에요.

 

 

Xcode로 이동해서 윗쪽 탭의 Source Control에서 Commit을 눌러줍니다.

 

 

그리곤 바뀐 내용을 Commit하고 origin/master에 Push to remote를 커밋을 푸쉬해줍니다.

 

 

그리곤 깃허브로 가서 확인해보면 아래와 같이 커밋한 내용으로 업데이트 되어있을거에요!

 

 

그 다음 터미널로 이동해서 아래와 같이 입력해줍니다.

 

git tag 버전
git push origin 버전

 

이렇게 해주시고 만약 에러나 경고가 하나도 없다면 passed validation이 뜰거에요!

 

(만약 경고를 그냥 무시하고 싶다면 pod spec lint --allow-warnings로 하시면 됩니다.)

 

 

그 다음 pod에 등록을 해주기 위해 아래와 같이 이메일 주소와 이름을 작성해줍니다.

 

pod trunk register 이메일주소 이름

 

이메일 주소로 가서 자신이 맞는지 체크해달라고 할거에요.

 

 

이메일로 이동하셔서 링크를 클릭하시면

 

 

코코아팟 사이트로 이동되면 셋업이 완료되었다고 뜰거에요.

 

 

다시 터미널로 이동해서 아래와 같이 입력해주어서 라이브러리를 코코아팟에 푸쉬해줍니다.

 

pod trunk push 라이브러리이름.podspec

 

이렇게 하면 아래와 같이 성공적으로 출시되었다고 뜰거에요!

 

 

깃허브로 이동해서 확인해보면 버전과 플랫폼 라이센스가 아래와 같이 제대로 출시되어있는 것을 확인할 수 있습니다!

 

---

Update

 

이렇게 출시하고 원하는 코드로 추가해주려면 업데이트를 해줘야겠죠?

 

다시 라이브러리 프로젝트로 이동해서 코드를 추가해줍니다.

 

import Foundation

public struct Foma {
    public static func sayHello(with name:String) {
        print("\(name)님 안녕하세요.")
    }
    
    public static func sayBye(with name:String) {
        print("\(name)님 안녕히 가세요.")
    }
}

 

그 다음 팟스펙 파일로 이동해서 원하는 버전으로 바꿔줍니다.

 

s.version          = '0.1.1'

 

바뀐 내용을 커밋 후 푸쉬해주세요.

 

 

그 다음 터미널로 이동해서 git에 바뀐 tag를 달아줍니다.

 

git tag 0.1.1
git push origin 0.1.1

 

그 다음 pod trunk에 푸쉬를 해줍니다.

 

pod trunk push

 

이렇게 하면 새로운 버전이 성공적으로 출시된 것을 볼 수 있습니다.

 

---

Test

 

이제 만든 라이브러리를 사용해 볼 프로젝트로 이동해줍니다.

 

Podfile에 자신의 라이브러리를 추가해주세요.

 

pod '라이브러리'

 

 

혹시라도 위와 같은 에러가 떴다면 아래와 같이 추가해주세요!

 

pod '라이브러리', :git => '깃 주소', :tag => '새로운 버전'

 

이렇게 하면 아래와 같이 자신의 라이브러리가 설치되는 것을 볼 수 있습니다.

 

 

뷰컨트롤러로 이동해서 자신의 라이브러리를 import 해주시고 아래와 같이 메소드들을 실행시키면

 

import UIKit
import FomaPrint

class ViewController: UIViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
       
        Foma.sayHello(with: "Fomagran")
        Foma.sayBye(with: "Fomagran")
    }
}

 

아래와 같이 출력이 잘 되는 것을 볼 수 있습니다!!!

 

 

혹시 'Cannot call value of non-function type 'module<Framework>' 라는 에러가 뜬다면 

 

 

해당 클래스에서 Target Membership에 프레임워크 이름으로 된 것이 체크가 되어있는지 확인해주세요.

 

 

안되어 있다면 체크해줍니다.

 

---

오늘은 이렇게 자신의 라이브러리를 추가하고 업데이트하고 사용해보았는데요.

 

언젠가는 꼭 해야지..미루다 미루다 이번에 했는데 정말 뿌듯하네요!

혹시라도 틀린 점이 있거나 궁금하신 점이 있으면 댓글로 알려주세요!

---

Reference

 

염염님 글을 참고하였습니다.

 

코코아팟 라이브러리 배포하기 - 야곰닷넷