Deliver (Fastlane) — mi ez, feltöltés az App Store-ba és konfiguráció iOS és Android fejlesztésben

Mi az a Deliver (Fastlane)?

Deliver (Fastlane) — a Fastlane ökoszisztéma egy komponense, amely automatizálja a mobilalkalmazások App Store-ban történő közzétételének folyamatát. Kezeli a bináris fájlok feltöltését, a metaadatok (név, leírás, kulcsszavak) frissítését, a képernyőképek feltöltését és az árak beállítását az összes lokalizációs nyelvhez.

Deliver nélkül minden kiadás az információk manuális frissítését igényli az App Store Connect webes felületén keresztül: a leírás kitöltése több nyelven, képernyőképek feltöltése minden képernyőmérethez, kulcsszavak frissítése és árak beállítása. Közzététel az App Store-ban — egy iOS alkalmazás életciklusának utolsó szakasza, amely magában foglalja a bináris fájl ellenőrzését, a tartalom moderálását és az alkalmazás éles környezetbe való kiadását.

Az App Store Connect Documentation (2025) szerint a rendszeres frissítésekkel rendelkező alkalmazások 30%-kal több újratelepítést kapnak és jobban rangsorolnak a keresésben. A Deliver lehetővé teszi a csapatok számára a heti frissítések kiadását, automatizálva a közzététel rutin lépéseit és csökkentve az emberi hiba kockázatát a metaadatok több tucat nyelven történő kitöltésekor.

Használja a Deliver-t minden olyan alkalmazáshoz, amely az App Store-ban jelenik meg — különösen értékes a többnyelvű lokalizációval rendelkező projektekhez, ahol 32 nyelv manuális frissítése több órát vesz igénybe.

Hogyan működik a Deliver az App Store Connect-tel

A Deliver működési mechanizmusa egy kétfázisú folyamaton alapul. Az első fázisban az eszköz előkészíti a metaadatokat — ellenőrzi a Deliverfile szerkezetét, betölti a képernyőképeket és létrehozza a változtatások manifesztumát. A második fázisban a Deliver elküldi az adatokat az App Store Connect API-nak, feltölti a bináris fájlt és elindítja a build ellenőrzési folyamatát az Apple oldalán.

A Deliver az App Store Connect API-t használja minden művelethez, ami garantálja a kompatibilitást az Apple új követelményeivel és kizárja a privát interfészek használatát. App Store Connect API — az Apple hivatalos REST API-ja az alkalmazásokkal végzett műveletek automatizálásához, beleértve a build-ek feltöltését, a metaadatok kezelését és a felülvizsgálati állapot nyomon követését.

Bináris fájlok feltöltése

A Deliver közvetlenül integrálódik a Gym-mel a Fastlane-en keresztül: az IPA build után a Deliver feltölti azt az App Store Connect-be és elindítja a feldolgozási folyamatot. A --ipa paraméter a bináris fájl elérési útját jelzi. Ha a paraméter nincs megadva, a Deliver automatikusan megtalálja az utolsó IPA-t a Gymfile-ben megadott vagy a Fastlane előző lépésein keresztül továbbított build könyvtárban.

A feltöltés után a Deliver megvárja a bináris fájl Apple általi feldolgozásának befejezését — a Pilot-hoz hasonlóan az állapot egy folyamatjelző sávon keresztül követhető. Elérhető állapotok: Processing, Waiting For Review, In Review, Ready For Sale vagy Rejected. A Deliver értesíti a csapatot minden állapotváltozásról a Fastfile-beli callback-eken keresztül.

Alkalmazás metaadatok kezelése

A Deliver kezeli az alkalmazás teljes metaadatkészletét: név, leírás (rövid és teljes), kulcsszavak, támogatási és marketing URL, kategória és korhatár-besorolás. Alkalmazás metaadatok — az alkalmazásról szóló szöveges információk, amelyek az App Store oldalon jelennek meg és a keresési indexeléshez és ASO optimalizáláshoz használatosak.

