Deliver (Fastlane) — 개요, App Store 업로드 및 iOS·Android 개발 설정

Deliver (Fastlane)이란?

Deliver (Fastlane)은 Fastlane 생태계의 구성 요소로, App Store에 모바일 앱을 게시하는 프로세스를 자동화합니다. 바이너리 파일 업로드, 메타데이터 업데이트(이름, 설명, 키워드), 스크린샷 업로드 및 모든 로컬라이제이션 언어의 가격 설정을 관리합니다.

Deliver가 없으면 각 릴리스마다 App Store Connect 웹 인터페이스를 통해 수동으로 정보를 업데이트해야 합니다: 여러 언어로 설명 작성, 각 화면 크기의 스크린샷 업로드, 키워드 업데이트 및 가격 설정. App Store 게시는 iOS 앱 수명 주기의 최종 단계로, 바이너리 파일 검증, 콘텐츠 심사 및 앱의 프로덕션 제공을 포함합니다.

App Store Connect 문서(2025)에 따르면, 정기적으로 업데이트되는 앱은 재설치율이 30% 더 높고 검색 결과에서 더 잘 순위가 매겨집니다. Deliver를 통해 팀은 일상적인 게시 단계를 자동화하고 수십 개 언어로 메타데이터를 입력할 때 발생하는 인적 오류의 위험을 줄여 주간 업데이트를 출시할 수 있습니다.

App Store에 게시되는 모든 앱에 Deliver를 사용하세요 — 특히 수동으로 32개 언어를 업데이트하는 데 몇 시간이 걸리는 다국어 로컬라이제이션 프로젝트에서 매우 유용합니다.

Deliver가 App Store Connect와 작동하는 방식

Deliver의 작동 메커니즘은 2단계 프로세스를 기반으로 합니다. 첫 번째 단계에서 도구는 메타데이터를 준비합니다 — Deliverfile 구조를 검증하고, 스크린샷을 로드하며, 변경 매니페스트를 생성합니다. 두 번째 단계에서 Deliver는 App Store Connect API로 데이터를 전송하고, 바이너리 파일을 업로드하며, Apple 측에서 빌드 검증 프로세스를 시작합니다.

Deliver는 모든 작업에 App Store Connect API를 사용하여 Apple의 최신 요구 사항과의 호환성을 보장하고 비공개 인터페이스 사용을 배제합니다. App Store Connect API는 빌드 업로드, 메타데이터 관리 및 리뷰 상태 추적을 포함한 앱 운영 자동화를 위한 Apple의 공식 REST API입니다.

바이너리 파일 업로드

Deliver는 Fastlane을 통해 Gym과 직접 통합됩니다: IPA 빌드 후, Deliver는 이를 App Store Connect에 업로드하고 처리를 시작합니다. --ipa 매개변수는 바이너리 파일의 경로를 지정합니다. 지정되지 않은 경우, Deliver는 Gymfile에 지정되거나 이전 Fastlane 단계를 통해 전달된 빌드 디렉토리에서 최신 IPA를 자동으로 찾습니다.

업로드 후, Deliver는 Apple의 바이너리 처리가 완료될 때까지 기다립니다 — Pilot과 유사하게 상태는 진행 표시줄을 통해 추적됩니다. 사용 가능한 상태: Processing, Waiting For Review, In Review, Ready For Sale 또는 Rejected. Deliver는 Fastfile의 콜백을 통해 각 상태 변경을 팀에 알립니다.

앱 메타데이터 관리

Deliver는 앱 메타데이터의 전체 세트를 관리합니다: 이름, 설명(짧은 설명 및 전체 설명), 키워드, 지원 및 마케팅 URL, 카테고리 및 연령 등급. 앱 메타데이터는 App Store 페이지에 표시되고 검색 인덱싱 및 ASO 최적화에 사용되는 앱에 대한 텍스트 정보입니다.

