도구
로그인
한국어

코드 배우기Swift

Swift 프로젝트 구조 잡기

Swift 6.4 기준

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-tools-version: 6.0import PackageDescription let package = Package(    name: "hello-app",    products: [        .executable(name: "hello-app", targets: ["HelloCLI"]),    ],    targets: [        .target(name: "Hello"),        .executableTarget(name: "HelloCLI", dependencies: ["Hello"]),        .testTarget(name: "HelloTests", dependencies: ["Hello"]),    ])

계층 그림

적어 둔 버전 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 를 붙여요.

  • 형식(struct·class·enum·protocol)은 UpperCamelCase(TaskItem), 변수·함수·매개변수는 lowerCamelCase(leftCount)예요.
  • protocol 이름은 할 수 있는 일이면 -able(Equatable), 무엇인지면 명사(TaskStore)로 지어요.
  • Swift, Foundation, SwiftUI, XCTest 처럼 이미 있는 모듈 이름은 피해요. 같은 이름이면 import 가 헷갈려요.

SwiftUI 화면 예제

SwiftUI 는 애플 기기(iPhone·iPad·Mac)에서 도는 화면 틀이에요. 서버(리눅스)에는 SwiftUI 가 없어서 이 예제들은 실행하지 않았고, 결과 칸 대신 화면이 어떻게 보일지 직접 그린 그림을 붙였어요. 코드 문법은 Swift 6.4 로 확인했어요.

@State · 누르면 바뀌는 화면

@State 가 붙은 값이 바뀌면 SwiftUI 가 body 를 다시 불러 화면을 새로 그려요. 단추는 cups 값만 바꾸고, 글자나 막대를 고치는 코드는 따로 없어요.

#Preview 는 Xcode 의 미리 보기 칸에 이 화면을 띄우는 표시예요. 그림은 +1 cup 을 세 번 누른 뒤 모습이에요.

import SwiftUI struct WaterView: View {    @State private var cups = 0    let goal = 8     var body: some View {        VStack(spacing: 16) {            Text("Water today")                .font(.headline)            Text("\(cups) / \(goal) cups")                .font(.largeTitle.bold())            ProgressView(value: Double(cups), total: Double(goal))            HStack {                Button("Reset") {                    cups = 0                }                .buttonStyle(.bordered)                Button("+1 cup") {                    cups = min(cups + 1, goal)                }                .buttonStyle(.borderedProminent)            }        }        .padding()    }} #Preview {    WaterView()}
물 마시기 화면 그림: Water today 제목, 3 / 8 cups, 막대, Reset 과 +1 cup 단추
이렇게 보여요(그린 그림)

@Observable · ViewModel 과 화면 나누기(MVVM)

할 일 목록과 남은 개수는 @Observable 클래스(ViewModel)가 맡고, 화면은 그 값을 그리기만 해요. 줄을 누르면 toggle 이 불리고, 바뀐 값을 본 SwiftUI 가 그 줄과 제목을 다시 그려요. @Observable 은 iOS 17·macOS 14 부터 사용해요.

ViewModel 부분(Chore·ChoreListModel)은 SwiftUI 를 사용하지 않아서 서버에서도 돌려 봤어요. 처음 남은 일은 2개, 첫 줄을 누르면 1개예요. 그림은 처음 화면이에요.

import SwiftUIimport Observation struct Chore: Identifiable {    let id = UUID()    let title: String    var done = false} @Observablefinal class ChoreListModel {    var chores = [        Chore(title: "Water plants"),        Chore(title: "Take out trash", done: true),        Chore(title: "Feed the cat"),    ]     var left: Int {        chores.filter { !$0.done }.count    }     func toggle(_ chore: Chore) {        guard let i = chores.firstIndex(where: { $0.id == chore.id }) else {            return        }        chores[i].done.toggle()    }} struct ChoreListView: View {    @State private var model = ChoreListModel()     var body: some View {        NavigationStack {            List(model.chores) { chore in                Button {                    model.toggle(chore)                } label: {                    Label(chore.title, systemImage: chore.done ? "checkmark.circle.fill" : "circle")                }            }            .navigationTitle("Chores (\(model.left) left)")        }    }}
집안일 목록 화면 그림: Chores (2 left) 제목, Water plants, Take out trash(완료 표시), Feed the cat 세 줄
이렇게 보여요(그린 그림)

자주 사용하는 설계 꼴 넷과 의존성 주입

이름보다 언제 사용하는지가 중요해요. 모두 Swift 6.4 로 컴파일하고 돌려 본 코드예요.

싱글톤 · 하나만 있어야 할 때

앱 설정처럼 프로그램 전체에 하나만 있어야 하는 객체에 사용해요. init 을 private 으로 막고 static let shared 로만 꺼내요. static let 은 처음 사용할 때 한 번만, 여러 작업에서도 안전하게 만들어져요.

Swift 6 에서는 바뀌는 상태를 가진 싱글톤에 @MainActor 를 붙여 메인 작업에서만 만지게 해요. 시험하기 어려워지니 필요한 곳에만 사용해요.

Settings.shared.theme = "dark"let again = Settings.sharedprint(again.theme)print(again === Settings.shared) @MainActorfinal class Settings {    static let shared = Settings()     var theme = "light"     private init() {}}

실행 결과

darktrue

팩토리 · 무엇을 만들지 한 곳에서 정할 때

