편집하기

Xcode의 UI를 통해 변경하는 기존 Xcode 프로젝트나 Swift Package와 달리, Tuist로 관리되는 프로젝트는 매니페스트 파일에 포함된 Swift 코드로 정의됩니다. Swift Package와 Package.swift 파일에 익숙하다면 접근 방식이 매우 유사합니다.

텍스트 편집기로 이 파일들을 편집할 수 있지만, Tuist가 제공하는 워크플로우인 tuist edit를 사용하는 것을 권장합니다. 이 워크플로우는 모든 매니페스트 파일을 포함하는 Xcode 프로젝트를 생성하고, 이를 편집하고 컴파일할 수 있게 해줍니다. Xcode를 사용함으로써 코드 자동 완성, 구문 강조, 오류 검사의 모든 이점을 누릴 수 있습니다.

프로젝트 편집하기#

프로젝트를 편집하려면 Tuist 프로젝트 디렉터리 또는 하위 디렉터리에서 다음 명령어를 실행하세요:

bash

tuist edit

이 명령어는 전역 디렉터리에 Xcode 프로젝트를 생성하고 Xcode에서 엽니다. 프로젝트에는 모든 매니페스트가 유효한지 확인하기 위해 빌드할 수 있는 Manifests 디렉터리가 포함되어 있습니다.

Glob으로 해결된 매니페스트

tuist edit는 프로젝트 루트 디렉터리(Tuist.swift 파일이 있는 디렉터리)에서 **/{Manifest}.swift glob 패턴을 사용하여 포함할 매니페스트를 해결합니다. 프로젝트 루트에 유효한 Tuist.swift가 있는지 확인하세요.

매니페스트 파일 무시하기#

프로젝트의 하위 디렉터리에 실제 Tuist 매니페스트가 아닌 매니페스트 파일과 동일한 이름(예: Project.swift)의 Swift 파일이 포함된 경우, 프로젝트 루트에 .tuistignore 파일을 생성하여 편집 프로젝트에서 제외할 수 있습니다.

.tuistignore 파일은 glob 패턴을 사용하여 무시할 파일을 지정합니다:

gitignore

# Ignore all Project.swift files in the Sources directory
Sources/**/Project.swift

# Ignore specific subdirectories
Tests/Fixtures/**/Workspace.swift

이는 테스트 픽스처나 예제 코드가 우연히 Tuist 매니페스트 파일과 동일한 명명 규칙을 사용하는 경우에 특히 유용합니다.

편집 및 생성 워크플로우#

알아차렸겠지만, 편집은 생성된 Xcode 프로젝트에서 수행할 수 없습니다. 이는 생성된 프로젝트가 Tuist에 의존하지 않도록 설계된 것으로, 향후 Tuist에서 쉽게 전환할 수 있도록 하기 위함입니다.

프로젝트를 반복 작업할 때는 터미널 세션에서 tuist edit를 실행하여 프로젝트를 편집할 Xcode 프로젝트를 얻고, 다른 터미널 세션에서 tuist generate를 실행하는 것을 권장합니다.