--submit_for_review 매개변수는 메타데이터 업로드 직후 앱을 심사에 제출합니다. 이는 완전 자동화된 릴리스를 위한 핵심 매개변수입니다. 이 매개변수가 없으면 Deliver는 데이터만 업로드하고 앱을 리뷰에 제출하지 않습니다 — 실제 제출 전에 모든 필드를 사전 확인하는 데 유용합니다.

스크린샷 작업

Deliver는 지정된 디렉토리에서 모든 기기 및 언어 조합에 대해 자동으로 스크린샷을 업로드합니다. 파일 이름은 패턴을 따라야 합니다: 첫 번째 슬롯의 6.5인치 iPhone의 경우 iPhone_6.5_01.png. Deliver는 스크린샷 크기를 확인하고 각 기기 유형의 Apple 요구 사항과 매칭합니다.

스크린샷은 올바른 순서로 각 로컬라이제이션 언어별로 개별적으로 업로드됩니다. 언어에 대한 스크린샷이 없는 경우, Deliver는 영어 버전을 폴백으로 사용합니다. 스크린샷 로컬라이제이션은 여러 국가의 App Store에서 좋은 순위를 얻고자 하는 앱의 필수 요구 사항입니다. Apple은 검색 결과에서 현지 콘텐츠를 고려하기 때문입니다.

# App Store 기본 업로드 명령어
fastlane deliver

# 메타데이터 및 스크린샷 지정 업로드
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# 업로드 없이 미리보기
fastlane deliver --preview

Deliverfile을 통한 Deliver 설정

Deliverfile은 구조화된 Ruby 형식으로 앱 메타데이터를 저장하기 위한 Fastlane 설정 파일입니다. App Store Connect에서 수동으로 양식을 작성하는 것과 달리, Deliverfile을 사용하면 Git에서 메타데이터를 버전 관리하고 게시 전에 코드 리뷰를 통해 변경 사항을 검증할 수 있습니다.

