MultiModuleTemplate

Tuist로 구성된 멀티 모듈 iOS 프로젝트 템플릿입니다.

프로젝트 구조

MultiModuleTemplate/
├── Workspace.swift
├── Tuist.swift
├── Projects/
│   ├── App/                  # 메인 애플리케이션
│   ├── Presentation/
│   │   └── Presentation/     # 화면 및 ViewModel 구성
│   ├── Core/
│   │   ├── Core/             # 핵심 공통 모듈
│   ├── Data/             # 데이터 계층 (Clean Architecture)
│   ├── Domain/           # 도메인 계층 (Clean Architecture)
│   └── Shared/
│       ├── DesignSystem/     # 공통 UI 컴포넌트, 폰트 등
│       ├── Shared/           # 공통 공유 모듈
│       ├── ThirdParty/       # 외부 라이브러리 래핑
│       └── Utill/            # 공통 유틸리티
├── Tuist/
│   ├── Package.swift
│   └── ProjectDescriptionHelpers/
└── Plugins/

Tuist graph

🚀 빠른 시작

새 프로젝트 생성 (권장)

# 1. TuistTool 컴파일 (최초 1회만)
swiftc TuistTool.swift -o tuisttool

# 2. 새 프로젝트 생성 (대화형으로 이름 설정)
./tuisttool newproject

템플릿 그대로 사용

# Tuist 4.97.2 최신 명령어
tuist install     # 의존성 설치 (새로운 명령어)
tuist generate    # 프로젝트 생성
tuist build       # 빌드
tuist test        # 테스트

# 또는 TuistTool 사용 (권장)
./tuisttool build # clean + install + generate 한번에

주요 모듈 설명

📱 Application Layer

• App: 메인 애플리케이션 모듈 (앱 진입점 및 설정)
• Presentation: ViewController, ViewModel 등 UI 로직 담당

🏗 Core Layer (Clean Architecture)

Domain Layer (비즈니스 로직)

• Domain

Data Layer (데이터 처리)

• Data

Common Layer

• Core: 핵심 공통 기능 및 설정
• ThirdParty: 외부 라이브러리 (Core 레벨)

🎨 Shared Layer

• DesignSystem: 공통 UI 컴포넌트, 폰트, 색상 등 디자인 시스템
• Shared: 공통 공유 모듈 및 기본 설정
• ThirdParty: 외부 라이브러리 래핑 (TCA, WeaveDI, Alamofire 등)
• Utill: 날짜, 문자열, 로깅 등 공용 유틸리티

개발 환경

• iOS 16.6+
• Xcode 26.0.1+
• Swift 6.0+
• Tuist 4.97.2 (최신 최적화 적용)

사용 라이브러리

• ComposableArchitecture: 상태 관리
• WeaveDI: 의존성 주입
• TCACoordinators: TCA 기반 네비게이션
• FlowStacks: SwiftUI 네비게이션

🛠️ TuistTool (커스텀 CLI)

프로젝트 전용 CLI 도구입니다. Tuist 명령을 래핑하고, 새 프로젝트 생성, 모듈 스캐폴딩 등을 지원합니다.

설치 및 사용법

# 컴파일
swiftc TuistTool.swift -o tuisttool

# 사용법
./tuisttool <command>

지원 명령어 요약

Command	설명
newproject	🚀 새 프로젝트 생성: ProjectConfig.swift 이름 변경, 디렉토리 자동 생성, 완전 자동화된 프로젝트 생성
generate	tuist generate 실행
build	clean → install → generate 순서로 실행 (Tuist 4.97.2 최적화)
install	새로운! tuist install 실행 (의존성 설치)
clean	tuist clean 실행
cache	tuist cache 실행 (바이너리 캐시 생성)
reset	강력 클린: 모든 캐시 삭제 후 install → generate 재실행
inspect	새로운! 사용 가능한 분석 도구 표시
inspect-imports	새로운! 암시적 의존성 검사
inspect-coverage	새로운! 코드 커버리지 분석
moduleinit	모듈 스캐폴딩 마법사: 자동 의존성 삽입 및 Interface 폴더 생성

