Deliver (Fastlane) — co to je, nahrávání do App Store a konfigurace ve vývoji pro iOS a Android

Co je Deliver (Fastlane)?

Deliver (Fastlane) — je komponenta ekosystému Fastlane, která automatizuje proces publikování mobilních aplikací v App Store. Řídí nahrávání binárních souborů, aktualizaci metadat (název, popis, klíčová slova), nahrávání snímků obrazovky a nastavení cen pro všechny jazyky lokalizace.

Bez Deliver každé vydání vyžaduje ruční aktualizaci informací přes webové rozhraní App Store Connect: vyplnění popisu v několika jazycích, nahrání snímků obrazovky pro každou velikost obrazovky, aktualizaci klíčových slov a nastavení cen. Publikování v App Store — je konečná fáze životního cyklu iOS aplikace, která zahrnuje ověření binárního souboru, moderaci obsahu a uvedení aplikace do produkce.

Podle App Store Connect Documentation (2025), aplikace s pravidelnými aktualizacemi získávají o 30 % více přeinstalací a lépe se umisťují ve vyhledávání. Deliver umožňuje týmům vydávat týdenní aktualizace, automatizuje rutinní kroky publikování a snižuje riziko lidské chyby při vyplňování metadat v desítkách jazyků.

Používejte Deliver pro jakoukoli aplikaci publikovanou v App Store — zvláště cenný je pro projekty s vícejazyčnou lokalizací, kde ruční aktualizace 32 jazyků trvá několik hodin.

Jak Deliver pracuje s App Store Connect

Mechanismus práce Deliver je založen na dvoufázovém procesu. V první fázi nástroj připravuje metadata — kontroluje strukturu Deliverfile, načítá snímky obrazovky a generuje manifest změn. Ve druhé fázi Deliver odesílá data do App Store Connect API, nahrává binární soubor a spouští proces ověření sestavení na straně Apple.

Deliver používá App Store Connect API pro všechny operace, což zaručuje kompatibilitu s novými požadavky Apple a vylučuje použití soukromých rozhraní. App Store Connect API — je oficiální REST API Apple pro automatizaci operací s aplikacemi, včetně nahrávání sestavení, správy metadat a sledování stavu recenze.

Nahrávání binárních souborů

Deliver se integruje přímo s Gym přes Fastlane: po sestavení IPA Deliver nahraje jej do App Store Connect a spustí proces zpracování. Parametr --ipa udává cestu k binárnímu souboru. Pokud parametr není uveden, Deliver automaticky najde poslední IPA v adresáři sestavení uvedeném v Gymfile nebo předaném přes předchozí kroky Fastlane.

Po nahrání Deliver čeká na dokončení zpracování binárního souboru Apple — podobně jako Pilot, stav je sledován pomocí indikátoru průběhu. Dostupné stavy: Processing, Waiting For Review, In Review, Ready For Sale nebo Rejected. Deliver informuje tým o každé změně stavu pomocí callbacků v Fastfile.

Správa metadat aplikace

Deliver spravuje kompletní sadu metadat aplikace: název, popis (krátký a plný), klíčová slova, URL podpory a marketingu, kategorii a věkové hodnocení. Metadata aplikace — jsou textové informace o aplikaci, které se zobrazují na stránce App Store a používají se pro indexaci vyhledávání a optimalizaci ASO.

Parametr --submit_for_review odesílá aplikaci k moderaci ihned po nahrání metadat. Toto je klíčový parametr pro plně automatizované vydání. Bez něj Deliver pouze nahrává data, ale neodesílá aplikaci k recenzi — to je užitečné pro předběžnou kontrolu všech polí před skutečným odesláním.

Práce se snímky obrazovky

Deliver automaticky nahrává snímky obrazovky pro všechny kombinace zařízení a jazyků z uvedeného adresáře. Názvy souborů musí odpovídat vzoru: iPhone_6.5_01.png pro iPhone s úhlopříčkou 6,5 palce na prvním slotu. Deliver sám určuje velikost snímku obrazovky a přizpůsobuje ji požadavkům Apple pro každý typ zařízení.

Snímky obrazovky se nahrávají ve správném pořadí a pro každý jazyk lokalizace zvlášť. Pokud pro jazyk nejsou nalezeny snímky obrazovky, Deliver použije anglické verze jako záložní možnost. Lokalizace snímků obrazovky — je povinný požadavek pro aplikace, které chtějí dobře umístění v App Store různých zemí, protože Apple zohledňuje místní obsah ve výsledcích vyhledávání.

# Základní příkaz pro nahrání do App Store
fastlane deliver

# Nahrání s uvedením metadat a snímků obrazovky
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Náhled bez nahrání
fastlane deliver --preview

Konfigurace Deliver pomocí Deliverfile

Deliverfile — je konfigurační soubor Fastlane pro ukládání metadat aplikace ve strukturovaném Ruby formátu. Na rozdíl od ručního vyplňování formulářů v App Store Connect, Deliverfile umožňuje verzování metadat v Git a kontrolu změn pomocí code review před publikováním.

