주문부터 연결까지 약 4분

Xcode 및 명령줄 도구 확인

현재 Xcode 버전과 프로젝트 요구 사항을 확인하세요. 설치하거나 버전을 전환해야 한다면 정식 경로로 제공되는 설치 패키지를 사용하고, 설치 후 개발 도구 경로가 사용할 버전을 가리키는지 확인하세요.

명령줄 도구에는 컴파일러와 일반적인 의존성이 포함되지만 전체 Xcode를 대체하지는 않습니다. 시뮬레이터, archive, SDK를 사용하려면 전체 개발 환경도 별도로 확인하세요.

xcodebuild -version
xcode-select -p
xcrun --find clang
xcrun simctl list devices available

버전과 사용 가능한 기기를 먼저 확인한 뒤 프로젝트를 실행하세요.

Homebrew 및 의존성 준비

먼저 command -v brew 를 실행해 설치 여부를 확인하세요. 설치되어 있지 않다면 Homebrew의 공식 설치 안내를 따르고 출처가 불분명한 설치 스크립트는 실행하지 마세요.

터미널에서 사용하는 아키텍처와 경로를 확인한 뒤 프로젝트 의존성을 설치하세요. 팀 프로젝트에서는 기존 의존성 목록과 잠금 파일을 우선 사용해 대여할 때마다 다른 버전이 설치되지 않도록 하세요.

command -v brew
brew --version
git --version
ruby --version

해당 도구가 설치된 경우에만 버전 확인 명령을 실행하세요.

서명 인증서 및 권한 설정

팀에서 승인한 안전한 경로를 통해 서명 인증서와 프로비저닝 프로파일을 가져오세요. 이번 작업에 필요한 권한만 부여하고 인증서 암호는 접근이 통제된 비밀 정보 관리 절차에 보관하세요. 코드 저장소에는 기록하지 마세요.

수동으로 서명 빌드를 한 번 완료하고 인증서 유효 기간, 대상 식별자, 프로비저닝 프로파일이 일치하는지 확인하세요. 자동화 실행이 실패하면 컴파일 문제인지 서명 권한 문제인지 먼저 구분하세요.

프로젝트가 끝나면 더 이상 필요하지 않은 인증서 사본과 임시 파일을 정리하세요.

Fastlane 및 runner 확인

프로젝트에 Gemfile이 있다면 잠금 파일에 지정된 버전으로 의존성을 설치하고 bundle exec fastlane 으로 기존 lane을 실행하세요. 자동화 트리거를 켜기 전에 로컬 빌드를 먼저 완료하세요.

runner의 작업 디렉터리와 동시 실행 수를 명확하게 설정하세요. 빌드 출력에 비밀 키, 비밀번호, 서명 자료가 노출되지 않는지 확인한 뒤 성공한 산출물을 자체 저장소로 동기화하세요.

bundle install
bundle exec fastlane --version
bundle exec fastlane lanes

이 명령은 Gemfile과 Fastlane이 이미 설정된 프로젝트에서 사용하세요.