터미널에서 swift --version을 실행해도 수업에서 쓰는 버전인지 헷갈리나요?
먼저 현재 맥이 사용하는 Swift 도구 모음을 확인하세요. 그다음 Swift Package Manager 템플릿으로 작은 라이브러리나 실행형 프로그램을 만들고 빌드와 테스트를 확인하면 됩니다. Swift 6.4가 개발 스냅샷으로 표시된다면 정식 과제 환경을 바꾸지 말고 별도 연습 프로젝트에서 시험하세요.
Swift를 처음 배우며 처음으로 빌드 가능한 프로젝트를 만들어야 하는 학생에게 알맞은 안내입니다.
윈도우나 학교 컴퓨터를 쓰면서 수업에 맥 환경이 필요한 학생은 원격 맥을 사용할 시점도 함께 판단할 수 있습니다.
특정 버전으로 수업을 듣는 학생은 도구 모음부터 확인해 과제 환경과 연습 환경이 섞이지 않게 하세요.
마지막 확인: 2026년 10월 5일. Swift.org의 맥 설치 안내와 스냅샷 표시, Swift Package 입문 문서, 애플의 명령줄 도구 안내를 기준으로 확인했습니다.
[ SECTION_01 ] 먼저 고를 것: 패키지 연습인지 앱 프로젝트인지
Swift Package는 Swift 코드를 정리하고 빌드하거나 테스트하는 단위입니다. Package.swift는 프로젝트 안내서처럼 패키지의 구성과 설정을 설명합니다. 공식 패키지 문서에 나온 역할처럼 코드를 묶어 관리하는 데 쓸 수 있지만, 화면을 갖춘 아이폰 앱 프로젝트와 같은 것은 아닙니다.
| 수업에서 하려는 일 | 시작할 프로젝트 | 초보자 적합도 |
|---|---|---|
| 터미널에서 결과를 출력하는 작은 프로그램 | 실행형 패키지 | 높음 |
| 다른 코드에서 가져다 쓸 기능을 만드는 연습 | 라이브러리 패키지 | 높음 |
| 화면, 앱 설정, 시뮬레이터 실행이 필요한 과제 | 수업에서 지정한 앱 프로젝트 | 패키지만으로는 부족 |
선택 점수: 목표가 명령줄 연습이나 재사용 코드 만들기라면 패키지 템플릿이 잘 맞습니다. 과제에서 앱 화면이나 Xcode 프로젝트를 요구한다면 그 지시가 우선입니다. Swift.org의 명령줄 프로젝트 안내와 라이브러리 만들기 안내는 두 흐름을 나누어 설명합니다.
[ SECTION_02 ] 첫 단계: 터미널이 쓰는 도구 모음 확인
Swift 도구 모음은 코드를 읽고 빌드하는 도구 상자입니다. Swift Package Manager는 그 도구 상자를 이용해 패키지의 파일 구성, 빌드, 테스트를 다룹니다. 두 용어가 비슷해 보여도 하는 일은 다릅니다.
터미널을 열고 다음 명령을 실행합니다.
swift --version
출력된 버전 정보를 수업에서 지정한 버전과 비교하세요. 맥에 Xcode가 설치되어 있다면 Xcode에 들어 있는 도구를 사용하도록 설정했을 수도 있습니다. Apple은 Xcode 명령줄 도구가 명령줄 개발 작업에 쓰이는 도구를 제공한다고 설명합니다. 설치된 도구를 확인할 때는 Apple의 명령줄 도구 설명도 참고하세요.
Swift.org의 맥 설치 안내는 2026년 10월 5일 기준으로 release/6.4.x를 개발 스냅샷 영역에 표시하며, 스냅샷은 정식 배포판이 아닙니다. 해당 안내에서 현재 표시를 확인할 수 있습니다. 그러므로 6.4 도구 모음을 발견했다고 해서 수업이나 제출 환경과 호환된다고 단정하면 안 됩니다. 수업에서 정한 버전을 우선하고, 별도 시험이 필요하면 과제 파일과 분리된 연습 폴더에서 확인하세요.
학교에서 관리하는 맥이나 원격 환경이라면 설치 권한을 얻기 위해 제한을 우회하지 마세요. 이미 쓸 수 있는 Xcode 도구 모음이 있는지 확인하고, 없다면 담당자에게 허용된 환경을 문의하세요.
[ SECTION_03 ] 두 번째 단계: 템플릿으로 패키지 만들기
프로젝트를 둘 폴더를 정한 다음 터미널에서 그 폴더로 이동합니다. cd 뒤에는 실제로 사용할 경로를 입력합니다. 아래 예시는 새 프로젝트 폴더를 만들고 실행형 패키지를 초기화하는 흐름입니다.
mkdir SwiftPractice
cd SwiftPractice
swift package init --type executable
executable은 터미널에서 실행할 수 있는 프로그램을 만들겠다는 선택입니다. 라이브러리 연습이라면 같은 위치에서 다음 초기화 명령을 사용합니다.
swift package init --type library
명령과 템플릿의 목적은 Swift.org의 패키지 생성 안내에 설명되어 있습니다. 실행형은 실행할 코드가 들어갈 소스 파일을, 라이브러리는 다른 코드가 사용할 모듈의 소스와 테스트에 필요한 파일을 만듭니다. 세부 파일명은 템플릿과 도구 모음에 따라 확인하고, 처음에는 생성된 구조를 그대로 살펴보세요.
| 확인할 항목 | 실행형 패키지 | 라이브러리 패키지 |
|---|---|---|
| 주된 목적 | 작은 프로그램을 실행 | 재사용할 코드 모듈을 구성 |
| 첫 확인 방법 | 빌드 후 실행 | 빌드 후 테스트 |
| 살펴볼 파일 | 생성된 소스 파일과 Package.swift | 소스 파일, Package.swift, 테스트 파일 |
| 초보자 주의점 | 실행 코드를 직접 바꿔 결과 확인 | 테스트가 어떤 동작을 확인하는지 읽기 |
Swift Package Manager가 폴더를 만든 뒤에는 Package.swift를 열어 프로젝트 안내 내용을 확인합니다. 처음부터 의존성 추가나 복잡한 설정을 할 필요는 없습니다.
[ SECTION_04 ] 세 번째 단계: 생성된 코드 한 부분만 바꾸기
생성된 소스 파일을 열고, 템플릿이 만든 예제 코드를 작은 동작으로 바꿔 봅니다. 실행형이라면 문장을 출력하거나 간단한 계산 결과를 보여 주는 정도면 충분합니다. 라이브러리라면 함수 하나의 입력과 결과를 정하고, 기존 테스트가 무엇을 확인하는지 살펴보세요.
파일을 저장하기 전에 편집기에서 열린 위치를 확인하세요. 원격 맥으로 접속해 작업 중이라면 수정 대상은 원격 맥의 프로젝트 폴더입니다. 로컬 윈도우에 따로 내려받은 복사본을 바꾸면 원격 프로젝트에는 수정 사항이 반영되지 않습니다.
[ SECTION_05 ] 네 번째 단계: 빌드하고 유형에 맞게 확인
먼저 패키지 폴더에서 빌드합니다.
swift build
빌드가 성공하면 현재 소스가 컴파일 가능한지 확인한 것입니다. 실행형 패키지는 다음 명령으로 실행 결과를 살펴봅니다.
swift run
라이브러리 패키지는 테스트를 실행합니다.
swift test
Swift.org의 테스트 안내는 패키지 테스트 방법을 설명합니다. 성공 여부는 터미널의 종료 메시지와 실행 결과로 확인하세요. 라이브러리 테스트는 테스트가 실행되고 통과했는지 결과를 살펴봅니다.
오류가 나오면 모든 원인을 버전 문제로 돌리지 마세요. 아래 순서로 확인하면 놓치는 항목을 줄일 수 있습니다.
- [ ] 터미널이 프로젝트 폴더에 있는지 확인합니다.
- [ ]
Package.swift가 현재 폴더에 있는지 살펴봅니다. - [ ]
swift --version결과를 수업에서 요구한 버전과 대조합니다. - [ ] 실행형에는
swift run, 라이브러리에는swift test를 사용했는지 확인합니다. - [ ] 마지막으로 수정한 파일이 원격 맥의 프로젝트 안에 저장되어 있는지 확인합니다.
[ SECTION_06 ] 연습을 보관하고 다음 작업으로 넘어가기
과제 제출 전에는 수업에서 요구한 파일을 남기고 프로젝트 폴더를 정리하세요. Package.swift와 소스 파일, 테스트 파일을 구분해 두면 다음에 열었을 때 각 파일의 역할을 파악하기 쉽습니다. 새 의존성을 추가하거나 설정을 바꾸는 작업은 기본 빌드와 테스트가 통과한 다음에 진행하는 편이 안전합니다.
처음 패키지를 만들 때 자주 막히는 부분
현재 Swift 버전이 수업 요구와 다르면 새 도구 모음을 바로 설치해야 하나요?
먼저 수업에서 요구하는 환경이 Xcode 도구 모음인지 독립 도구 모음인지 확인합니다. 학교 기기의 설치 제한도 살펴야 합니다. 이미 설정된 도구를 여러 개 바꾸기보다 담당자에게 허용된 환경을 확인하세요.
테스트가 통과하지 않아도 실행 결과가 나오면 과제를 끝내도 되나요?
과제의 평가 기준에 테스트가 포함되어 있다면 실행 결과만으로 완료했다고 판단할 수 없습니다. 실행형과 라이브러리는 확인 방식이 다르므로, 수업에서 요구한 항목을 각각 확인하세요.
언제 Xcode가 필요한가요?
터미널에서 Swift 코드를 빌드하고 테스트하는 연습만 한다면 패키지 템플릿으로 시작할 수 있습니다. 앱 화면, 시뮬레이터 또는 Xcode 프로젝트 파일을 요구하는 과제라면 해당 수업의 Xcode 작업 환경이 필요합니다.
현재 컴퓨터에서 패키지를 빌드하고 테스트할 수 있다면 그 환경에서 수업을 이어가면 됩니다. macOS나 Xcode가 필요한 과제인데 쓸 수 있는 맥이 없다면 먼저 원격 맥 환경과 대여 방식을 확인하세요. 원격 작업은 새 맥을 바로 구매하지 않고 과제 환경을 마련하는 선택지가 될 수 있지만, 지속적인 고부하 작업이나 물리 장치 연결이 필요한 경우에는 적합하지 않을 수 있습니다. 조건이 맞는지 확인한 뒤 NOVAKVM에서 이용 가능한 환경을 살펴보고 결정하세요.
자주 묻는 질문
Swift 6.4에서 첫 Swift Package를 만들려면 어떤 순서로 진행하나요?
먼저 터미널에서 swift --version을 실행해 현재 명령줄이 사용하는 도구 모음을 확인합니다. 수업에서 요구하는 버전과 맞는지 비교한 뒤 빈 연습 폴더에서 swift package init --type executable 또는 swift package init --type library를 실행합니다. 생성된 파일을 확인하고 swift build로 빌드한 다음, 실행형 프로젝트는 swift run, 라이브러리는 swift test로 확인합니다. 6.4가 개발 스냅샷으로 표시된다면 정식 과제 환경을 바로 바꾸지 말고 별도 연습 프로젝트에서 먼저 시험합니다.
Swift Package Manager로 새 스위프트 프로젝트를 만들 때 실행형과 라이브러리 중 무엇을 골라야 하나요?
터미널에서 바로 실행할 작은 프로그램을 만들려면 실행형 템플릿을 선택합니다. 다른 코드에서 가져다 쓸 기능이나 모듈을 연습하려면 라이브러리 템플릿이 알맞습니다. 두 유형 모두 Package.swift라는 프로젝트 안내 파일을 만들지만, 소스와 테스트 파일의 배치는 템플릿에 따라 달라질 수 있습니다. 화면과 앱 생명주기를 포함한 아이폰 앱 과제라면 일반 패키지와 앱 프로젝트를 같은 것으로 생각하지 말고 수업에서 Xcode 프로젝트를 지정했는지 먼저 확인합니다.
맥에서 실제로 사용 중인 Swift 버전은 어디서 확인하나요?
터미널을 열고 swift --version을 실행하면 현재 경로에서 실행되는 Swift의 버전 정보를 확인할 수 있습니다. 표시된 값이 설치한 버전이라고 단정하지 말고, 수업이 지정한 Xcode 또는 별도 도구 모음과 일치하는지 대조합니다. 명령을 실행할 수 없거나 예상과 다른 결과가 나오면 설치를 여러 개 더하기 전에 현재 터미널과 선택된 개발 도구 환경부터 확인합니다. 학교 기기에서는 관리 정책을 우회하지 말고 담당자에게 사용 가능한 도구 모음을 문의합니다.
패키지를 만든 다음 실행과 테스트가 실패하면 무엇부터 살펴봐야 하나요?
먼저 터미널의 현재 폴더가 Package.swift가 있는 프로젝트 폴더인지 확인합니다. 다음으로 swift --version 결과와 수업에서 요구한 버전을 비교하고, 생성한 유형에 맞는 명령을 골랐는지 확인합니다. 실행형은 swift run으로 실행하고 라이브러리는 swift test로 테스트합니다. 오류가 난 명령과 메시지를 그대로 기록하면 원인을 좁히기 쉽습니다. 버전 문제라고 미리 단정하지 말고, 파일을 다른 컴퓨터에 저장했거나 테스트 코드가 수정된 경우도 함께 점검합니다.