Deliver (Fastlane) — vad är det, uppladdning till App Store och konfiguration i iOS och Android-utveckling

Vad är Deliver (Fastlane)?

Deliver (Fastlane) — är en komponent i Fastlane-ekosystemet som automatiserar publiceringsprocessen för mobila appar i App Store. Den hanterar uppladdning av binärfiler, uppdatering av metadata (namn, beskrivning, nyckelord), uppladdning av skärmbilder och prissättning för alla lokaliseringsspråk.

Utan Deliver kräver varje release manuell uppdatering av information via App Store Connect webbgränssnitt: ifyllning av beskrivning på flera språk, uppladdning av skärmbilder för varje skärmstorlek, uppdatering av nyckelord och prissättning. Publicering i App Store — är den sista fasen i en iOS-apps livscykel, som inkluderar verifiering av binärfilen, innehållsgranskning och lansering av appen i produktion.

Enligt App Store Connect Documentation (2025) får appar med regelbundna uppdateringar 30% fler ominstallationer och rankas bättre i sökresultat. Deliver gör det möjligt för team att släppa veckouppdateringar, automatisera rutinmässiga publiceringssteg och minska risken för mänskliga fel vid ifyllning av metadata på dussintals språk.

Använd Deliver för alla appar som publiceras i App Store — särskilt värdefullt för projekt med flerspråkig lokalisering, där manuell uppdatering av 32 språk tar flera timmar.

Hur Deliver fungerar med App Store Connect

Delivers funktionsmekanism bygger på en tvåstegsprocess. I första steget förbereder verktyget metadata — kontrollerar Deliverfile-strukturen, laddar skärmbilder och genererar ett manifest över ändringar. I andra steget skickar Deliver data till App Store Connect API, laddar upp binärfilen och startar verifieringsprocessen av bygget från Apples sida.

Deliver använder App Store Connect API för alla operationer, vilket garanterar kompatibilitet med Apples nya krav och utesluter användning av privata gränssnitt. App Store Connect API — är Apples officiella REST API för automatisering av operationer med appar, inklusive uppladdning av byggen, hantering av metadata och spårning av granskningsstatus.

Uppladdning av binärfiler

Deliver integreras direkt med Gym via Fastlane: efter IPA-bygget laddar Deliver upp det till App Store Connect och startar bearbetningsprocessen. Parametern --ipa anger sökvägen till binärfilen. Om parametern inte anges hittar Deliver automatiskt den senaste IPA i byggkatalogen som anges i Gymfile eller skickas via tidigare Fastlane-steg.

Efter uppladdning väntar Deliver på att Apple slutför bearbetningen av binärfilen — liknande Pilot, spåras status via en förloppsindikator. Tillgängliga statusar: Processing, Waiting For Review, In Review, Ready For Sale eller Rejected. Deliver meddelar teamet om varje statusändring via callbacks i Fastfile.

Hantering av appmetadata

Deliver hanterar den fullständiga uppsättningen metadata för appen: namn, beskrivning (kort och fullständig), nyckelord, support- och marknadsförings-URL, kategori och åldersklassificering. Appmetadata — är textinformation om appen som visas på App Store-sidan och används för sökindexering och ASO-optimering.

Parametern --submit_for_review skickar appen till granskning omedelbart efter uppladdning av metadata. Detta är en nyckelparameter för en helt automatiserad release. Utan den laddar Deliver bara upp data men skickar inte appen för granskning — detta är användbart för preliminär kontroll av alla fält före faktisk insändning.

Arbete med skärmbilder

Deliver laddar automatiskt upp skärmbilder för alla kombinationer av enheter och språk från den angivna katalogen. Filnamn måste följa mönstret: iPhone_6.5_01.png för iPhone med 6,5 tums diagonal på första platsen. Deliver bestämmer själv skärmbildens storlek och anpassar den till Apples krav för varje enhetstyp.

Skärmbilder laddas upp i korrekt ordning och för varje lokaliseringsspråk separat. Om inga skärmbilder hittas för ett språk använder Deliver engelska versioner som reservalternativ. Lokalisering av skärmbilder — är ett obligatoriskt krav för appar som vill rankas väl i App Store i olika länder, eftersom Apple tar hänsyn till lokalt innehåll i sökresultaten.

# Grundläggande kommando för uppladdning till App Store
fastlane deliver

# Uppladdning med angivelse av metadata och skärmbilder
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Förhandsgranskning utan uppladdning
fastlane deliver --preview

Konfiguration av Deliver via Deliverfile

Deliverfile — är en Fastlane-konfigurationsfil för lagring av appmetadata i strukturerat Ruby-format. Till skillnad från manuell ifyllning av formulär i App Store Connect möjliggör Deliverfile versionshantering av metadata i Git och kontroll av ändringar via kodgranskning före publicering.