# Deliverfile — 앱 메타데이터
app_identifier("com.company.app")
title("MyApp")
description("스토어용 앱 설명")
keywords("모바일, 앱, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# 메타데이터 로컬라이제이션 언어
languages(["en-US", "ru", "de"])

languages 매개변수는 메타데이터를 업로드할 언어를 결정합니다. fastlane/metadata 폴더 내에 각 언어별로 개별 디렉토리를 생성하고 해당 설명, 키워드 및 마케팅 텍스트 파일을 배치해야 합니다. Deliver는 동시에 최대 32개의 App Store 언어를 지원합니다.

스크린샷 업로드를 위해 Fastlane 폴더 내의 screenshots 디렉토리를 사용합니다. 폴더 구조: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver는 지정된 언어 및 기기에 대한 스크린샷을 자동으로 업로드하고 크기를 Apple 요구 사항과 매칭합니다. 스크린샷 생성에는 Snapshot 사용을 권장합니다 — 출력 형식이 Deliver와 호환됩니다.

가격 그룹은 price_tier 매개변수를 통해 설정되며, 0에서 87까지의 가격 수준 번호를 허용합니다. Apple의 가격 수준은 앱이 제공되는 모든 국가의 통화로 자동 변환됩니다. Deliver는 릴리스의 일부로 가격 변경을 허용하며, 임시 프로모션이나 앱 비즈니스 모델 변경에 유용합니다.

앱 게시를 위한 Deliver 명령어

Deliver 인터페이스에는 메타데이터, 바이너리 파일, 스크린샷 및 전체 릴리스 업로드 명령어가 포함됩니다. 매개변수 없는 기본 fastlane deliver 명령어는 전체 게시 사이클을 위해 Deliverfile 및 메타데이터 디렉토리의 데이터를 사용합니다.

fastlane deliver --preview 명령어는 App Store Connect에 실제 업로드 없이 메타데이터 사전 검증을 실행합니다. 업로드에는 --force가 필요합니다 — 이것이 없으면 Deliver는 미리보기 모드로 작동합니다. --skip_binary 매개변수는 바이너리 파일 업로드를 건너뛰고 메타데이터와 스크린샷만 업로드합니다 — 새 릴리스 없이 ASO 필드를 빠르게 업데이트하는 데 편리합니다.

# 바이너리 업로드 포함 전체 릴리스
fastlane deliver --force --ipa "build/App.ipa"

# 바이너리 없이 메타데이터만 업로드
fastlane deliver --force --skip_binary

# 스크린샷만 업데이트
fastlane deliver --force --skip_metadata

--skip_metadata 매개변수는 기존 메타데이터를 변경하지 않고 스크린샷과 바이너리 파일만 업로드합니다. 이는 설명과 ASO 필드를 변경하지 않고 신속하게 수정 사항을 출시해야 하는 핫픽스 릴리스에 유용합니다. 플래그 조합을 통해 각 게시 단계를 개별적으로 유연하게 관리할 수 있습니다.

릴리스 파이프라인에 Deliver 통합

릴리스 파이프라인과 Deliver는 커밋부터 App Store 게시까지 모든 단계를 자동화하는 iOS용 완전한 CI/CD 프로세스입니다. 일반적인 파이프라인에는 다음이 포함됩니다: 인증서용 Match, IPA 빌드용 Gym, 스크린샷용 Snapshot, 모든 데이터를 App Store Connect에 업로드하고 심사에 제출하는 Deliver.

파이프라인에서 Deliver의 핵심 기능은 구조화된 JSON 형식으로 메타데이터를 저장하는 metadata.json 지원입니다. 이를 통해 외부 CMS 시스템에서 프로그래매틱 방식으로 메타데이터를 생성하거나 번역 API를 통해 여러 언어로 설명을 자동으로 만들 수 있습니다.

# Fastfile의 릴리스 파이프라인
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

파이프라인에서 Deliver를 호출하기 전에 모든 메타데이터가 최신 상태인지 확인하세요: 새 버전에 맞는 설명, 새 기능에 대해 업데이트된 스크린샷, 변경이 필요 없는 가격 그룹. Submit for review는 앱을 Apple 심사에 보내며, 새 앱의 경우 24~48시간, 업데이트의 경우 2~12시간이 소요됩니다.

Deliver는 메타데이터 업데이트의 대상 버전을 지정할 수 있는 app_version 메커니즘을 지원합니다. 버전이 지정되지 않은 경우, Deliver는 App Store Connect에서 현재 활성 버전의 앱을 업데이트합니다. 새 버전을 릴리스하려면 App Store Connect 인터페이스 또는 API를 통해 먼저 해당 버전을 생성해야 합니다.

Deliver 사용 시 일반적인 오류

Deliver를 사용할 때 개발자는 메타데이터 검증 오류, 잘못된 스크린샷 파일 구조 및 인증 문제를 자주 경험합니다. 오류 진단은 명령 로그 분석으로 시작됩니다 — Deliver는 각 업로드 단계와 거부 이유에 대한 자세한 정보를 출력합니다.

“Invalid screenshot path” 오류는 스크린샷 폴더 구조가 예상 형식과 일치하지 않을 때 발생합니다. 해결책: 스크린샷 파일 이름이 패턴 DeviceType_ScreenSize_Number.png를 따르는지 확인합니다(예: AppleiPhone15ProMax_6.7_01.png). Deliver는 파일 이름의 대소문자와 구분 기호를 구분합니다.

“Metadata validation failed” 오류는 메타데이터가 App Store 요구 사항을 충족하지 않음을 나타냅니다. 해결책: 설명 길이(최대 4000자), 키워드 길이(최대 100자) 및 이름 길이(최대 30자)를 확인합니다. App Store 리뷰 가이드라인에는 각 메타데이터 필드의 전체 요구 사항이 포함되어 있습니다 — 각 릴리스 전에 확인하는 것이 좋습니다.

“Apple ID not found” 오류가 발생하면 지정된 apple_identifier로 App Store Connect에 앱이 존재하지 않습니다. 해결책: 첫 번째 Deliver 호출 전에 웹 인터페이스를 통해 App Store Connect에 앱 항목을 만들고 Bundle Identifier와 이름을 지정합니다. Deliver는 새 앱을 만들지 않으며, 스토어의 기존 항목만 업데이트합니다.