fastlane snapshot으로 iOS 스토어 스크린샷 자동 생성하는 방법? 2026

스크린샷을 언어별로 다시 찍고 파일을 손으로 정리하느라 시간이 걸립니다.
먼저 대표 UI 테스트를 Xcode에서 안정적으로 실행한 뒤 fastlane snapshot으로 수집하고, 결과를 직접 검수하세요. 이 과정에는 macOS와 Xcode, iOS 시뮬레이터를 실행할 수 있는 맥이 필요합니다.

여러 언어의 스토어 소재를 반복해서 준비하는 독립 개발자라면 자동화할 지점을 찾을 수 있습니다.
여러 시뮬레이터 대상을 관리하는 소규모 팀이라면 기기별 수집 범위를 명확하게 나눌 수 있습니다.
로컬 맥이 없는 개발자라면 원격 환경에서 UI 테스트와 파일 저장까지 되는지 확인할 수 있습니다.

대표 화면 한 장부터 자동화하기

fastlane snapshot은 UI 테스트가 앱 화면을 열고 지정된 시점에 캡처하도록 구성하는 방식입니다. 테스트 자체가 원하는 화면으로 이동하지 못하면 캡처도 기대한 결과를 만들지 못합니다. 공식 fastlane 스크린샷 안내서는 UI 테스트를 통한 iOS 및 tvOS 스크린샷 자동 생성 과정을 설명합니다.

첫 시도는 앱의 대표 화면 하나로 제한하세요. Xcode에서 UI Test 타깃을 실행하고, 앱이 올바른 화면에 도달한 뒤 캡처가 생성되는지 확인합니다. 프로젝트에서 사용할 scheme을 공유 상태로 관리하면 로컬 실행과 자동화 실행 사이의 선택 조건을 맞추기 쉽습니다. fastlane의 캡처 작업 문서에서 현재 설정 항목과 실행 방식을 확인하세요.

첫 관문은 “파일이 생겼다”가 아닙니다. 파일을 열어 앱 화면, 언어, 테스트 데이터가 의도와 일치하는지 확인해야 합니다. 여기서 문제가 있으면 언어나 기기 범위를 늘리지 말고 테스트 경로부터 고치세요.

fastlane snapshot은 UI 테스트에서 어떻게 화면을 가져오나요?

테스트가 앱을 실행하고 화면을 이동한 다음 캡처 지점에 도달하면 자동 수집 흐름이 동작합니다. 따라서 캡처 호출 위치와 테스트가 화면을 준비하는 순서가 중요합니다. Xcode에서 같은 테스트가 반복 실행되는지 먼저 확인하고, 이후 fastlane 설정을 더하세요.

다국어 화면과 스토어 메타데이터 구분

앱 안의 화면 언어와 App Store Connect에 등록하는 스토어 정보 언어는 별도 관리 대상입니다. 앱을 특정 언어로 실행해 만든 이미지는 앱 UI의 현지화를 보여줄 뿐, 해당 언어의 스토어 설명이나 메타데이터를 자동으로 설정하지 않습니다.

fastlane 설정에서는 수집할 언어와 대상 기기를 구분해 관리할 수 있습니다. 공식 문서의 languages, devices, output_directory 설정을 확인하고, 프로젝트에서 실제로 사용할 값과 결과 저장 위치를 명시하세요. 이 설정 항목은 fastlane 캡처 작업 문서에 안내되어 있습니다.

각 언어에서 앱이 실제로 그 언어로 표시되는지도 검사하세요. 테스트 실행 환경의 언어 설정과 앱의 번역 리소스가 맞지 않으면, 파일은 생성되어도 잘못된 언어 화면이 저장될 수 있습니다. 언어별 폴더나 파일 이름을 확인하는 검수 과정을 두면 다른 언어의 소재를 잘못 선택할 가능성을 줄일 수 있습니다.

다국어 App Store 스크린샷을 만들 때 무엇을 분리해야 하나요?

앱 UI를 해당 언어로 실행해 화면을 캡처하는 작업과, 스토어의 현지화된 정보 및 소재를 관리하는 작업을 분리하세요. 업로드 전에 각 파일이 어느 언어의 앱 화면인지 확인하고, App Store Connect의 언어별 항목에 맞는 소재인지 대조해야 합니다.

참고: 자동 캡처는 번역 품질을 판단하지 않습니다. 잘린 문구, 번역되지 않은 문자열, 언어와 맞지 않는 테스트 데이터는 결과 이미지를 직접 열어 확인해야 합니다.

시뮬레이터 대상은 지원 범위에 맞추기

여러 iOS 시뮬레이터에서 fastlane snapshot을 실행할 수 있습니다. 다만 한 번의 성공이 모든 기기 화면을 검증했다는 뜻은 아닙니다. 앱에서 지원하는 화면과 제출에 필요한 소재 범위를 먼저 정한 다음, 필요한 시뮬레이터만 설정하세요.

Apple은 Xcode Device Hub의 시뮬레이터와 실제 기기 관리 방법을 안내합니다. 현재 설치된 시뮬레이터 런타임과 프로젝트의 지원 범위가 일치하는지 확인하세요. App Store Connect 소재는 Apple의 스크린샷 규격 안내에서 제출 시점의 크기와 요구 조건을 확인해야 합니다. 규격은 바뀔 수 있으므로 오래된 로컬 템플릿에만 의존하지 마세요.

여러 iOS 시뮬레이터에서 수집할 때 확인할 기준은 무엇인가요?

