Homebrew의 공식 설치 안내는 64비트 프로세서를 요구합니다(Homebrew 설치 요구 사항). 따라서 설치를 시작하기 전에 맥의 호환성을 확인하고, Xcode를 먼저 설치해 실행한 뒤 Homebrew와 Git을 설정하세요. CocoaPods는 프로젝트에서 요구할 때만 추가하면 됩니다. 이번 주에는 첫 앱을 시뮬레이터에서 빌드하고 실행해 환경을 검증하세요.
이 안내는 맥으로 iOS 개발을 처음 시작하는 분, Xcode나 의존성 도구를 다시 설치하는 분, 로컬 또는 원격 맥에서 빌드와 실행을 확인하려는 개인 및 팀을 위한 내용입니다.
설치 전에: 맥 조건과 사용할 기기부터 확인하기
현재 맥의 macOS 버전과 여유 저장 공간을 확인한 다음, 설치하려는 Xcode의 요구 사항과 대조하세요. Xcode 버전마다 필요한 macOS 조건이 다를 수 있으므로 특정 버전이 모든 맥에서 동작한다고 가정하면 안 됩니다. 설치와 업데이트를 위해 저장 공간을 확보하고, 앱 설치나 시스템 설정 변경에 필요한 계정 권한도 점검하세요.
| 확인 항목 | 확인할 내용 | 부족하거나 맞지 않을 때 |
|---|---|---|
| macOS | 설치하려는 Xcode의 최소 요구 사항과 현재 시스템 버전 비교 | 호환되는 Xcode를 선택하거나 macOS 업데이트 가능 여부 확인 |
| 저장 공간 | Xcode 설치와 시뮬레이터 구성 요소를 받을 여유 공간 | 오래된 설치 파일과 불필요한 파일을 정리한 뒤 재확인 |
| 계정 권한 | 앱 설치와 개발 도구 구성에 필요한 권한 | 관리자에게 권한을 요청하거나 관리되는 기기의 설치 절차 확인 |
| 실행 대상 | 시뮬레이터로 시작할지 실제 기기도 연결할지 결정 | 기기 테스트가 필요하면 서명과 계정 조건을 별도로 확인 |
Apple은 Xcode 시스템 요구 사항에서 Xcode별 macOS 호환 조건을 안내합니다. 앱을 시뮬레이터에서 확인하는 것과 실제 기기에서 테스트하는 것은 준비 조건이 다릅니다. 처음 환경을 검증할 때는 시뮬레이터부터 시작하고, 실제 기기에서 서명이나 계정 관련 안내가 나타나면 Apple 개발자 계정 안내를 확인하세요. 모든 프로젝트에서 유료 계정이나 실제 기기가 필요한 것은 아닙니다.
도구별 역할: 먼저 설치할 것과 필요할 때 추가할 것
| 도구 | 맡는 역할 | 준비 시점 |
|---|---|---|
| Xcode | iOS 앱 개발, SDK와 시뮬레이터 사용, 빌드와 실행 | 가장 먼저 |
| Homebrew | 명령줄 패키지 설치와 관리 | Xcode를 시작한 뒤 |
| Git | 소스 코드 변경 이력 관리 | 프로젝트 작업 전 |
| CocoaPods | 프로젝트가 지정한 라이브러리 의존성 관리 | 프로젝트에서 요구할 때 |
Xcode는 iOS 앱을 만들고 실행하는 핵심 개발 도구입니다. Homebrew는 다른 명령줄 도구를 설치하는 역할을 하며, Git은 코드 변경 내용을 기록합니다. CocoaPods는 프로젝트 의존성을 관리하는 선택 도구입니다. 셋 다 Xcode를 대신하지 않습니다.
프로젝트에 이미 Swift Package Manager 설정이나 Podfile이 있다면 그 구성을 먼저 따르세요. 프로젝트가 쓰는 의존성 관리 방식을 임의로 바꾸면 팀 환경이나 빌드 결과가 달라질 수 있습니다.
첫 번째 단계: Xcode 설치와 최초 실행
Xcode는 Apple의 공식 배포 경로에서 설치하세요. 설치 전에 시스템 요구 사항을 대조하고, 설치가 끝나면 앱을 열어 최초 실행을 완료합니다. 추가 구성 요소 설치나 사용권 확인 메시지가 나타나면 안내를 읽고 진행하세요. 설치 화면이나 필수 구성 요소는 Xcode 버전에 따라 달라질 수 있습니다. Apple의 Xcode 공식 페이지에서 배포 안내를, 추가 구성 요소 설치 설명에서 구성 요소 관련 절차를 확인할 수 있습니다.
터미널에서 다음 명령을 실행해 도구 경로와 버전을 확인합니다.
xcode-select -p
xcodebuild -version
경로가 없거나 선택한 개발 도구가 예상과 다르면 Xcode가 설치됐는지, 최초 실행이 끝났는지부터 확인하세요. 명령줄 도구가 필요하다는 안내가 나오는 경우에는 Apple의 명령줄 도구 안내를 확인합니다. 사용권 관련 오류는 메시지를 읽고 Xcode가 요구하는 승인 절차를 마친 뒤 다시 검사하세요. 모든 상황에서 같은 설치 명령을 실행하는 방식은 피하는 편이 안전합니다.
두 번째 단계: Homebrew와 Git 설정
Homebrew는 공식 설치 문서의 현재 절차를 그대로 따르세요. 설치 방법은 바뀔 수 있으므로 출처가 불분명한 복사 명령을 사용하지 말고, 공식 안내에 제시된 확인 방법으로 설치 여부를 검증합니다. 설치가 끝났더라도 셸에서 명령을 찾지 못한다면 터미널의 경로 설정과 설치 안내를 다시 대조하세요.
Git은 터미널에서 사용할 수 있는지 먼저 확인합니다.
git --version
커밋에 표시할 이름과 이메일은 본인 또는 팀의 기준에 맞게 설정합니다.
git config --global user.name "사용자 이름"
git config --global user.email "이메일 주소"
git config --global --list
이 설정은 Git의 커밋 작성자 정보에 쓰입니다. 개인 정보 노출이 걱정된다면 프로젝트 또는 계정에서 사용할 이메일 정책을 먼저 확인하세요. Git 설치 선택지는 Git 공식 macOS 설치 안내에서 확인할 수 있습니다.
설치 선택을 가르는 조건
- Xcode 요구 사항을 현재 macOS가 충족하면 Xcode를 설치하고 최초 실행을 진행하세요. 충족하지 않으면 업데이트 가능 여부나 호환되는 Xcode를 먼저 확인하고 설치를 보류하세요.
- Homebrew로 추가 명령줄 도구를 관리할 계획이면 공식 절차에 따라 설치하세요. 필요한 패키지가 없다면 첫 앱 실행을 위해 Homebrew 설치를 억지로 추가하지 않아도 됩니다.
- 프로젝트 안내에 CocoaPods 또는 Podfile이 있으면 프로젝트가 요구하는 방식과 환경을 확인한 뒤 설치하세요. Swift Package Manager를 사용하거나 외부 의존성이 없으면 CocoaPods 설치 단계는 건너뛰세요.
- 시뮬레이터에서 앱이 빌드되고 시작되면 기본 개발 흐름을 확인한 것입니다. 실제 기기에서만 문제가 생기면 빌드 오류와 분리해 서명, 계정, 기기 연결 조건을 점검하세요.
세 번째 단계: CocoaPods는 프로젝트가 요구할 때 설정하기
먼저 프로젝트의 문서와 파일을 살펴보세요. Podfile이 있거나 프로젝트가 CocoaPods 사용을 명시하면 CocoaPods 공식 시작 안내에 따라 설치 방법을 확인합니다. 설치 전에 현재 Ruby 환경과 프로젝트의 요구 사항을 비교하세요. 환경이 맞지 않는 상태에서 관리자 권한 명령을 무작정 실행하면 권한이나 패키지 관리에 문제가 생길 수 있습니다.
프로젝트가 CocoaPods를 사용한다면 프로젝트 폴더에서 의존성 설정을 확인하고 안내에 맞춰 설치 및 갱신 절차를 진행하세요. 생성되거나 갱신된 파일이 프로젝트의 기존 설정과 일치하는지도 확인합니다. CocoaPods와 Swift Package Manager를 함께 사용하는 프로젝트도 있을 수 있지만, 의존성을 임의로 옮기거나 같은 라이브러리를 중복 추가하지 마세요. Apple의 앱 의존성 설정 안내에서는 Xcode 프로젝트에 패키지를 추가하는 방법을 설명합니다.
네 번째 단계: Xcode에서 첫 앱 빌드와 실행
Xcode에서 새 iOS 앱 프로젝트를 만들고, 템플릿으로 앱을 선택합니다. 프로젝트 이름과 저장 위치를 정하고, 실행 대상은 우선 사용 가능한 iOS 시뮬레이터로 지정하세요. 식별자와 서명 관련 선택 항목은 나중에 기기 테스트나 팀 배포에 영향을 줄 수 있으므로 프로젝트 목적에 맞게 입력합니다. Apple의 앱 프로젝트 생성 안내를 참고하면 됩니다.
| 실행 단계 | 확인할 증거 | 문제가 생기면 먼저 볼 곳 |
|---|---|---|
| 프로젝트 생성 | Xcode에서 프로젝트가 열림 | 템플릿, 저장 위치, 프로젝트 설정 |
| 대상 선택 | 사용할 시뮬레이터가 실행 대상으로 표시됨 | 필요한 시뮬레이터 구성 요소와 Xcode 설정 |
| 빌드 | 빌드가 완료되고 오류가 표시되지 않음 | 오류 메시지의 첫 원인, SDK와 의존성 설정 |
| 실행 | 시뮬레이터에서 앱이 시작됨 | 빌드 결과, 실행 대상, 앱 시작 오류 |
| 기기 검증 | 연결된 기기에서 앱이 시작됨 | 서명, 계정 권한, 기기 연결과 신뢰 설정 |
빌드가 성공해도 실행까지 확인해야 합니다. 앱이 시뮬레이터에 설치되고 시작 화면이 나타나는지 확인하세요. 실제 기기를 연결했을 때 서명 오류가 생기면 이를 Xcode 설치 실패로 단정하지 말고, 시뮬레이터 실행 결과와 분리해 살펴보세요.
설치와 첫 실행을 점검하는 순서
문제는 설치, 의존성 해석, 빌드, 실행 단계로 나눠 찾으면 원인을 좁히기 쉽습니다.
- [ ] Xcode의 시스템 요구 사항과 현재 macOS가 맞는지 확인했습니다.
- [ ] Xcode를 열어 최초 실행과 표시된 구성 요소 설치를 마쳤습니다.
- [ ]
xcode-select -p와xcodebuild -version으로 개발 도구를 확인했습니다. - [ ] Homebrew를 설치했다면 공식 안내의 확인 방법으로 상태를 검사했습니다.
- [ ] Git이 실행되고 커밋 작성자 정보가 올바르게 설정됐습니다.
- [ ] CocoaPods가 필요한 프로젝트에서만 의존성 설치와 해석을 확인했습니다.
- [ ] Xcode에서 프로젝트 빌드가 끝나고 앱이 실행됐습니다.
명령을 찾을 수 없으면 설치 여부와 셸 경로를 살펴보세요. 의존성 오류라면 프로젝트가 지정한 도구와 버전 조건, 생성 파일을 확인하세요. 빌드 오류는 로그에서 처음 나타난 원인부터 읽고, 실행 오류는 선택한 시뮬레이터와 앱 설정을 따로 점검합니다. Xcode 관련 설치 문제와 사용 조건은 도움말 센터에서 확인할 수 있습니다.
자주 묻는 질문
Xcode를 설치한 뒤 무엇을 먼저 확인해야 하나요?
현재 macOS와 Xcode의 호환 조건을 대조하고, Xcode를 한 번 실행해 최초 구성을 끝내세요. 그런 다음 터미널에서 개발 도구 경로와 버전을 확인합니다. 첫 프로젝트를 만들어 빌드와 시뮬레이터 실행까지 성공해야 실제 개발 환경이 준비됐다고 판단할 수 있습니다.
Homebrew와 Git은 어떤 순서로 설정하나요?
Xcode 설치와 최초 실행을 마친 뒤 Homebrew 공식 안내에 따라 설치하고, Git 명령이 실행되는지 확인합니다. Git에는 커밋에 사용할 이름과 이메일을 설정하세요. Homebrew는 패키지를 관리하고 Git은 코드 변경 이력을 관리하므로 역할이 다릅니다.
CocoaPods는 모든 프로젝트에 필요한가요?
아닙니다. 프로젝트 문서와 기존 의존성 설정을 먼저 확인하세요. CocoaPods를 지정한 프로젝트라면 해당 프로젝트의 환경 조건을 살펴 설치하고 의존성을 해석합니다. Swift Package Manager를 쓰거나 외부 라이브러리가 없는 프로젝트라면 추가 설치를 건너뛰어도 됩니다.
첫 앱은 어떤 방식으로 실행하는 것이 좋나요?
우선 Xcode에서 iOS 앱 프로젝트를 만들고, 실행 대상으로 사용할 수 있는 시뮬레이터를 선택하세요. 빌드 완료뿐 아니라 시뮬레이터에서 앱이 실제로 시작되는지도 확인해야 합니다. 실제 기기 테스트는 서명이나 계정 조건이 추가될 수 있으므로 기본 환경 검증과 분리해 진행하세요.
맥을 직접 쓰면 설치 공간과 계정 권한을 관리하기 쉽지만, 사용 가능한 기기가 없거나 팀 공용 환경이 필요하면 별도 준비와 유지 관리가 부담이 될 수 있습니다. 원격 개발 환경은 연결 상태와 제공되는 도구 조건을 먼저 확인해야 하며, 물리 기기 연결이 꼭 필요하거나 장기간 같은 맥을 계속 써야 한다면 직접 보유하는 편이 나을 수 있습니다. 현재 사용할 맥이 없다면 Hashvps의 환경 및 이용 조건을 살펴보고, Xcode 설치부터 빌드와 시뮬레이터 실행까지 이 안내의 검증 항목을 충족하는지 확인한 뒤 선택하세요.
FAQ
아이오에스 개발을 위한 맥 환경이 필요하신가요?
Hashvps의 맥 미니 엠포 클라우드를 대여해 실제 맥 환경에서 앱을 빌드하고 서명해 보세요.
원격 데스크톱과 명령줄 접속을 지원해 장소에 구애받지 않고 개발과 유지 관리를 이어갈 수 있습니다.