Devault macOS

Devault macOS 레포지토리입니다.

---

개발 환경 세팅

처음 레포를 클론한 팀원은 아래 순서대로 진행해주세요.

요구 사항

• macOS 14.0 이상
• Xcode 16.0 이상 (Swift Testing 지원)

1. 레포 클론

git clone https://github.com/your-org/Devault-macOS.git
cd Devault-macOS

2. 개발 환경 세팅

./setup.sh

• mise가 없으면 자동으로 설치합니다.
• .mise.toml에 명시된 Tuist 4.191.0을 프로젝트 로컬로 설치합니다.
• Tuist/Package.swift에 정의된 외부 패키지를 fetch합니다.

mise를 처음 설치한 경우 터미널을 재시작하거나 아래 명령어를 실행해주세요.

eval "$(~/.local/bin/mise activate zsh)"

3. 모듈 디렉토리 생성

./scripts/bootstrap_modules.sh

• 각 모듈의 Sources/, Tests/, Resources/ 디렉토리와 Project.swift를 생성합니다.
• 이미 존재하는 모듈은 건드리지 않습니다.

4. Xcode 워크스페이스 생성

tuist generate

• Devault.xcworkspace가 생성됩니다.
• 이후 Xcode에서 Devault.xcworkspace를 열어 작업합니다.

---

자주 쓰는 명령어

명령어	설명
tuist generate	Xcode 워크스페이스 재생성
tuist install	외부 패키지 fetch (Package.swift 변경 시)
tuist clean	Tuist 캐시 및 생성 파일 삭제
./scripts/bootstrap_modules.sh	새 모듈 디렉토리 초기화

---

프로젝트 구조

Devault-macOS/
├── Workspace.swift                         # 워크스페이스 정의 (DVModule.allCases 기반)
├── Tuist.swift                             # Tuist 설정
├── Tuist/
│   ├── Package.swift                       # 외부 패키지 정의
│   └── ProjectDescriptionHelpers/
│       ├── Project+Templates.swift         # bundleID, osVersion, project() 팩토리
│       ├── DVModule.swift                  # 모듈 목록 및 경로/bundleId 정의
│       ├── Target+Templates.swift          # target() / tests() / sampleApp() 팩토리
│       ├── ResourceExtensions.swift        # ResourceFileElements.default
│       ├── TargetDependency+Module.swift   # 모듈 간 의존성 헬퍼
│       └── TargetDependency+External.swift # 외부 라이브러리 의존성 헬퍼
├── Projects/
│   ├── Devault/         # 메인 앱
│   ├── DVCore/          # 공통 유틸리티
│   ├── DVDesign/        # 디자인 시스템 (+ SampleApp)
│   ├── DVData/          # Data 레이어
│   ├── DVDomain/        # Domain 레이어 (+ Tests)
│   ├── DVPresentation/  # Presentation 레이어
│   ├── DVNetwork/       # 네트워크 (추후 사용)
│   └── DVStorage/       # 스토리지 (추후 사용)
└── scripts/
    └── bootstrap_modules.sh  # 모듈 디렉토리 초기화 스크립트

---

외부 의존성

패키지	용도
swift-composable-architecture	TCA - DVPresentation 상태 관리

---

새 모듈 추가하기

예시: DVFeatureVault 모듈을 새로 추가하는 경우

1. DVModule.swift에 케이스 추가

// Tuist/ProjectDescriptionHelpers/DVModule.swift
public enum DVModule: String, CaseIterable {
    ...
    case DVFeatureVault  // 추가
}

name, bundleId, path, dependency는 자동으로 생성됩니다.

2. TargetDependency+Module.swift에 헬퍼 추가

// Tuist/ProjectDescriptionHelpers/TargetDependency+Module.swift
extension TargetDependency {
    public static func featureVault() -> TargetDependency {
        DVModule.DVFeatureVault.dependency
    }
}

3. 모듈 디렉토리 생성

./scripts/bootstrap_modules.sh

DVFeatureVault/ 디렉토리와 기본 Project.swift가 자동 생성됩니다.

4. Project.swift 수정 (필요 시)

bootstrap으로 생성된 기본 Project.swift를 필요에 맞게 수정합니다.

// Projects/DVFeatureVault/Project.swift
import ProjectDescription
import ProjectDescriptionHelpers

let project = Project.project(
    name: DVModule.DVFeatureVault.name,
    targets: [
        .target(
            name: DVModule.DVFeatureVault.name,
            product: Project.product,
            sources: .sources,
            dependencies: [
                .domain(),
                .design(),
            ]
        ),
        .tests(
            name: DVModule.DVFeatureVault.name,
            dependencies: [DVModule.DVFeatureVault.dependency]
        ),
    ]
)

5. 워크스페이스 재생성

tuist generate

Workspace.swift는 DVModule.allCases를 자동으로 순회하므로 별도 수정이 필요 없습니다.

---

외부 라이브러리 추가하기

예시: Alamofire를 추가하는 경우

1. Tuist/Package.swift에 패키지 추가

// Tuist/Package.swift
let packageSettings = PackageSettings(
    productTypes: [
        "ComposableArchitecture": .staticFramework,
        "Alamofire": .staticFramework,  // 추가
    ]
)

let package = Package(
    name: "Devault",
    dependencies: [
        .package(
            url: "https://github.com/pointfreeco/swift-composable-architecture",
            from: "1.15.0"
        ),
        .package(
            url: "https://github.com/Alamofire/Alamofire",  // 추가
            from: "5.0.0"
        ),
    ]
)

productTypes에 추가하면 정적 프레임워크로 링크됩니다. 동적 프레임워크가 필요한 경우 생략하세요.

2. TargetDependency+External.swift에 케이스 추가

// Tuist/ProjectDescriptionHelpers/TargetDependency+External.swift
public enum External: String {
    case ComposableArchitecture
    case Alamofire  // 추가
}

3. 패키지 fetch

tuist install

4. 사용할 모듈의 Project.swift에 의존성 추가

.target(
    name: DVModule.DVNetwork.name,
    product: Project.product,
    sources: .sources,
    dependencies: [
        .external(dependency: .Alamofire),
    ]
)

5. 워크스페이스 재생성

tuist generate

---

테스트

Swift Testing을 사용합니다.

import Testing
@testable import DVDomain

@Suite("UseCase 이름")
struct SomeUseCaseTest {
    @Test("성공 시 올바른 값을 반환한다")
    func success() {
        #expect(result == expected)
    }
}

테스트 타겟은 Project.swift에서 .tests() 템플릿으로 추가합니다.

.tests(
    name: DVModule.DVDomain.name,
    dependencies: [DVModule.DVDomain.dependency]
)