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 — то је званични Apple REST API за аутоматизацију операција са апликацијама, укључујући отпремање компилација, управљање метаподацима и праћење статуса прегледа.

Отпремање бинарних датотека

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/[Language]/[DeviceType]_[ScreenSize]_[Number].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, који аутоматизује све фазе од комитовања до објављивања у 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 не креира нове апликације — само ажурира постојеће записе у продавници.