Swift 꾸러미(Package.swift·Sources·Tests)나 SwiftUI MVVM 앱 뼈대를 zip 으로 줘요.
Swift 프로젝트 뼈대 만들기
만들 것과 코드 꼴을 고르면 폴더 나무·파일마다 하는 일·계층 그림이 바뀌어요. 명령줄 도구와 라이브러리는 zip 을 풀어 swift build 로 빌드하고, SwiftUI 앱은 Xcode 에서 새 프로젝트를 만든 뒤 넣는 파일이에요.
만들 것
코드 꼴
테스트
폴더 나무 파일 6개
Sources/
Hello/
HelloCLI/
Tests/HelloTests/
Package.swift
꾸러미 설정 파일이에요. 첫 줄 주석이 사용할 Swift 버전을 정해요(요즘 꼴 6.0 이면 Swift 6 언어 모드). products 는 밖에 내놓는 결과물(명령이나 라이브러리), targets 는 모듈과 시험이에요. Sources/ 아래 폴더 이름과 target 이름이 같아야 해요.
적어 둔 버전 Swift 6.4 툴체인으로 확인 · swift-tools-version 6.0 · 5.9 · Swift Testing·XCTest(툴체인에 들어 있음) · 앱: iOS 17(요즘 꼴) · iOS 16(예전 꼴). 바깥 꾸러미를 사용하지 않아서 따로 받을 것이 없어요. Swift Testing 과 XCTest 는 툴체인에 들어 있어요. SwiftUI 앱은 Xcode 프로젝트 파일 없이 넣을 파일만 줘요.
Swift 꾸러미와 Xcode 앱의 자리
자리
들어가는 것
Package.swift
꾸러미 설정 파일. 맨 윗줄 // swift-tools-version: 이 사용할 Swift 버전을 정하고, 아래에 결과물(products)과 target(모듈)을 Swift 코드로 적어요.
Sources/
target 마다 폴더 하나(Sources/Hello/). 폴더 이름이 곧 모듈 이름이고, 안의 .swift 파일은 따로 적지 않아도 모두 들어가요.
Tests/
시험 target(Tests/HelloTests/). @testable import Hello 로 본 모듈의 internal 까지 불러와 swift test 로 돌려요.
.build/
빌드 결과와 중간 파일. 지워도 다시 생기니 git 에는 올리지 않아요.
앱 폴더
Xcode 앱은 앱 이름 폴더에 @main 이 붙은 App 파일, 화면(Views), 모델, Assets.xcassets 를 둬요. 프로젝트 설정은 Xcode 가 만드는 .xcodeproj 가 맡아요.
Info · 서명
앱 이름, 번들 ID, 권한 안내 글은 Xcode 의 target 설정에서 정해요. 손으로 만든 설정 파일보다 Xcode 에 맡기는 편이 안전해요.
명령줄 도구의 시작 파일 이름이 main.swift 면 맨 위 코드부터 돌고, 다른 이름이면 @main 이 붙은 형식의 static func main() 에서 시작해요.
계층 나누기
입력과 출력(명령줄 인수, 화면), 규칙, 자료 보관을 나눠요. SwiftUI 앱이라면 View → ViewModel → 저장소(protocol) 차례로 부르고 거꾸로는 부르지 않아요. 이 짜임을 MVVM(Model·View·ViewModel)이라고 불러요.
View 는 그리기와 누름 받기만 하고, ViewModel 은 @Observable 클래스로 화면 상태와 동작을 맡아요. 저장소를 protocol 로 두면 시험할 때 메모리 버전으로 바꿔 끼워요.
View 는 누른 일을 ViewModel 메서드로 넘기고, 바뀐 값을 다시 그려요.
ViewModel 은 규칙을 판단해요. SwiftUI 를 import 하지 않아서 시험이 쉬워요(리눅스에서도 돌아요).
Model 은 struct 로 된 자료이고, 저장소는 protocol 뒤에 숨긴 보관 방법이에요.
이름 짓기
모듈과 target 이름은 낱말마다 첫 글자를 대문자로 써요(Hello, TodoKit). 꾸러미 이름과 명령 이름은 소문자와 - 를 사용해도 돼요(hello-app). 시험 target 은 뒤에 Tests 를 붙여요.
할 일 목록과 남은 개수는 @Observable 클래스(ViewModel)가 맡고, 화면은 그 값을 그리기만 해요. 줄을 누르면 toggle 이 불리고, 바뀐 값을 본 SwiftUI 가 그 줄과 제목을 다시 그려요. @Observable 은 iOS 17·macOS 14 부터 사용해요.
ViewModel 부분(Chore·ChoreListModel)은 SwiftUI 를 사용하지 않아서 서버에서도 돌려 봤어요. 처음 남은 일은 2개, 첫 줄을 누르면 1개예요. 그림은 처음 화면이에요.
이동 시간을 구하는 방법을 protocol 로 빼고, 부를 때 골라 넣어요. 간단한 규칙은 클로저({ km in ... })로 감싸 넣어도 돼요. some RouteStrategy 는 "이 protocol 을 따르는 어떤 형식 하나"를 받는다는 뜻이에요.
let trip = RoutePlanner(km: 3)print(trip.minutes(by: Walking()))print(trip.minutes(by: Cycling()))print(trip.minutes(by: Custom { km inInt(km * 3) + 5 }))protocolRouteStrategy {funcminutes(for km: Double) -> Int}structWalking: RouteStrategy {funcminutes(for km: Double) -> Int { Int(km * 15) }}structCycling: RouteStrategy {funcminutes(for km: Double) -> Int { Int(km * 4) }}structCustom: RouteStrategy {let rule: (Double) -> Intfuncminutes(for km: Double) -> Int { rule(km) }}structRoutePlanner {let km: Doublefuncminutes(by strategy: someRouteStrategy) -> Int { strategy.minutes(for: km) }}
실행 결과
451214
옵서버 · 일이 생기면 알려 주기
값이 바뀔 때 알릴 곳을 클로저 배열로 모아 두고 didSet 에서 차례로 불러요. 클로저를 나중에 부르려고 보관하므로 매개변수에 @escaping 을 붙여요. SwiftUI 앱에서는 @Observable 이 이 일을 맡아 화면을 다시 그려요(아래 SwiftUI 예제).