Package (패키지)

패키지란 프로젝트 내에서 사용하는 코드/리소스들을 재사용하기 쉽도록 묶어 정돈하거나 다른 개발자나 커뮤니티와 공유하기 위한 기능입니다.

Xcode는 이런 패키지 기능을 Swift Package Manager를 통해 쉽고 간편하게 사용할 수 있도록 지원하고 있습니다.

네 맞아요..

저희가 맨날 쓰던 그거요..

그러면 멋있고 화려한 RxSwift와 같은 라이브러리를 만들기 위해 시작해보죠?

Swift Package 만들기

전반적인 패키지 생성 과정

패키지 만들기 정말 쉽습니다.

Xcode의 메뉴에서 File ➡️ New ➡️ Package 를 눌러줍시다.

그러면 이렇게 프로젝트나 파일을 만드는 것과 같이 패키지를 생성하는 창이 보입니다.

저는 Favor 프로젝트에 패키지를 적용하기 위해 Add to와 Group도 설정해주었습니다.

그러면 비어있는 패키지 만들기 끝입니다.

패키지를 생성하면 이런 구조의 파일들이 프로젝트에 추가됩니다. 각각을 한 번 알아볼까요?

README.md

뭐 설명할 것도 없죠. 패키지에 대한 설명을 넣어주면 됩니다.

Package.swift

흔히들 manifest라고 부르는 패키지에 대한 정보가 담긴 파일입니다. 이 파일 안에서 패키지의 name, products, targets, dependencies들을 설정해주게 됩니다.

Sources

소스 파일들은 이 Sources 디렉토리 내부에 위치합니다. 그리고 Target이라는 하나의 이름 안에 관리됩니다.

Tests

패키지에 대한 Unit Test 코드들이 여기에 해당됩니다.

Package.swift 작성

Favor 프로젝트는 세가지 패키지를 만들어 사용하기로 했습니다.

FavorCoreKit

Foundation의 extension들, OS와 밀접하게 닿아있는 기능들 (PhotosUI, CoreGraphics 등)을 담아둡니다. 보통 BaseViewController와 같은 Base 파일들도 여기에 담긴다고 하는데 아직 저희 프로젝트는 이런 파일들이 많지 않아서 (BaseVC 하나) 추가적인 회의를 통해 결정하기로 했습니다.

FavorUIKit

UIKit의 extension들과 커스텀 UI 컴포넌트들, 폰트와 아이콘 같은 Resources들과 UI에 사용되는 상수 파일들이 포합됩니다.

FavorNetworkKit

HTTP 통신과 같은 네트워크 작업에 필요한 파일들이 모두 포함됩니다. 저희 프로젝트는 Moya를 사용하기 때문에 BaseTargetType과 API 파일들을 여기에 넣어주었습니다.

이 중에서 FavorUIKit을 한 번 살펴보겠습니다.

// swift-tools-version: 5.7
// The swift-tools-version declares the minimum version of Swift required to build this package.

import PackageDescription

let package = Package(
  name: "FavorUIKit",
  platforms: [
    .iOS(.v15)
  ],
  products: [
    // Products define the executables and libraries a package produces, and make them visible to other packages.
    .library(
      name: "FavorUIKit",
      targets: ["FavorUIKit"]),
  ],
  dependencies: [
    // Dependencies declare other packages that this package depends on.
    // .package(url: /* package url */, from: "1.0.0"),
    .package(url: "https://github.com/ReactiveX/RxSwift.git", .upToNextMajor(from: "6.5.0")),
    .package(url: "https://github.com/SnapKit/SnapKit.git", .upToNextMajor(from: "5.6.0")),
    .package(path: "../FavorCoreKit")
  ],
  targets: [
    // Targets are the basic building blocks of a package. A target can define a module or a test suite.
    // Targets can depend on other targets in this package, and on products in packages this package depends on.
    .target(
      name: "FavorUIKit",
      dependencies: [
        "RxSwift",
        .product(name: "RxCocoa", package: "RxSwift"),
        "SnapKit",
        "FavorCoreKit"
      ],
      resources: [
        .process("Resources")
      ]
    ),
    .testTarget(
      name: "FavorUIKitTests",
      dependencies: ["FavorUIKit"]),
  ]
)