# Deliverfile — appmetadata
app_identifier("com.company.app")
title("MyApp")
description("Appbeskrivning för butiken")
keywords("mobil, app, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Språk för metadata lokalisering
languages(["en-US", "ru", "de"])

Parametern languages bestämmer för vilka språk metadata ska laddas upp. För varje språk måste en separat katalog skapas i mappen fastlane/metadata med motsvarande filer för beskrivning, nyckelord och marknadsföringstexter. Deliver stöder samtidigt upp till 32 App Store-språk.

För uppladdning av skärmbilder används katalogen screenshots i Fastlane-mappen. Mappstruktur: screenshots/[Språk]/[Enhetstyp]_[Skärmstorlek]_[Nummer].png. Deliver laddar automatiskt upp skärmbilder för angivna språk och enheter och anpassar storlekar till Apples krav. Det rekommenderas att använda Snapshot för att generera skärmbilder — deras utdataformat är kompatibelt med Deliver.

Prisgrupp konfigureras via parametern price_tier, som accepterar numret på prisnivån från 0 till 87. Apples prisgrupper konverteras automatiskt till valutor för alla närvaroländer. Deliver gör det möjligt att ändra pris inom en release, vilket är användbart för tillfälliga kampanjer eller ändring av appens affärsmodell.

Deliver-kommandon för publicering av appar

Deliver-gränssnittet innehåller kommandon för uppladdning av metadata, binärfiler, skärmbilder och fullständig release. Huvudkommandot fastlane deliver utan parametrar använder data från Deliverfile och metadata-katalogen för hela publiceringscykeln.

Kommandot fastlane deliver --preview startar preliminär verifiering av metadata utan faktisk uppladdning till App Store Connect. --force krävs för uppladdning — utan det fungerar Deliver i förhandsgranskningsläge. Parametern --skip_binary laddar bara upp metadata och skärmbilder och hoppar över uppladdning av binärfil — detta är praktiskt för snabb uppdatering av ASO-fält utan ny release.

# Fullständig release med uppladdning av binärfil
fastlane deliver --force --ipa "build/App.ipa"

# Uppladdning endast av metadata utan binärfil
fastlane deliver --force --skip_binary

# Uppdatering endast av skärmbilder
fastlane deliver --force --skip_metadata

Parametern --skip_metadata laddar bara upp skärmbilder och binärfilen och behåller befintlig metadata oförändrad. Detta är användbart för hotfix-releaser, när en snabb korrigering behöver släppas utan att ändra beskrivning och ASO-fält. Kombinationen av flaggor möjliggör flexibel hantering av varje publiceringsfas separat.

Integrering av Deliver i releas-pipelinen

Releas-pipelinen med Deliver — är en komplett CI/CD-process för iOS som automatiserar alla steg från commit till publicering i App Store. En typisk pipeline inkluderar: Match för certifikat, Gym för IPA-bygge, Snapshot för skärmbilder och Deliver för uppladdning av all data till App Store med efterföljande sändning till granskning.

Nyckelfunktionen hos Deliver i pipelinen — stöd för metadata.json, som lagrar metadata i strukturerat JSON-format. Detta möjliggör programmatisk generering av metadata från externa CMS-system eller automatisk skapande av beskrivning på flera språk via ett översättnings-API.

# Release-pipeline i 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

Innan du anropar Deliver i pipelinen, se till att all metadata är aktuell: beskrivningen motsvarar den nya versionen, skärmbilderna är uppdaterade för nya funktioner och prisgruppen kräver inga ändringar. Submit for review skickar appen till Apples granskning, som tar 24 till 48 timmar för nya appar och 2 till 12 timmar för uppdateringar.

Deliver stöder mekanismen app_version, som gör det möjligt att ange målversion för uppdatering av metadata. Om versionen inte anges uppdaterar Deliver den aktuella aktiva versionen av appen i App Store Connect. För att släppa en ny version måste du först skapa motsvarande version via App Store Connect-gränssnittet eller API.

Vanliga fel vid arbete med Deliver

Vid användning av Deliver stöter utvecklare ofta på valideringsfel av metadata, felaktig filstruktur för skärmbilder och autentiseringsproblem. Feldiagnostik av Deliver börjar med analys av kommandologgar — Deliver visar detaljerad information om varje uppladdningssteg och orsaker till avvisning.

Felet „Invalid screenshot path„ uppstår när mappstrukturen med skärmbilder inte motsvarar det förväntade formatet. Lösning: kontrollera skärmbildsfilnamn för överensstämmelse med mönstret DeviceType_ScreenSize_Number.png (t.ex. AppleiPhone15ProMax_6.7_01.png). Deliver är känsligt för versaler och avskiljare i filnamn.

Felet „Metadata validation failed„ indikerar att metadata inte uppfyller App Stores krav. Lösning: kontrollera längden på beskrivningen (upp till 4000 tecken), nyckelord (upp till 100 tecken) och namn (upp till 30 tecken). App Store Review Guidelines innehåller fullständiga krav för varje metadat fält — det rekommenderas att kontrollera dem före varje release.

Vid felet „Apple ID not found„ finns appen inte i App Store Connect med det angivna apple_identifier. Lösning: skapa en app-post i App Store Connect via webbgränssnittet före första anropet till Deliver, med angivelse av Bundle Identifier och namn. Deliver skapar inte nya appar — det uppdaterar bara befintliga poster i butiken.