Deliver (Fastlane) — wat is het, uploaden naar App Store en configuratie in iOS en Android ontwikkeling

Wat is Deliver (Fastlane)?

Deliver (Fastlane) — is een component van het Fastlane ecosysteem dat het publicatieproces van mobiele apps in de App Store automatiseert. Het beheert het uploaden van binaire bestanden, het bijwerken van metadata (naam, beschrijving, trefwoorden), het uploaden van screenshots en het instellen van prijzen voor alle lokalisatietalen.

Zonder Deliver vereist elke release handmatige bijwerking van informatie via de App Store Connect webinterface: het invullen van beschrijvingen in meerdere talen, het uploaden van screenshots voor elke schermgrootte, het bijwerken van trefwoorden en het instellen van prijzen. Publicatie in de App Store — is de laatste fase van de levenscyclus van een iOS-app, inclusief verificatie van het binaire bestand, inhoudsmoderatie en het vrijgeven van de app in productie.

Volgens App Store Connect Documentation (2025) krijgen apps met regelmatige updates 30% meer herinstallaties en rangschikken ze beter in zoekresultaten. Deliver stelt teams in staat om wekelijkse updates uit te brengen, routinestappen van publicatie te automatiseren en het risico op menselijke fouten bij het invullen van metadata in tientallen talen te verminderen.

Gebruik Deliver voor elke app die in de App Store wordt gepubliceerd — het is vooral waardevol voor projecten met meertalige lokalisatie, waar handmatige bijwerking van 32 talen enkele uren duurt.

Hoe Deliver werkt met App Store Connect

Het werkingsmechanisme van Deliver is gebaseerd op een tweefasenproces. In de eerste fase bereidt de tool de metadata voor — controleert de structuur van Deliverfile, laadt screenshots en genereert een manifest van wijzigingen. In de tweede fase stuurt Deliver de gegevens naar de App Store Connect API, uploadt het binaire bestand en start het verificatieproces van de build aan de kant van Apple.

Deliver gebruikt App Store Connect API voor alle operaties, wat compatibiliteit met nieuwe Apple-vereisten garandeert en het gebruik van privé-interfaces uitsluit. App Store Connect API — is de officiële Apple REST API voor het automatiseren van operaties met apps, inclusief het uploaden van builds, beheer van metadata en het volgen van de reviewstatus.

Uploaden van binaire bestanden

Deliver integreert direct met Gym via Fastlane: na de IPA-build uploadt Deliver deze naar App Store Connect en start het verwerkingsproces. De parameter --ipa geeft het pad naar het binaire bestand aan. Als de parameter niet is opgegeven, vindt Deliver automatisch de laatste IPA in de builddirectory die is opgegeven in Gymfile of doorgegeven via eerdere Fastlane-stappen.

Na het uploaden wacht Deliver op voltooiing van de verwerking van het binaire bestand door Apple — vergelijkbaar met Pilot, wordt de status gevolgd via een voortgangsbalk. Beschikbare statussen: Processing, Waiting For Review, In Review, Ready For Sale of Rejected. Deliver stelt het team op de hoogte van elke statuswijziging via callbacks in Fastfile.

Beheer van app-metadata

Deliver beheert de volledige set metadata van de app: naam, beschrijving (kort en volledig), trefwoorden, ondersteunings- en marketing-URL, categorie en leeftijdsclassificatie. App-metadata — is tekstuele informatie over de app die wordt weergegeven op de App Store-pagina en wordt gebruikt voor zoekindexering en ASO-optimalisatie.

De parameter --submit_for_review stuurt de app direct na het uploaden van metadata naar moderatie. Dit is een cruciale parameter voor een volledig geautomatiseerde release. Zonder dit uploadt Deliver alleen gegevens, maar stuurt de app niet ter review — dit is handig voor voorlopige controle van alle velden vóór de feitelijke indiening.

Werken met screenshots

Deliver uploadt automatisch screenshots voor alle combinaties van apparaten en talen uit de opgegeven directory. Bestandsnamen moeten voldoen aan het patroon: iPhone_6.5_01.png voor iPhone met een diagonaal van 6.5 inch op de eerste slot. Deliver bepaalt zelf de grootte van de screenshot en past deze aan de Apple-vereisten voor elk apparaattype aan.

Screenshots worden in de juiste volgorde geüpload en voor elke lokalisatietaal afzonderlijk. Als er voor een taal geen screenshots worden gevonden, gebruikt Deliver Engelse versies als back-upoptie. Lokalisatie van screenshots — is een verplichte vereiste voor apps die goed willen rangschikken in de App Store van verschillende landen, omdat Apple lokale inhoud in zoekresultaten in aanmerking neemt.

# Basiscommando voor uploaden naar App Store
fastlane deliver

# Uploaden met specificatie van metadata en screenshots
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Preview zonder uploaden
fastlane deliver --preview

Configuratie van Deliver via Deliverfile

Deliverfile — is een Fastlane-configuratiebestand voor het opslaan van app-metadata in gestructureerd Ruby-formaat. In tegenstelling tot handmatig invullen van formulieren in App Store Connect, maakt Deliverfile het mogelijk om metadata in Git te versiebeheren en wijzigingen te controleren via code review vóór publicatie.