# Deliverfile — metadata aplikace
app_identifier("com.company.app")
title("MyApp")
description("Popis aplikace pro obchod")
keywords("mobilní, aplikace, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Jazyky lokalizace metadat
languages(["en-US", "ru", "de"])

Parametr languages určuje, pro které jazyky budou metadata nahrána. Pro každý jazyk musí být vytvořen samostatný adresář ve složce fastlane/metadata s odpovídajícími soubory popisu, klíčových slov a marketingových textů. Deliver podporuje současně až 32 jazyků App Store.

Pro nahrávání snímků obrazovky se používá adresář screenshots uvnitř složky Fastlane. Struktura složek: screenshots/[Jazyk]/[TypZařízení]_[VelikostObrazovky]_[Číslo].png. Deliver automaticky nahrává snímky obrazovky pro uvedené jazyky a zařízení, přizpůsobuje velikosti požadavkům Apple. Doporučuje se používat Snapshot pro generování snímků obrazovky — jejich výstupní formát je kompatibilní s Deliver.

Cenová skupina se konfiguruje pomocí parametru price_tier, který přijímá číslo cenové úrovně od 0 do 87. Cenové skupiny Apple se automaticky převádějí do měn všech zemí přítomnosti. Deliver umožňuje změnit cenu v rámci vydání, což je užitečné pro dočasné akce nebo změnu obchodního modelu aplikace.

Příkazy Deliver pro publikování aplikací

Rozhraní Deliver zahrnuje příkazy pro nahrávání metadat, binárních souborů, snímků obrazovky a plného vydání. Hlavní příkaz fastlane deliver bez parametrů používá data z Deliverfile a adresáře metadata pro celý cyklus publikování.

Příkaz fastlane deliver --preview spouští předběžné ověření metadat bez skutečného nahrání do App Store Connect. --force je vyžadován pro nahrání — bez něj Deliver pracuje v režimu náhledu. Parametr --skip_binary nahrává pouze metadata a snímky obrazovky, přeskakuje nahrání binárního souboru — to je vhodné pro rychlou aktualizaci polí ASO bez nového vydání.

# Plné vydání s nahráním binárního souboru
fastlane deliver --force --ipa "build/App.ipa"

# Nahrání pouze metadat bez binárního souboru
fastlane deliver --force --skip_binary

# Aktualizace pouze snímků obrazovky
fastlane deliver --force --skip_metadata

Parametr --skip_metadata nahrává pouze snímky obrazovky a binární soubor, zachovává stávající metadata beze změny. To je užitečné pro hotfix vydání, kdy je třeba rychle vydat opravu bez změny popisu a polí ASO. Kombinace přepínačů umožňuje flexibilní správu každé fáze publikování zvlášť.

Integrace Deliver do pipeline vydání

Pipeline vydání s Deliver — je kompletní CI/CD proces pro iOS, který automatizuje všechny fáze od commitu po publikování v App Store. Typická pipeline zahrnuje: Match pro certifikáty, Gym pro sestavení IPA, Snapshot pro snímky obrazovky a Deliver pro nahrání všech dat do App Store s následným odesláním k moderaci.

Klíčová vlastnost Deliver v pipeline — podpora metadata.json, který ukládá metadata ve strukturovaném JSON formátu. To umožňuje programové generování metadat z externích CMS systémů nebo automatické vytváření popisu v několika jazycích pomocí překladového API.

# Pipeline vydání v 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

Před voláním Deliver v pipeline se ujistěte, že všechna metadata jsou aktuální: popis odpovídá nové verzi, snímky obrazovky jsou aktualizovány pro nové funkce a cenová skupina nevyžaduje změny. Submit for review odesílá aplikaci k moderaci Apple, která trvá 24 až 48 hodin pro nové aplikace a 2 až 12 hodin pro aktualizace.

Deliver podporuje mechanismus app_version, který umožňuje určit cílovou verzi pro aktualizaci metadat. Pokud verze není uvedena, Deliver aktualizuje aktuální aktivní verzi aplikace v App Store Connect. Pro vydání nové verze je třeba nejprve vytvořit odpovídající verzi přes rozhraní App Store Connect nebo API.

Typické chyby při práci s Deliver

Při používání Deliver se vývojáři často setkávají s chybami validace metadat, nesprávnou strukturou souborů snímků obrazovky a problémy s autentizací. Diagnostika chyb Deliver začíná analýzou logů příkazu — Deliver zobrazuje podrobné informace o každé fázi nahrávání a důvodech odmítnutí.

Chyba „Invalid screenshot path„ nastává, když struktura složek se snímky obrazovky neodpovídá očekávanému formátu. Řešení: zkontrolujte názvy souborů snímků obrazovky pro shodu se vzorem DeviceType_ScreenSize_Number.png (například AppleiPhone15ProMax_6.7_01.png). Deliver je citlivý na velikost písmen a oddělovače v názvech souborů.

Chyba „Metadata validation failed„ indikuje nesoulad metadat s požadavky App Store. Řešení: zkontrolujte délku popisu (do 4000 znaků), klíčových slov (do 100 znaků) a názvu (do 30 znaků). App Store Review Guidelines obsahuje úplné požadavky na každé pole metadat — doporučuje se je kontrolovat před každým vydáním.

Při chybě „Apple ID not found„ aplikace neexistuje v App Store Connect s uvedeným apple_identifier. Řešení: vytvořte záznam aplikace v App Store Connect přes webové rozhraní před prvním voláním Deliver, s uvedením Bundle Identifier a názvu. Deliver nevytváří nové aplikace — pouze aktualizuje existující záznamy v obchodě.