Xcode는 macOS, iOS 등 애플 생태계 전반의 앱을 만들기 위해 개발자들이 사용하는 필수 도구입니다.
이 가이드에서는 Mac에 Xcode를 처음부터 끝까지 성공적으로 설치하는 방법을 단계별로 안내해 드립니다.
시작하기 전에 알아두면 좋은 팁은 다음과 같습니다.
- Xcode는 Mac에서만 실행됩니다. PC를 사용 중이라면 아쉽지만 Xcode를 사용할 수 없습니다.
- 안정적인 인터넷 연결이 필요합니다. 최신 버전의 용량은 약 8GB입니다.
- 최소 30GB 이상의 여유 저장 공간을 확보하세요. 최신
.xip파일(작성 시점 기준 v11.4.1)은 압축 상태로 약 8GB이며, 압축을 풀면 추가로 17GB가 필요합니다. 여기에 커맨드 라인 도구까지 더하면 또 1.5GB가 소요됩니다.
Xcode 설치 과정 한눈에 보기
- Xcode 다운로드
- 커맨드 라인 도구(CLT) 설치
- 새 버전 실행
- 불필요한 파일 삭제
아래 단계에는 터미널 명령어 일부가 포함되어 있습니다. 이 명령어들은 현재 작업 디렉터리에서 바로 입력할 수 있으므로 특정 폴더로 이동할 필요가 없습니다.
원한다면 명령어를 입력하기 전에 먼저 cd를 입력하세요. 그러면 홈 폴더로 이동하게 됩니다.
1단계: Xcode 다운로드
다운로드 방법은 두 가지입니다. 최신 버전과 비교적 '간편한' 설치를 원하면 App Store를 이용할 수 있지만, 저는 이 방법을 추천하지 않습니다.
저는 개발자 사이트를 이용하는 것을 선호합니다. 원하는 버전을 자유롭게 골라 다운로드할 수 있다는 장점도 있습니다.
방법 1: App Store를 통해 최신 버전 다운로드 (비추천)
이론상 매끄럽고 문제없는 과정처럼 보이지만, 마지막 단계에서 어떤 이유로든 설치가 실패하면 원인 파악이 매우 어렵습니다.
실패 원인은 여러 가지일 수 있는데, 어떤 것이 근본 원인인지 쉽게 알 방법이 없습니다. 게다가 실패를 해결하려고 시도할 때마다 전체 파일(약 8GB)을 다시 내려받아야 하므로 이 방식은 그다지 즐겁지 않습니다.
그래도 시도해 보고 싶다면 아래 순서대로 진행하세요.
- Mac에서 App Store 열기
- 로그인
- Xcode 검색
- 설치 또는 업데이트 클릭
방법 2: 개발자 사이트를 통해 특정 버전 다운로드 (추천)
- 애플 개발자 웹사이트의 'more' 섹션으로 이동합니다.
- iTunes 계정 ID로 로그인합니다.
- 원하는 버전을 검색해
Xcode_x_x_x.xip파일을 다운로드합니다. Xcode 11.4.1 기준 약 8GB이므로 인터넷 속도에 따라 시간이 다소 걸릴 수 있습니다. - 다운로드가 완료되면
.xip파일을 클릭해 압축을 해제합니다. 노트북이 다운로드한 동일한 폴더에 자동으로 압축을 풀어주며, 별도 작업은 필요 없습니다. 이 과정은 몇 분 정도 걸립니다. - [선택 사항] 여러 버전을 함께 사용한다면 압축 해제 후 앱 이름을 'Xcode11.x.x' 형태로 변경해 구분합니다.
- 앱을 응용 프로그램(Applications) 폴더로 드래그합니다.
- [선택 사항] 새 Xcode 버전을 기본값으로 설정합니다. 터미널을 열고
sudo xcode-select -switch /Applications/Xcodex.x.x.app를 입력합니다.x.x.x부분은 실제 버전 번호(예:Xcode11.4.1.app)로 교체합니다. 관리자 비밀번호 입력이 필요하며, 이 설정은 컴퓨터의 모든 사용자에게 적용될 수 있으니 다른 사용자와 미리 확인하는 것이 좋습니다.
2단계: 커맨드 라인 도구(CLT) 설치
컴퓨터에 여러 사용자 계정이 있다면 각 사용자마다 CLT를 업데이트해야 합니다.
.dmg 파일 다운로드
CLT를 업데이트하려면 개발자 웹사이트에 접속해 커맨드 라인 도구 .dmg 파일을 다운로드합니다.
이전에 Xcode를 설치한 적이 없다면 개발자 사이트 대신 터미널에 xcode-select --install을 입력해 설치할 수 있습니다.
하지만 이미 Xcode가 설치되어 있는 경우에는 아래와 같은 오류가 나타날 수 있습니다.
xcode-select: error: command line tools are already installed, use “Software Update” to install updates이런 경우에는 개발자 웹사이트를 이용해야 합니다.
CLT 설치하기
.dmg 다운로드가 완료되면 파일을 더블클릭해 엽니다. 그러면 아래와 같은 작은 창이 나타납니다.
창 안의 박스를 더블클릭하고 안내에 따라 CLT를 설치합니다. 완료까지 몇 분 정도 걸립니다.
설치가 끝나면 이 파일을 휴지통으로 옮길지 묻는 메시지가 뜰 수 있습니다. 이는 더 이상 필요 없는 .dmg 파일을 의미하므로 안심하고 '예'를 선택해도 됩니다.
3단계: Xcode 실행
응용 프로그램 폴더를 열고 새 버전의 Xcode를 실행합니다. 이름을 변경했다면 올바른 앱을 실행했는지 꼭 확인하세요.
Xcode가 추가 구성 요소 설치를 요청하면 '설치'를 클릭합니다. 몇 분 정도 소요됩니다.
설치가 진행되는 동안 기본 Xcode 버전이 방금 다운로드한 버전인지 확인합니다.
- 터미널을 엽니다.
brew config를 입력합니다.- 'CLT'와 'Xcode' 버전 정보가 표시되며, 방금 다운로드한 버전과 일치해야 합니다. 예를 들어 Xcode 11.4.1을 설치한 경우 아래와 같습니다.
CLT: 11.4.1.0.1.1586360307
Xcode: 11.4.1 => /Applications/Xcode11.4.1.app/Contents/Developer구성 요소 설치가 완료되면 Xcode가 실행됩니다. 기존 프로젝트를 그대로 이어서 작업할 수 있습니다.*
*참고: Charles 같은 프록시 도구를 사용 중이라면 시뮬레이터에 인증서를 다시 설치해야 합니다.
프로젝트를 빌드하거나 실행하는 중 오류가 발생하면 어떤 기기로 실행하려 하는지 확인하세요. 새 버전이 이전에 사용하던 기기를 기억하지 못할 수 있습니다. 이때는 해당 기기를 클릭하고 드롭다운 메뉴에서 "Add additional simulators"를 선택해 원하는 기기를 추가하면 됩니다.
4단계: 불필요한 파일 삭제
오래된 Xcode 버전이 더 이상 필요 없다면 제거해서 하드 드라이브 공간을 확보할 수 있습니다.
방금 다운로드한 버전의 .xip 파일과 CLT.dmg 파일도 함께 삭제하면 됩니다.
여기까지가 전부입니다. 이 가이드가 Xcode 설치에 도움이 되었기를 바랍니다. 즐거운 개발 되세요!