대상 기기별로 테스트가 실행되고 결과 이미지가 저장되었는지 확인하세요. 파일을 기기별로 분류하고 실제 화면과 비교해야 합니다. 한 대상에서 캡처가 성공해도 다른 해상도나 화면 구성에서 같은 결과가 나온다고 가정하지 마세요.

결과가 흔들릴 때는 앱 상태부터 고정하기

로그인 상태, 네트워크 응답, 로딩 표시, 서버에서 달라지는 테스트 데이터는 같은 테스트에서도 이미지가 달라지는 원인이 됩니다. 캡처 설정을 늘리기 전에 테스트 계정과 초기 상태, 화면 전환 조건을 일정하게 유지할 수 있는지 살펴보세요.

매 실행 때 같은 테스트 계정과 데이터를 사용하는지 확인합니다.
네트워크 응답이 끝나기 전에 캡처하지 않도록 화면 준비 조건을 점검합니다.
로딩 표시나 알림이 이미지에 남는지 테스트 결과를 열어 확인합니다.
실패한 테스트를 무조건 다시 실행하기보다 실패 원인과 재현 조건을 기록합니다.

fastlane 문서에 있는 대기나 재시도 관련 기능은 현재 버전의 공식 설명을 확인한 뒤 프로젝트에서 검증하세요. 이런 설정이 모든 네트워크 지연이나 테스트 불안정을 없애는 것은 아닙니다.

확인 기준: 반복 실행에서 서로 다른 이미지가 나왔다면, 먼저 앱 상태와 테스트 데이터가 달라졌는지 확인하세요. 수집 도구의 재시도만 늘리면 원인을 감춘 채 잘못된 소재를 저장할 수 있습니다.

원격 맥에서는 실행 가능 여부가 첫 관문

시뮬레이터는 맥에서 실행됩니다. Apple의 기기 스크린샷 안내와 Device Hub 문서를 기준으로, 원격 환경에서 사용할 Xcode와 시뮬레이터가 실제로 실행되는지 먼저 확인하세요.

로컬 맥이 없어도 fastlane snapshot으로 스토어 이미지를 만들 수 있나요?

원격 맥에서 Xcode UI 테스트와 필요한 iOS 시뮬레이터를 실행할 수 있다면 가능합니다. 원격 접속 자체만으로 실행 가능하다고 판단하지 마세요. 프로젝트의 scheme, 테스트 타깃, 시뮬레이터 런타임을 확인하고, 테스트 실행 후 결과 파일을 읽을 수 있는지도 검증해야 합니다.

원격 세션이 끊겨도 실행이 이어지는지, 생성 파일을 어디서 확인하고 내려받는지 역시 작업 전에 점검하세요. 이 부분은 환경마다 다르므로 실제 프로젝트와 접속 방식으로 시험해야 합니다. MacUDP의 원격 맥 이용 안내를 참고해 필요한 접속 및 작업 조건을 먼저 확인할 수 있습니다.

실행 마일스톤과 제출 전 검수

아래 항목은 다국어와 여러 기기를 한꺼번에 추가하기 전에 통과해야 할 기준입니다.

[ ] Xcode에서 대표 UI 테스트를 실행하고 의도한 화면에 도달하는지 확인합니다.
[ ] fastlane 설정에서 사용할 scheme과 테스트 대상을 확인합니다.
[ ] 언어 하나와 시뮬레이터 하나로 캡처해 파일이 만들어지는지 검사합니다.
[ ] 언어와 기기 대상을 필요한 범위만큼 확장하고 결과 저장 위치를 확인합니다.
[ ] 각 이미지를 열어 화면 언어, 테스트 데이터, 로딩 상태를 검수합니다.
[ ] 원격 맥에서는 파일 생성뿐 아니라 저장 위치에 접근할 수 있는지도 확인합니다.
[ ] 업로드 뒤 App Store Connect에서 언어와 기기별 소재가 의도한 위치에 들어갔는지 확인합니다.

fastlane의 deliver 문서는 스크린샷을 포함한 App Store Connect 업로드 흐름을 설명합니다. 업로드를 실행하기 전에 대상 앱과 기존 메타데이터에 미칠 영향을 확인하세요. Apple의 스크린샷 업로드 안내도 함께 확인하면 업로드 위치를 점검할 수 있습니다. 생성 또는 업로드 성공은 소재의 적합성이나 앱 심사 통과를 보장하지 않습니다. 제출 직전에는 Apple의 스크린샷 심사 지침에 따라 실제 앱 화면과 일치하는지 검토하세요.

현재 방식과 원격 맥 선택

수동으로 여러 언어와 기기 화면을 캡처하면 같은 경로를 반복하고 파일을 직접 분류해야 합니다. 맥이 없는 개발 환경에서는 Xcode UI 테스트를 로컬에서 실행할 수 없습니다. 관리형 빌드 환경을 쓰더라도 프로젝트에 필요한 테스트 상태와 생성 파일에 접근할 수 있는지는 별도로 확인해야 합니다.

반대로 원격 맥은 Xcode와 시뮬레이터를 직접 실행해 기존 UI 테스트 흐름을 검증할 수 있는 선택지입니다. 다만 장기간 상시 사용하거나 물리 기기 연결이 필요한 작업이라면, 원격 임대보다 직접 보유한 맥이 더 적합할 수 있습니다. 캡처 작업이 간헐적이거나 먼저 환경을 확인하려는 경우에는 MacUDP 요금제를 살펴보고, 프로젝트의 실행 빈도와 필요한 접속 조건에 맞는지 판단하세요.