Swift Package Manager로 패키지 만들고 적용하기

1. Swift Package Manager는 뭘까? 왜 필요한걸까?

Swift Package Manager는 종속성을 관리해주는 역할을 한다. 이때 '관리'라 함은 Swift 빌드 시스템과 통합되어 종속성을 다운로드, 컴파일 및 연결하는 프로세스를 자동화하는 것이다.

 

2. 패키지 만들기

+여담) 처음에 다른 블로그들을 보고 패키지를 만들었다가 황당한 에러를 접했었다. 다른 사람들은 같은 시간 낭비를 하지 않기를 바라며..

깃헙 레포를 만들고 해당 레포 파일에서 새로운 프로젝트(패키지)를 만들면 안된다. 패키지 레포 결과물들과 자신의 레포 파일 구성을 비교해보고 다르다면 고치는 것을 추천

 

1) 터미널로 만들기

터미널에서 명령어로 바로 프로젝트 만들고 깃에 업로드하는 건 애플 공식 레포를 참고했다.

https://github.com/apple/swift-package-manager/blob/main/Documentation/Usage.md#testing

GitHub - apple/swift-package-manager: The Package Manager for the Swift Programming Language

해당 공식문서를 보면 library버전 package가 있고 command line에서도 실행할 수 있는 executable버전 package 설정 방법이 있다. 나는 executable버전으로 테스트해보았다. (github repo에서 확인 가능: https://github.com/n-y-kim/MyExecutable)

GitHub - n-y-kim/MyExecutable

 

<library버전으로 만들기>

mkdir MyPackage
cd MyPackage
swift package init # or swift package init --type library
swift build
swift test

MyPackage라는 폴더를 만들고,

해당 폴더로 이동해서 'swift package init'을 해주고, build와 test까지 해준다면(나는 executable버전이었기 때문에 swift run이 먹히고 결과가 나온다!)

터미널

이제 필요한 파일들을 다 만들었으니 레포에 올려줘야 한다.

 

빈 레파지토리를 하나 만들고, 다시 터미널로 돌아온다.

git init
git add .
git remote add origin [github-URL] #새로 생성한 레포의 .git url을 넣어준다
git commit -m "Initial Commit"
git tag 1.0.0
git push origin main --tags

이때 주의하면 좋은건 애플의 공식 레포에서 사용하는 브랜치가 우리가 통상적으로 사용하는 'main'이 아니라 'master'라서 git init을 해주면 이런 문구가 나올 수 있다.

그러나 마지막 줄을 보면 git branch -m <name>으로 초기에 사용하는 브랜치를 조정해주면 된다고 하니 침착하게 git branch -m main으로 바꿔준다.(결과 확인을 위해 git status로 나의 브랜치가 현재 무엇인지 다시 확인할 수 있다)

1.0.0 버전이라는 태그를 만들어주는 것까지 완료하면 레포는 이렇게 생겨야 한다.(꼭 이 형식이어야 한다. 만약 다르다? 잘못 만든것.. 파일 형식을 맞춰 주거나 새로 만들거나..합시다)

이렇게 하면 패키지를 성공적으로 만들었다고 할 수 있다.

 

2) Xcode로 만들기

패키지 생성

패키지를 생성해주고, Github에 해당 프로젝트를 레포로 업로드 해준다.(사전에 Github 계정 연동 필수)

두 번째 아이콘에서 Remotes -> New "`" Remote -> 레포 생성 완료

1.0.0 태그 달고 릴리즈

 

 

이렇게하면 우리는 패키지를 만들었다! 이제 패키지를 적용해보자

 

3. 패키지 적용하기

우선 앞서 만든 XcodeLibrary라는 패키지에 내 패키지의 유효성 확인을 위해 추가 코드를 작성해주었다.

이제 내 패키지를 적용할 새로운 프로젝트로 들어가서 패키지를 적용해보자.

 

1. Package Dependencies에서 + 로 추가하기

2. 아까 만들어둔 레포 url로 검색해서 패키지 찾아주기

3. 이렇게 떴다면 완료!

 

그럼 이제 해당 패키지와 모듈이 잘 돌아가는지 우리의 test() 함수로 실험해보자.

 

import도 잘 되고, 

인스턴스 생성도 문제없다

 

마지막으로 test()함수를 호출하고 RUN하니 Test Completed!🚀 출력 완료!!

 

 

모두들 Swift Package Manager 에러 없이 잘 만들고 적용하시길 바랍니다🤓