A --submit_for_review paraméter a metaadatok feltöltése után azonnal moderálásra küldi az alkalmazást. Ez egy kulcsfontosságú paraméter a teljesen automatizált kiadáshoz. Nélküle a Deliver csak feltölti az adatokat, de nem küldi el az alkalmazást felülvizsgálatra — ez hasznos az összes mező előzetes ellenőrzéséhez a tényleges benyújtás előtt.

Munka képernyőképekkel

A Deliver automatikusan feltölti a képernyőképeket az eszközök és nyelvek összes kombinációjához a megadott könyvtárból. A fájlneveknek meg kell felelniük a mintának: iPhone_6.5_01.png a 6,5 hüvelykes átlójú iPhone-hoz az első slotban. A Deliver maga határozza meg a képernyőkép méretét és igazítja az Apple követelményeihez minden eszköztípushoz.

A képernyőképek a megfelelő sorrendben és minden lokalizációs nyelvhez külön-külön töltődnek fel. Ha egy nyelvhez nem találhatók képernyőképek, a Deliver angol verziókat használ tartalék opcióként. A képernyőképek lokalizációja — kötelező követelmény azon alkalmazások számára, amelyek jól akarnak rangsorolni a különböző országok App Store-jaiban, mivel az Apple figyelembe veszi a helyi tartalmat a keresési eredményekben.

# Alapvető parancs az App Store-ba feltöltéshez
fastlane deliver

# Feltöltés metaadatok és képernyőképek megadásával
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Előnézet feltöltés nélkül
fastlane deliver --preview

A Deliver konfigurációja a Deliverfile-on keresztül

Deliverfile — egy Fastlane konfigurációs fájl az alkalmazás metaadatainak strukturált Ruby formátumban történő tárolásához. Ellentétben az App Store Connect-ben lévő űrlapok manuális kitöltésével, a Deliverfile lehetővé teszi a metaadatok verziókezelését Git-ben és a változtatások ellenőrzését code review-n keresztül a közzététel előtt.

