BookSeries

Created by 홍석현 on 09-11-25. Copyright © 2025 홍석현. All rights reserved.

🏗️ 모듈러 아키텍처

이 프로젝트는 Tuist를 사용한 모듈러 iOS 아키텍처 템플릿입니다.

📁 모듈 구조

• App: 메인 애플리케이션
• Domain: 비즈니스 로직 및 엔터티
• Data: 데이터 레이어 (Repository 구현)
• Network: 네트워크 통신
• DesignSystem: UI 컴포넌트 및 디자인 시스템
• Feature: 각 기능별 모듈들

🚀 시작하기

# 새 Feature 생성
make feature

# Xcode 프로젝트 생성
make generate

# 프로젝트 정리
make clean

# 도움말
make help

🎯 Feature 개발

각 Feature는 독립적인 데모앱을 포함하여 개발 및 테스트가 가능합니다.

# 새 Feature 생성 (예: Login)
make feature
# > Login 입력

# Xcode에서 LoginFeatureDemo 스킴 선택 후 실행

📝 템플릿 구조

• Framework: 실제 기능 구현
• Demo App: 독립 실행 가능한 데모 애플리케이션
• 자동 의존성 관리

🛠️ 요구사항

• Xcode 15.0+
• iOS 15.0+
• Tuist 4.0+

🔧 트러블슈팅

Tuist를 찾을 수 없다는 오류가 발생하는 경우

⚠️ Tuist를 찾을 수 없습니다.

해결 방법:

1. Tuist 설치 확인

   which tuist  # Tuist 설치 경로 확인
   tuist --version  # 버전 확인

2. Tuist 설치

   # 공식 설치 스크립트
   curl -Ls https://install.tuist.io | bash
   
   # 또는 Homebrew
   brew install tuist
   
   # 또는 mise (이전 asdf)
   mise install tuist

3. PATH 설정 확인

   • mise 사용자: ~/.local/share/mise/installs/tuist/*/bin/tuist
   • Homebrew 사용자: /opt/homebrew/bin/tuist
   • 수동 설치: /usr/local/bin/tuist

make generate 실패하는 경우

Manifest not found at path

원인: 프로젝트 초기 설정이 완료되지 않았습니다.

해결 방법:

1. Tuist가 제대로 설치되었는지 확인
2. make project를 다시 실행
3. Workspace.swift 파일이 생성되었는지 확인

기본 모듈이 생성되지 않는 경우

원인: Tuist 감지 실패로 scaffold 명령이 실행되지 않았습니다.

해결 방법:

# 수동으로 모듈 생성
tuist scaffold app --name MyApp
tuist scaffold domain
tuist scaffold data  
tuist scaffold network
tuist scaffold designsystem

📄 라이선스

Copyright © 2025 홍석현. All rights reserved.