[iOS] Tuist - 4. Project 생성

드디어 프로젝트를 생성할 단계까지 왔습니다.

오늘에야말로 Project.swift 수정할 예정입니다.

그전에!

저희가 목표했던 프로젝트의 구조를 다시 한 번 생각해봅시다.

프로젝트 안에 타겟은 다음과 같이 생성되어야합니다.

Project
├── AppName
├── AppName_Test
├── Content (Push 관련 Extension)
└── Service (Push 관련 Extension)

터미널에서 다음 명령어로 Tuist 프로젝트를 오픈합시다.

$ tuist edit

0. Project 생성자

Project의 초기화 함수는 다음과 같습니다.

Project(
    name: String,
    organizationName: String?,
    options: Project.Options,
    packages: [Package],
    settings: Settings?,
    targets: [Target],
    schemes: [Scheme],
    fileHeaderTemplate: FileHeaderTemplate?,
    additionalFiles: [FileElement],
    resourceSynthesizers: [ResourceSynthesizer]
)

그 중에서 저는

Project(
    name: String,
    organizationName: String?,
    options: Project.Options,
    packages: [Package],
    targets: [Target],
    schemes: [Scheme]
)

정도만 사용할 예정입니다.

다른 옵션들이 사용할 경우 공식 Doc를 참고하여 활용해보세요.

1. 기본 파라미터

// Projcet.swift
let project = Project(
    name: projectName,
    organizationName: organizationName,
    options: .options(automaticSchemesOptions: .disabled),
    ...

앞쪽 파라미터의 설정은 다음과 같이 진행하였습니다.

2. Package

packages: [
    .package(url: "https://github.com/devxoul/Then", .exact("2.7.0")),
    ...
],

SPM에 대한 설정을 추가하였습니다.

Carthage 패키지를 추가할 수도 있다고 합니다. 단, Cocoapods은 지원하지 않습니다.

Cocoapods 패키지를 사용하려면 글의 끝 부분을 참고해주세요.

3. Target

targets: [
    Project.target(
        type: .dev,
        dependencies: [
            .target(name: "Content"),
            .target(name: "Service"),
            .package(product: "Then"),
            ...
        ]
    ),
    Project.target(
        type: .test,
        dependencies: [
            .package(product: "Then"),
            ...
        ]
    ),
    Project.target(
        type: .content,
        product: .appExtension
    ),
    Project.target(
        type: .service,
        product: .appExtension
    )
],

이전에 작업했던 Target 생성자를 통해서 간단하게 Target을 설정했습니다.

테스트 타겟은 Push Notification에 대한 설정을 하지 않을거기 때문에 dependencies에 추가하지 않았습니다.

4. Scheme

    schemes: [
        Scheme(
            name: projectName,
            shared: true,
            buildAction: .buildAction(targets: ["\(projectName)"]),
            runAction: .runAction(configuration: .configuration("Release")),
            archiveAction: .archiveAction(configuration: .configuration("Release")),
            profileAction: .profileAction(configuration: .configuration("Release")),
            analyzeAction: .analyzeAction(configuration: .configuration("Release"))
        ),
        Scheme(
            name: "\(projectName)-Test",
            shared: true,
            buildAction: .buildAction(targets: ["\(projectName)_Test"]),
            runAction: .runAction(configuration: .configuration("Debug")),
            archiveAction: .archiveAction(configuration: .configuration("Debug")),
            profileAction: .profileAction(configuration: .configuration("Debug")),
            analyzeAction: .analyzeAction(configuration: .configuration("Debug"))
        )
    ]

마지막으로 Scheme입니다.

실제로 Action을 취할 Scheme

Scheme은 build, run, archive 등 실제로 action을 취할 것들이라고 보시면 됩니다.

기본 프로덕트는 release로, Test는 Debug로 설정하였습니다.

Content, Service는 별로도 빌드 등을 하지 않기 때문에 추가하지 않았습니다.

5. Tuist Generate

이제 프로젝트를 생성해봅시다!

$ tuist generate -n

설정대로 프로젝트가 생성되었다면 성공!

아니라면, 로그 메세지를 잘 참고하여 수정해보세요!

+ Warning Log

No files found at: {PATH}/Targets/Content/Sources/**/*.xib
No files found at: {PATH}/Targets/Service/Sources/**/*.xib
No files found at: {PATH}/Targets/Service/Resources/**
No files found at: {PATH}/Targets/Service/Resources/**/*.storyboard

Content, Service에는 사실 없는 source와 resource가 많지만, 경로 등록을 해주었기 때문에 위와 같은 메세지가 표시될 수 있습니다.

하지만 프로젝트 생성에는 영향을 주지 않기 때문에 신경쓰지 않고 넘어갑니다.

만약 해당 메세지가 신경쓰이신다면, 각 Target을 생성할 때 사용하지 않는 속성의 PATH를 따로 등록하지 않으면 됩니다.

6. Cocoapods(Optional)

Tuist에서는 공식적으로 Cocoapods을 지원하지 않습니다.(3.x 버전 기준)

[Adding external dependencies | Tuist Documentation

Learn how to define the contract between the dependency managers and Tuist.

docs.tuist.io](https://docs.tuist.io/guides/third-party-dependencies)

따라서 Tuist 프로젝트에서 별도로 설정을 하는 것이 아닌,

tuist generate 후 pod install을 하시면 cocoapods을 사용하실 수 있습니다.

Project.swift 전체 코드

let project = Project(
    name: projectName,
    organizationName: organizationName,
    options: .options(automaticSchemesOptions: .disabled),
    packages: [
        .package(url: "https://github.com/devxoul/Then", .exact("2.7.0")),
        ...
    ],
    targets: [
        Project.target(
            type: .dev,
            dependencies: [
                .target(name: "Content"),
                .target(name: "Service"),
                .package(product: "Then"),
                ...
            ]
        ),
        Project.target(
            type: .test,
            dependencies: [
                .package(product: "Then"),
                ...
            ]
        ),
        Project.target(
            type: .content,
            product: .appExtension
        ),
        Project.target(
            type: .service,
            product: .appExtension
        )
    ],
    schemes: [
        Scheme(
            name: projectName,
            shared: true,
            buildAction: .buildAction(targets: ["\(projectName)"]),
            runAction: .runAction(configuration: .configuration("Release")),
            archiveAction: .archiveAction(configuration: .configuration("Release")),
            profileAction: .profileAction(configuration: .configuration("Release")),
            analyzeAction: .analyzeAction(configuration: .configuration("Release"))
        ),
        Scheme(
            name: "\(projectName)-Test",
            shared: true,
            buildAction: .buildAction(targets: ["\(projectName)_Test"]),
            runAction: .runAction(configuration: .configuration("Debug")),
            archiveAction: .archiveAction(configuration: .configuration("Debug")),
            profileAction: .profileAction(configuration: .configuration("Debug")),
            analyzeAction: .analyzeAction(configuration: .configuration("Debug"))
        )
    ]
)

참고된 사이트

 

[iOS - swift] 4. 모듈화 개념 - Tuist로 프로젝트 관리 방법

Xcode 프로젝트 관리를 위한 Tuist 사용해보기

 

Tuist를 활용한 하쿠나 iOS 프로젝트 모듈화 적용하기