상세 동작

• newproject (완전히 새로워짐!)

  • 🎯 ProjectConfig.swift 자동 수정: 프로젝트 이름, 번들 ID, 팀 ID 자동 변경
  • 📁 필수 디렉토리 사전 생성: MultiModuleTemplateTests, FontAsset 등 자동 생성
  • 🔍 이름 변경 검증: 변경 완료 후 실제로 적용되었는지 확인
  • 🧹 기존 워크스페이스 정리: 충돌 방지를 위한 기존 파일 삭제
  • ✅ 완전 자동화: 대화형 또는 명령어 인자로 완전 자동 생성

• build (Tuist 4.97.2 최적화)

  • 내부적으로 clean → install → generate 호출 (fetch 대신 install 사용)

• install (새로운 명령어)

  • Tuist 4.97.2의 새로운 tuist install 명령어 실행
  • 의존성 설치 및 해결 담당

• inspect 시리즈 (새로운 분석 도구들)

  • inspect: 사용 가능한 분석 도구 목록 표시
  • inspect-imports: 암시적 의존성 검사 (enforceExplicitDependencies 대체)
  • inspect-coverage: 코드 커버리지 분석

• reset (개선됨)

  • ~/Library/Caches/Tuist, ~/Library/Developer/Xcode/DerivedData, .tuist, .build, Tuist/Dependencies 삭제
  • 이후 install → generate 순차 실행 (최신 워크플로우)

• moduleinit

  • Plugins/DependencyPlugin/ProjectDescriptionHelpers/TargetDependency+Module/Modules.swift에서 모듈 타입 및 케이스 목록을 파싱합니다.
  • Plugins/DependencyPackagePlugin/ProjectDescriptionHelpers/DependencyPackage/Extension+TargetDependencySPM.swift에서 SPM 의존성 목록을 파싱합니다.
  • 입력 받은 의존성들을 Projects/<Layer>/<ModuleName>/Project.swift의 dependencies: [ 영역에 자동 삽입합니다.
  • Domain 계층 생성 시, Interface/Sources/Base.swift를 템플릿으로 생성하도록 선택 가능.

⚠️ 파일 경로 전제

• 위 파서는 특정 경로의 파일 구조/포맷을 기대합니다. 경로가 다르거나 파일 포맷이 변경되면 파싱이 실패할 수 있습니다.
• 경로가 다르다면 availableModuleTypes(), parseModulesFromFile(), parseSPMLibraries()의 파일 경로를 프로젝트에 맞게 수정하세요.

🎯 자주 쓰는 명령어

새 프로젝트 생성

# 대화형 생성 (권장)
./tuisttool newproject

# 명령어로 한번에 생성
./tuisttool newproject MyApp --bundle-id com.company.myapp --team-id ABC123

기본 개발 워크플로우

# Tuist 4.97.2 최적화된 워크플로우
./tuisttool build      # clean → install → generate
./tuisttool test       # 테스트 실행

# 코드 품질 검사
./tuisttool inspect-imports    # 암시적 의존성 검사
./tuisttool inspect-coverage   # 코드 커버리지 분석

문제 해결

# 강력한 클린 (모든 캐시 삭제)
./tuisttool reset

# 의존성 재설치
./tuisttool install

# 프로젝트 구조 분석
tuist graph --format pdf --path ./graph.pdf

모듈 개발

# 새 모듈 생성 (자동 의존성 설정)
./tuisttool moduleinit

# 특정 모듈만 포커스
tuist focus <모듈명>

🔧 CI/CD 예시

GitHub Actions (권장)

# CI 파이프라인
./tuisttool reset      # 모든 캐시 클린
./tuisttool build      # clean → install → generate
./tuisttool test       # 테스트 실행
./tuisttool inspect-imports  # 의존성 검증

로컬 재현

# CI와 동일한 환경에서 로컬 테스트
./tuisttool reset && ./tuisttool build && ./tuisttool test

---