파일 확장자를 보고 알맞은 저장 객체를 골라 주는 static func 예요. 모르는 확장자는 throw 로 알려요. 부르는 쪽은 any PhotoSaver 라는 것만 알아요. 만들기 함수만 모아 둘 때는 case 없는 enum 을 이름 묶음으로 사용해요.

for file in ["cover.png", "trip.jpg", "scan.gif"] {    do {        let saver = try SaverFactory.make(for: file)        print("\(file): \(saver.describe())")    } catch {        print("\(file): \(error)")    }} protocol PhotoSaver {    func describe() -> String} struct PNGSaver: PhotoSaver {    func describe() -> String { "lossless" }} struct JPEGSaver: PhotoSaver {    let quality: Int     func describe() -> String { "quality \(quality)" }} enum SaverError: Error {    case unknown(String)} enum SaverFactory {    static func make(for file: String) throws -> any PhotoSaver {        let ext = file.split(separator: ".").last.map(String.init) ?? ""        switch ext {        case "png":            return PNGSaver()        case "jpg", "jpeg":            return JPEGSaver(quality: 80)        default:            throw SaverError.unknown(ext)        }    }}

실행 결과

cover.png: losslesstrip.jpg: quality 80scan.gif: unknown("gif")

전략 · 바꿔 끼우는 계산 방법

이동 시간을 구하는 방법을 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 in Int(km * 3) + 5 })) protocol RouteStrategy {    func minutes(for km: Double) -> Int} struct Walking: RouteStrategy {    func minutes(for km: Double) -> Int { Int(km * 15) }} struct Cycling: RouteStrategy {    func minutes(for km: Double) -> Int { Int(km * 4) }} struct Custom: RouteStrategy {    let rule: (Double) -> Int     func minutes(for km: Double) -> Int { rule(km) }} struct RoutePlanner {    let km: Double     func minutes(by strategy: some RouteStrategy) -> Int {        strategy.minutes(for: km)    }}

실행 결과

451214

옵서버 · 일이 생기면 알려 주기

값이 바뀔 때 알릴 곳을 클로저 배열로 모아 두고 didSet 에서 차례로 불러요. 클로저를 나중에 부르려고 보관하므로 매개변수에 @escaping 을 붙여요. SwiftUI 앱에서는 @Observable 이 이 일을 맡아 화면을 다시 그려요(아래 SwiftUI 예제).

let room = Thermostat()room.onChange { print("display: \($0) C") }room.onChange { print("log: changed to \($0)") }room.target = 22 final class Thermostat {    private var listeners: [(Int) -> Void] = []     var target = 20 {        didSet {            listeners.forEach { $0(target) }        }    }     func onChange(_ listener: @escaping (Int) -> Void) {        listeners.append(listener)    }}

실행 결과

display: 22 Clog: changed to 22

의존성 주입 · 필요한 것을 밖에서 받기

Greeter 는 시계를 직접 만들지 않고 init 으로 받아요. 앱에서는 기기 시계를, 시험에서는 늘 같은 시각을 주는 가짜(FixedClock)를 넣어 아침과 오후 인사를 확인해요.

SwiftUI 에서는 이렇게 받은 객체를 .environment(...) 로 화면 나무 아래쪽에 넘기기도 해요.

let morning = Greeter(clock: FixedClock(fixed: 9))let later = Greeter(clock: FixedClock(fixed: 15))print(morning.greet("Mina"))print(later.greet("Mina")) protocol Clock {    func hour() -> Int} struct FixedClock: Clock {    let fixed: Int     func hour() -> Int { fixed }} struct Greeter {    let clock: any Clock     func greet(_ name: String) -> String {        clock.hour() < 12 ? "Good morning, \(name)" : "Good afternoon, \(name)"    }}

실행 결과

Good morning, MinaGood afternoon, Mina

확인 문제

문제 1

git 에 올리지 않는 폴더는?

답과 까닭 보기

답: 3. .build/ .build/ 는 swift build 가 만드는 결과물이에요. .gitignore 에 넣어 두고, 받은 사람은 다시 빌드해요.

문제 2

Swift 꾸러미에서 import 뒤에 적는 모듈 이름은 무엇으로 정해지나요?

답과 까닭 보기

답: 1. target 이름(= Sources 아래 폴더 이름) target 이름이 모듈 이름이고, 그 target 의 코드는 Sources/<target 이름>/ 에 둬요. 꾸러미 이름(hello-app)은 꾸러미 전체를 부르는 이름일 뿐이에요.

자주 묻는 것

받은 zip 은 어떻게 빌드하나요?

명령줄 도구와 라이브러리는 맨 위 폴더에서 swift build, 시험은 swift test 예요. 명령줄 도구는 swift run 이름 mina 처럼 돌려요. 자세한 명령은 zip 안 README.md 에 있어요.

SwiftUI 앱 zip 에는 왜 .xcodeproj 가 없나요?

Xcode 프로젝트 파일은 Xcode 가 만들 때 가장 안전해서 넣지 않았어요. Xcode 에서 새 App 프로젝트를 만든 뒤 zip 의 파일을 끌어다 넣으면 돼요. 차례는 README.md 에 적었어요.

요즘 꼴과 예전 꼴 중 무엇을 고르나요?

새로 시작하면 요즘 꼴(Swift 6, Swift Testing, @Observable)이 맞아요. 예전 꼴(Swift 5, XCTest, ObservableObject)은 iOS 16 을 받아야 하거나 오래된 코드와 맞춰야 할 때 골라요.