# Deliverfile — alkalmazás metaadatok
app_identifier("com.company.app")
title("MyApp")
description("Alkalmazás leírása a bolt számára")
keywords("mobil, alkalmazás, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Metaadatok lokalizációs nyelvei
languages(["en-US", "ru", "de"])

A languages paraméter határozza meg, hogy mely nyelvekhez töltődnek fel a metaadatok. Minden nyelvhez külön könyvtárat kell létrehozni a fastlane/metadata mappában a megfelelő leírás, kulcsszavak és marketing szövegek fájljaival. A Deliver egyszerre akár 32 App Store nyelvet is támogat.

A képernyőképek feltöltéséhez a Fastlane mappán belüli screenshots könyvtárat kell használni. A mappák szerkezete: screenshots/[Nyelv]/[EszközTípus]_[KépernyőMéret]_[Szám].png. A Deliver automatikusan feltölti a képernyőképeket a megadott nyelvekhez és eszközökhöz, igazítva a méreteket az Apple követelményeihez. Javasolt a Snapshot használata a képernyőképek generálásához — a kimeneti formátumuk kompatibilis a Deliver-rel.

Az árcsoport a price_tier paraméteren keresztül konfigurálható, amely 0-tól 87-ig fogadja el az árszint számát. Az Apple árcsoportjai automatikusan átváltásra kerülnek az összes jelenlévő ország pénznemére. A Deliver lehetővé teszi az ár módosítását egy kiadáson belül, ami hasznos ideiglenes akciókhoz vagy az alkalmazás üzleti modelljének megváltoztatásához.

Deliver parancsok alkalmazások közzétételéhez

A Deliver interfész parancsokat tartalmaz a metaadatok, bináris fájlok, képernyőképek és teljes kiadás feltöltéséhez. A fő fastlane deliver parancs paraméterek nélkül a Deliverfile és a metadata könyvtár adatait használja a teljes közzétételi ciklushoz.

A fastlane deliver --preview parancs elindítja a metaadatok előzetes ellenőrzését az App Store Connect-be történő tényleges feltöltés nélkül. --force szükséges a feltöltéshez — enélkül a Deliver előnézeti módban működik. A --skip_binary paraméter csak a metaadatokat és képernyőképeket tölti fel, kihagyva a bináris fájl feltöltését — ez kényelmes az ASO mezők gyors frissítéséhez új kiadás nélkül.

# Teljes kiadás bináris fájl feltöltésével
fastlane deliver --force --ipa "build/App.ipa"

# Csak metaadatok feltöltése bináris fájl nélkül
fastlane deliver --force --skip_binary

# Csak képernyőképek frissítése
fastlane deliver --force --skip_metadata

A --skip_metadata paraméter csak a képernyőképeket és a bináris fájlt tölti fel, a meglévő metaadatokat változatlanul hagyva. Ez hasznos hotfix kiadásokhoz, amikor gyorsan kell kiadni egy javítást a leírás és az ASO mezők megváltoztatása nélkül. A zászlók kombinációja lehetővé teszi a közzététel egyes szakaszainak rugalmas kezelését.

A Deliver integrációja a kiadási csővezetékbe

Kiadási csővezeték a Deliver-rel — egy teljes CI/CD folyamat iOS-hez, amely automatizálja az összes szakaszt a commit-tól az App Store-ban történő közzétételig. A tipikus csővezeték tartalmazza: Match a tanúsítványokhoz, Gym az IPA build-hez, Snapshot a képernyőképekhez és Deliver az összes adat App Store-ba történő feltöltéséhez, majd azt követő moderálásra küldéséhez.

A Deliver kulcsjellemzője a csővezetékben — a metadata.json támogatása, amely strukturált JSON formátumban tárolja a metaadatokat. Ez lehetővé teszi a metaadatok programozott generálását külső CMS rendszerekből vagy a leírás automatikus létrehozását több nyelven fordítási API-n keresztül.

# Kiadási csővezeték a Fastfile-ban
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

Mielőtt meghívná a Deliver-t a csővezetékben, győződjön meg arról, hogy az összes metaadat naprakész: a leírás megfelel az új verziónak, a képernyőképek frissítve vannak az új funkciókhoz, és az árcsoport nem igényel változtatást. Submit for review elküldi az alkalmazást az Apple moderálására, amely új alkalmazások esetén 24-48 óráig, frissítések esetén 2-12 óráig tart.

A Deliver támogatja az app_version mechanizmust, amely lehetővé teszi a célverzió megadását a metaadatok frissítéséhez. Ha a verzió nincs megadva, a Deliver frissíti az alkalmazás aktuális aktív verzióját az App Store Connect-ben. Új verzió kiadásához először létre kell hozni a megfelelő verziót az App Store Connect felületen vagy API-n keresztül.

Gyakori hibák a Deliver használatakor

A Deliver használatakor a fejlesztők gyakran találkoznak metaadat-érvényesítési hibákkal, a képernyőkép fájlok helytelen szerkezetével és hitelesítési problémákkal. Hibadiagnosztika a Deliver parancs naplóinak elemzésével kezdődik — a Deliver részletes információkat jelenít meg a feltöltés minden szakaszáról és az elutasítás okairól.

A „Invalid screenshot path„ hiba akkor fordul elő, amikor a képernyőképeket tartalmazó mappák szerkezete nem felel meg a várt formátumnak. Megoldás: ellenőrizze a képernyőkép fájlnevek megfelelőségét a DeviceType_ScreenSize_Number.png mintának (például AppleiPhone15ProMax_6.7_01.png). A Deliver érzékeny a kis- és nagybetűkre és az elválasztókra a fájlnevekben.

A „Metadata validation failed„ hiba a metaadatok App Store követelményeinek való meg nem felelését jelzi. Megoldás: ellenőrizze a leírás hosszát (legfeljebb 4000 karakter), a kulcsszavakat (legfeljebb 100 karakter) és a nevet (legfeljebb 30 karakter). App Store Review Guidelines tartalmazza a metaadatmezők teljes követelményeit — javasolt ezeket minden kiadás előtt ellenőrizni.

A „Apple ID not found„ hibánál az alkalmazás nem létezik az App Store Connect-ben a megadott apple_identifier-rel. Megoldás: hozzon létre egy alkalmazásrekordot az App Store Connect-ben a webes felületen keresztül a Deliver első hívása előtt, megadva a Bundle Identifier-t és a nevet. A Deliver nem hoz létre új alkalmazásokat — csak a meglévő rekordokat frissíti a boltban.