Deliver (Fastlane) — какво е, качване в App Store и конфигурация в разработката за iOS и Android

Какво е Deliver (Fastlane)?

Deliver (Fastlane) — е компонент на екосистемата Fastlane, който автоматизира процеса на публикуване на мобилни приложения в App Store. Той управлява качването на двоични файлове, актуализирането на метаданни (име, описание, ключови думи), качването на екранни снимки и настройването на цени за всички езици за локализация.

Без Deliver всяко издание изисква ръчно актуализиране на информация чрез уеб интерфейса на App Store Connect: попълване на описание на няколко езика, качване на екранни снимки за всеки размер на екрана, актуализиране на ключови думи и настройване на цени. Публикуване в App Store — е последният етап от жизнения цикъл на iOS приложение, включващ проверка на двоичния файл, модериране на съдържанието и пускане на приложението в продукция.

Според App Store Connect Documentation (2025), приложенията с редовни актуализации получават 30% повече повторни инсталации и се класират по-добре в търсенето. Deliver позволява на екипите да пускат седмични актуализации, автоматизирайки рутинните стъпки на публикуване и намалявайки риска от човешка грешка при попълване на метаданни на десетки езици.

Използвайте Deliver за всяко приложение, което се публикува в App Store — особено ценно е за проекти с многоезикова локализация, където ръчното актуализиране на 32 езика отнема няколко часа.

Как Deliver работи с App Store Connect

Механизмът на работа на Deliver се основава на двуфазен процес. В първата фаза инструментът подготвя метаданните — проверява структурата на Deliverfile, зарежда екранни снимки и генерира манифест на промените. Във втората фаза Deliver изпраща данните към App Store Connect API, качва двоичния файл и стартира процеса на верификация на компилацията от страна на Apple.

Deliver използва App Store Connect API за всички операции, което гарантира съвместимост с новите изисквания на Apple и изключва използването на частни интерфейси. App Store Connect API — е официалният REST API на Apple за автоматизиране на операции с приложения, включително качване на компилации, управление на метаданни и проследяване на статуса на ревю.

Качване на двоични файлове

Deliver се интегрира директно с Gym чрез Fastlane: след компилация на IPA, Deliver го качва в App Store Connect и стартира процеса на обработка. Параметърът --ipa указва пътя до двоичния файл. Ако параметърът не е посочен, Deliver автоматично намира последния IPA в директорията за компилация, посочена в Gymfile или предадена чрез предишните стъпки на Fastlane.

След качването Deliver изчаква завършване на обработката на двоичния файл от Apple — подобно на Pilot, статусът се проследява чрез лента за напредък. Налични статуси: Processing, Waiting For Review, In Review, Ready For Sale или Rejected. Deliver уведомява екипа за всяка промяна на статуса чрез callback-ове във Fastfile.

Управление на метаданни на приложението

Deliver управлява пълния набор от метаданни на приложението: име, описание (кратко и пълно), ключови думи, URL за поддръжка и маркетинг, категория и възрастов рейтинг. Метаданни на приложението — са текстова информация за приложението, която се показва на страницата на App Store и се използва за индексиране в търсенето и ASO оптимизация.

Параметърът --submit_for_review изпраща приложението за модериране веднага след качване на метаданните. Това е ключов параметър за напълно автоматизирано издание. Без него Deliver само качва данни, но не изпраща приложението за ревю — това е полезно за предварителна проверка на всички полета преди действителното подаване.

Работа с екранни снимки

Deliver автоматично качва екранни снимки за всички комбинации от устройства и езици от посочената директория. Имената на файловете трябва да съответстват на шаблона: iPhone_6.5_01.png за iPhone с диагонал 6.5 инча на първия слот. Deliver сам определя размера на екранната снимка и го съпоставя с изискванията на Apple за всеки тип устройство.

Екранните снимки се качват в правилния ред и за всеки език за локализация отделно. Ако за даден език не бъдат намерени екранни снимки, Deliver използва английски версии като резервен вариант. Локализация на екранни снимки — е задължително изискване за приложения, които искат да се класират добре в App Store на различни държави, тъй като Apple взема предвид локалното съдържание в резултатите от търсенето.

# Основна команда за качване в App Store
fastlane deliver

# Качване с посочване на метаданни и екранни снимки
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Преглед без качване
fastlane deliver --preview

Конфигурация на Deliver чрез Deliverfile

Deliverfile — е конфигурационен файл на Fastlane за съхраняване на метаданните на приложението в структуриран Ruby формат. За разлика от ръчното попълване на формуляри в App Store Connect, Deliverfile позволява версиониране на метаданните в Git и проверка на промените чрез code review преди публикуване.

# 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.

За качване на екранни снимки се използва директорията screenshots в папката на Fastlane. Структура на папките: screenshots/[Език]/[ТипУстройство]_[РазмерНаЕкрана]_[Номер].png. Deliver автоматично качва екранни снимки за посочените езици и устройства, съпоставяйки размерите с изискванията на Apple. Препоръчва се използването на Snapshot за генериране на екранни снимки — техният изходен формат е съвместим с Deliver.

Ценовата група се конфигурира чрез параметъра price_tier, който приема номера на ценовото ниво от 0 до 87. Ценовите групи на Apple автоматично се конвертират във валутите на всички държави на присъствие. Deliver позволява промяна на цената в рамките на изданието, което е полезно за временни промоции или промяна на бизнес модела на приложението.

Команди на Deliver за публикуване на приложения

Интерфейсът на Deliver включва команди за качване на метаданни, двоични файлове, екранни снимки и пълно издание. Основната команда fastlane deliver без параметри използва данни от Deliverfile и metadata директорията за пълния цикъл на публикуване.

Командата 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 качва само екранни снимки и двоичния файл, запазвайки съществуващите метаданни без промяна. Това е полезно за hotfix издания, когато трябва бързо да пуснете корекция без промяна на описанието и ASO полетата. Комбинацията от флагове позволява гъвкаво управление на всеки етап от публикуването поотделно.

Интеграция на Deliver в тръбопровода за издаване

Тръбопроводът за издаване с Deliver — е пълен CI/CD процес за iOS, който автоматизира всички етапи от commit до публикуване в App Store. Типичният тръбопровод включва: Match за сертификати, Gym за компилация на IPA, Snapshot за екранни снимки и Deliver за качване на всички данни в App Store с последващо изпращане за модериране.

Ключовата характеристика на Deliver в тръбопровода — поддръжка за metadata.json, който съхранява метаданни в структуриран 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 започва с анализ на логовете на командата — Deliver показва подробна информация за всеки етап на качване и причините за отхвърляне.

Грешката „Invalid screenshot path„ възниква, когато структурата на папките с екранни снимки не съответства на очаквания формат. Решение: проверете имената на файловете с екранни снимки за съответствие с шаблона DeviceType_ScreenSize_Number.png (например AppleiPhone15ProMax_6.7_01.png). Deliver е чувствителен към главни и малки букви и разделители в имената на файловете.

Грешката „Metadata validation failed„ показва несъответствие на метаданните с изискванията на App Store. Решение: проверете дължината на описанието (до 4000 символа), ключовите думи (до 100 символа) и името (до 30 символа). App Store Review Guidelines съдържа пълни изисквания за всяко поле от метаданните — препоръчва се проверка преди всяко издание.

При грешката „Apple ID not found„ приложението не съществува в App Store Connect с посочения apple_identifier. Решение: създайте запис на приложението в App Store Connect чрез уеб интерфейса преди първото извикване на Deliver, като посочите Bundle Identifier и име. Deliver не създава нови приложения — той само актуализира съществуващи записи в магазина.