# Deliverfile — app-metadata
app_identifier("com.company.app")
title("MyApp")
description("App-beschrijving voor de winkel")
keywords("mobiel, app, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Talen voor metadata-lokalisatie
languages(["en-US", "ru", "de"])

De parameter languages bepaalt voor welke talen metadata worden geüpload. Voor elke taal moet een aparte directory worden aangemaakt in de map fastlane/metadata met de bijbehorende bestanden voor beschrijving, trefwoorden en marketingteksten. Deliver ondersteunt gelijktijdig maximaal 32 App Store-talen.

Voor het uploaden van screenshots wordt de directory screenshots in de Fastlane-map gebruikt. Mapstructuur: screenshots/[Taal]/[ApparaatType]_[SchermGrootte]_[Nummer].png. Deliver uploadt automatisch screenshots voor de opgegeven talen en apparaten en past de afmetingen aan de Apple-vereisten aan. Het wordt aanbevolen om Snapshot te gebruiken voor het genereren van screenshots — hun uitvoerformaat is compatibel met Deliver.

De prijsgroep wordt geconfigureerd via de parameter price_tier, die het nummer van het prijsniveau van 0 tot 87 accepteert. Apple-prijsgroepen worden automatisch geconverteerd naar valuta's van alle aanwezige landen. Deliver maakt het mogelijk om de prijs binnen een release te wijzigen, wat handig is voor tijdelijke promoties of het wijzigen van het bedrijfsmodel van de app.

Deliver commando's voor het publiceren van apps

De Deliver-interface bevat commando's voor het uploaden van metadata, binaire bestanden, screenshots en volledige releases. Het hoofdcommando fastlane deliver zonder parameters gebruikt gegevens uit Deliverfile en de metadata-directory voor de volledige publicatiecyclus.

Het commando fastlane deliver --preview start voorlopige verificatie van metadata zonder daadwerkelijke upload naar App Store Connect. --force is vereist voor uploaden — zonder dit werkt Deliver in preview-modus. De parameter --skip_binary uploadt alleen metadata en screenshots, waarbij het uploaden van het binaire bestand wordt overgeslagen — dit is handig voor snelle bijwerking van ASO-velden zonder nieuwe release.

# Volledige release met uploaden van binair bestand
fastlane deliver --force --ipa "build/App.ipa"

# Alleen metadata uploaden zonder binair bestand
fastlane deliver --force --skip_binary

# Alleen screenshots bijwerken
fastlane deliver --force --skip_metadata

De parameter --skip_metadata uploadt alleen screenshots en het binaire bestand, waarbij bestaande metadata ongewijzigd blijven. Dit is handig voor hotfix-releases, wanneer een snelle correctie moet worden uitgebracht zonder wijziging van beschrijving en ASO-velden. Combinatie van vlaggen maakt flexibel beheer van elke publicatiefase afzonderlijk mogelijk.

Integratie van Deliver in de release-pipeline

De release-pipeline met Deliver — is een compleet CI/CD-proces voor iOS dat alle fasen van commit tot publicatie in de App Store automatiseert. Een typische pipeline omvat: Match voor certificaten, Gym voor IPA-build, Snapshot voor screenshots en Deliver voor het uploaden van alle gegevens naar de App Store met aansluitend verzenden naar moderatie.

Het belangrijkste kenmerk van Deliver in de pipeline — ondersteuning voor metadata.json, dat metadata opslaat in gestructureerd JSON-formaat. Dit maakt het mogelijk om metadata programmatisch te genereren uit externe CMS-systemen of automatisch beschrijvingen in meerdere talen te maken via een vertaal-API.

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

Zorg ervoor dat alle metadata up-to-date zijn voordat u Deliver in de pipeline aanroept: de beschrijving komt overeen met de nieuwe versie, screenshots zijn bijgewerkt voor nieuwe functies en de prijsgroep vereist geen wijzigingen. Submit for review stuurt de app naar Apple-moderatie, die 24 tot 48 uur duurt voor nieuwe apps en 2 tot 12 uur voor updates.

Deliver ondersteunt het app_version mechanisme, waarmee u de doelversie voor het bijwerken van metadata kunt opgeven. Als de versie niet is opgegeven, werkt Deliver de huidige actieve versie van de app in App Store Connect bij. Voor het uitbrengen van een nieuwe versie moet eerst de bijbehorende versie worden aangemaakt via de App Store Connect-interface of API.

Veelvoorkomende fouten bij het werken met Deliver

Bij het gebruik van Deliver komen ontwikkelaars vaak validatiefouten van metadata, onjuiste bestandsstructuur van screenshots en authenticatieproblemen tegen. Foutdiagnose van Deliver begint met analyse van de commandologs — Deliver geeft gedetailleerde informatie over elke uploadfase en de redenen van afwijzing.

De fout „Invalid screenshot path„ treedt op wanneer de mapstructuur met screenshots niet overeenkomt met het verwachte formaat. Oplossing: controleer de bestandsnamen van screenshots op overeenstemming met het sjabloon DeviceType_ScreenSize_Number.png (bijv. AppleiPhone15ProMax_6.7_01.png). Deliver is gevoelig voor hoofdletters en scheidingstekens in bestandsnamen.

De fout „Metadata validation failed„ duidt op niet-naleving van metadata met App Store-vereisten. Oplossing: controleer de lengte van de beschrijving (tot 4000 tekens), trefwoorden (tot 100 tekens) en naam (tot 30 tekens). App Store Review Guidelines bevat volledige vereisten voor elk metadataveld — het wordt aanbevolen om deze voor elke release te controleren.

Bij de fout „Apple ID not found„ bestaat de app niet in App Store Connect met het opgegeven apple_identifier. Oplossing: maak een app-record aan in App Store Connect via de webinterface vóór de eerste aanroep van Deliver, met opgave van Bundle Identifier en naam. Deliver maakt geen nieuwe apps aan — het werkt alleen bestaande records in de winkel bij.