생성된 프로젝트 만들기

Tuist를 시작하는 가장 쉬운 방법은 아무 디렉터리나 기존 프로젝트의 디렉터리에서 다음을 실행하는 것입니다.

bash

mise x tuist@latest -- tuist init

bash

tuist init

이 명령은 생성된 프로젝트 만들기 단계 또는 기존 Xcode 프로젝트나 워크스페이스 통합 단계를 안내합니다. 또한 설정을 원격 서버에 연결하여 선택적 테스팅, 프리뷰, 레지스트리와 같은 기능에 접근할 수 있도록 합니다.

기존 프로젝트 마이그레이션

개발자 경험을 개선하고 캐시의 이점을 활용하기 위해 기존 프로젝트를 생성된 프로젝트로 마이그레이션하려면 마이그레이션 가이드를 확인하세요.

의존성 추가#

프로젝트가 추가 기능을 제공하기 위해 서드파티 라이브러리에 의존하는 것은 일반적입니다. 최상의 편집 환경을 갖추려면 다음 명령을 실행하세요.

bash

tuist edit

프로젝트 파일이 포함된 Xcode 프로젝트가 열립니다. Package.swift을 편집하고 다음을 추가하세요.

swift

// swift-tools-version: 5.9
import PackageDescription

#if TUIST
    import ProjectDescription

    let packageSettings = PackageSettings(
        // Customize the product types for specific package product
        // Default is .staticFramework
        // productTypes: ["Alamofire": .framework,]
        productTypes: [:]
    )
#endif

let package = Package(
    name: "MyApp",
    dependencies: [
        // Add your own dependencies here:
        // .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
        // You can read more about dependencies here: https://docs.tuist.io/documentation/tuist/dependencies
        .package(url: "https://github.com/onevcat/Kingfisher", .upToNextMajor(from: "7.12.0")) // [!code ++]
    ]
)

그런 다음 프로젝트의 앱 타겟을 편집하여 Kingfisher을 의존성으로 선언하세요.

swift

import ProjectDescription

let project = Project(
    name: "MyApp",
    targets: [
        .target(
            name: "MyApp",
            destinations: .iOS,
            product: .app,
            bundleId: "dev.tuist.MyApp",
            infoPlist: .extendingDefault(
                with: [
                    "UILaunchStoryboardName": "LaunchScreen.storyboard",
                ]
            ),
            buildableFolders: [
                "MyApp/Sources",
                "MyApp/Resources",
            ],
            dependencies: [
                .external(name: "Kingfisher") // [!code ++]
            ]
        ),
        .target(
            name: "MyAppTests",
            destinations: .iOS,
            product: .unitTests,
            bundleId: "dev.tuist.MyAppTests",
            infoPlist: .default,
            sources: ["MyApp/Tests/**"],
            resources: [],
            dependencies: [.target(name: "MyApp")]
        ),
    ]
)

그런 다음 tuist install을 실행하여 Swift Package Manager를 사용해 의존성을 해결하고 가져옵니다.

SPM을 의존성 해결 도구로 사용

Tuist가 권장하는 의존성 관리 방식은 Swift Package Manager(SPM)를 의존성 해결에만 사용합니다. Tuist는 이후 이를 최대 구성 가능성과 제어권을 갖춘 Xcode 프로젝트 및 타겟으로 변환합니다.

프로젝트 시각화#

다음 명령을 실행하여 프로젝트 구조를 시각화할 수 있습니다.

bash

tuist graph

이 명령은 프로젝트 디렉터리에 graph.png 파일을 생성하고 엽니다.

프로젝트 그래프

의존성 사용하기#

tuist generate을 실행하여 Xcode에서 프로젝트를 열고, ContentView.swift 파일에 다음과 같이 변경하세요.

swift

import SwiftUI
import Kingfisher // [!code ++]

public struct ContentView: View {
    public init() {}

    public var body: some View {
        Text("Hello, World!") // [!code --]
            .padding() // [!code --]
        KFImage(URL(string: "https://cloud.tuist.io/images/[email protected]")!) // [!code ++]
    }
}


struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

Xcode에서 앱을 실행하면 URL에서 로드된 이미지가 표시됩니다.