Deliver (Fastlane) — was es ist, Upload in den App Store und Konfiguration in der iOS- und Android-Entwicklung

Was ist Deliver (Fastlane)?

Deliver (Fastlane) ist eine Komponente des Fastlane-Ökosystems, die den Prozess der Veröffentlichung von mobilen Apps im App Store automatisiert. Es verwaltet das Hochladen von Binärdateien, die Aktualisierung von Metadaten (Name, Beschreibung, Schlüsselwörter), das Hochladen von Screenshots und die Preiskonfiguration für alle Lokalisierungssprachen.

Ohne Deliver erfordert jedes Release die manuelle Aktualisierung von Informationen über die App Store Connect-Weboberfläche: Ausfüllen von Beschreibungen in mehreren Sprachen, Hochladen von Screenshots für jede Bildschirmgröße, Aktualisieren von Schlüsselwörtern und Konfigurieren von Preisen. Die App Store-Veröffentlichung ist die letzte Phase des iOS-App-Lebenszyklus, die die Überprüfung der Binärdatei, die Inhaltsmoderation und die Bereitstellung der App in der Produktion umfasst.

Laut der App Store Connect Dokumentation (2025) erhalten Apps mit regelmäßigen Updates 30% mehr erneute Installationen und werden in den Suchergebnissen besser platziert. Deliver ermöglicht es Teams, Updates wöchentlich zu veröffentlichen, indem es routinemäßige Veröffentlichungsschritte automatisiert und das Risiko menschlicher Fehler beim Ausfüllen von Metadaten in Dutzenden von Sprachen reduziert.

Verwenden Sie Deliver für jede App, die im App Store veröffentlicht wird — besonders wertvoll für Projekte mit mehrsprachiger Lokalisierung, bei denen die manuelle Aktualisierung von 32 Sprachen mehrere Stunden dauert.

Wie Deliver mit App Store Connect arbeitet

Der Funktionsmechanismus von Deliver basiert auf einem zweistufigen Prozess. In der ersten Stufe bereitet das Tool die Metadaten vor — es validiert die Deliverfile-Struktur, lädt Screenshots und erstellt ein Änderungsmanifest. In der zweiten Stufe sendet Deliver die Daten an die App Store Connect API, lädt die Binärdatei hoch und startet den Build-Überprüfungsprozess auf Apple-Seite.

Deliver verwendet für alle Operationen die App Store Connect API, was die Kompatibilität mit den neuesten Apple-Anforderungen gewährleistet und die Verwendung privater Schnittstellen ausschließt. Die App Store Connect API ist Apples offizielle REST-API zur Automatisierung von App-Operationen, einschließlich Build-Uploads, Metadatenverwaltung und Review-Statusverfolgung.

Upload von Binärdateien

Deliver integriert sich direkt mit Gym über Fastlane: Nach dem IPA-Build lädt Deliver es in den App Store Connect hoch und startet die Verarbeitung. Der Parameter --ipa gibt den Pfad zur Binärdatei an. Wenn nicht angegeben, findet Deliver automatisch die neueste IPA im Build-Verzeichnis, das in der Gymfile angegeben oder über vorherige Fastlane-Schritte übergeben wurde.

Nach dem Upload wartet Deliver auf den Abschluss der Binärdateiverarbeitung durch Apple — ähnlich wie Pilot wird der Status über eine Fortschrittsanzeige verfolgt. Verfügbare Status: Processing, Waiting For Review, In Review, Ready For Sale oder Rejected. Deliver benachrichtigt das Team über jede Statusänderung über Callbacks in der Fastfile.

Verwaltung von App-Metadaten

Deliver verwaltet den vollständigen Satz von App-Metadaten: Name, Beschreibung (kurz und vollständig), Schlüsselwörter, Support- und Marketing-URLs, Kategorie und Altersfreigabe. App-Metadaten sind die Textinformationen über die App, die auf der App Store-Seite angezeigt und für die Suchindexierung und ASO-Optimierung verwendet werden.

Der Parameter --submit_for_review sendet die App unmittelbar nach dem Hochladen der Metadaten zur Moderation. Dies ist ein Schlüsselparameter für vollständig automatisierte Releases. Ohne ihn lädt Deliver nur Daten hoch, reicht die App aber nicht zur Überprüfung ein — nützlich zur Vorabprüfung aller Felder vor der eigentlichen Einreichung.

Arbeiten mit Screenshots

Deliver lädt automatisch Screenshots für alle Geräte- und Sprachkombinationen aus dem angegebenen Verzeichnis hoch. Dateinamen müssen dem Muster folgen: iPhone_6.5_01.png für ein 6,5-Zoll-iPhone im ersten Slot. Deliver ermittelt die Screenshot-Größe und gleicht sie mit den Apple-Anforderungen für jeden Gerätetyp ab.

Screenshots werden in der richtigen Reihenfolge und getrennt für jede Lokalisierungssprache hochgeladen. Wenn für eine Sprache keine Screenshots gefunden werden, verwendet Deliver englische Versionen als Fallback. Screenshot-Lokalisierung ist eine zwingende Anforderung für Apps, die in verschiedenen Ländern im App Store gut platziert werden möchten, da Apple lokale Inhalte in den Suchergebnissen berücksichtigt.

# Basisbefehl zum Upload in den App Store
fastlane deliver

# Upload mit angegebenen Metadaten und Screenshots
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Vorschau ohne Upload
fastlane deliver --preview

Deliver-Konfiguration über Deliverfile

Deliverfile ist eine Fastlane-Konfigurationsdatei zum Speichern von App-Metadaten in einem strukturierten Ruby-Format. Im Gegensatz zum manuellen Ausfüllen von Formularen in App Store Connect ermöglicht die Deliverfile die Versionierung von Metadaten in Git und die Überprüfung von Änderungen durch Code-Reviews vor der Veröffentlichung.

# Deliverfile — App-Metadaten
app_identifier("com.company.app")
title("MyApp")
description("App-Beschreibung für den Store")
keywords("mobil, app, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Metadaten-Lokalisierungssprachen
languages(["en-US", "ru", "de"])

Der Parameter languages bestimmt, für welche Sprachen Metadaten hochgeladen werden. Für jede Sprache muss ein separates Verzeichnis im Ordner fastlane/metadata mit entsprechenden Beschreibungs-, Schlüsselwort- und Marketingtextdateien erstellt werden. Deliver unterstützt gleichzeitig bis zu 32 App Store-Sprachen.

Für den Screenshot-Upload wird das Verzeichnis screenshots im Fastlane-Ordner verwendet. Ordnerstruktur: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver lädt automatisch Screenshots für die angegebenen Sprachen und Geräte hoch und gleicht die Größen mit den Apple-Anforderungen ab. Es wird empfohlen, Snapshot zum Generieren von Screenshots zu verwenden — das Ausgabeformat ist mit Deliver kompatibel.

Die Preisgruppe wird über den Parameter price_tier konfiguriert, der eine Preisstufennummer von 0 bis 87 akzeptiert. Apples Preisstufen werden automatisch in die Währungen aller Präsenzländer umgerechnet. Deliver erlaubt die Preisänderung im Rahmen eines Releases, nützlich für zeitlich begrenzte Aktionen oder Änderungen des Geschäftsmodells der App.

Deliver-Befehle zum Veröffentlichen von Apps

Die Deliver-Oberfläche enthält Befehle zum Hochladen von Metadaten, Binärdateien, Screenshots und vollständigen Releases. Der Hauptbefehl fastlane deliver ohne Parameter verwendet Daten aus der Deliverfile und dem Metadatenverzeichnis für einen vollständigen Veröffentlichungszyklus.

Der Befehl fastlane deliver --preview führt eine vorläufige Metadatenüberprüfung durch, ohne tatsächlich in den App Store Connect hochzuladen. --force ist für den Upload erforderlich — ohne ihn arbeitet Deliver im Vorschaumodus. Der Parameter --skip_binary lädt nur Metadaten und Screenshots hoch und überspringt den Upload der Binärdatei — praktisch für schnelle ASO-Feldaktualisierungen ohne neues Release.

# Vollständiges Release mit Binärdatei-Upload
fastlane deliver --force --ipa "build/App.ipa"

# Nur Metadaten ohne Binärdatei hochladen
fastlane deliver --force --skip_binary

# Nur Screenshots aktualisieren
fastlane deliver --force --skip_metadata

Der Parameter --skip_metadata lädt nur Screenshots und die Binärdatei hoch und lässt vorhandene Metadaten unverändert. Dies ist nützlich für Hotfix-Releases, wenn eine Korrektur schnell veröffentlicht werden muss, ohne die Beschreibung und ASO-Felder zu ändern. Die Kombination von Flags ermöglicht eine flexible separate Verwaltung jeder Veröffentlichungsstufe.

Integration von Deliver in die Release-Pipeline

Release-Pipeline mit Deliver ist ein vollständiger CI/CD-Prozess für iOS, der alle Phasen vom Commit bis zur App Store-Veröffentlichung automatisiert. Eine typische Pipeline umfasst: Match für Zertifikate, Gym für IPA-Builds, Snapshot für Screenshots und Deliver zum Hochladen aller Daten in den App Store Connect mit anschließender Einreichung zur Moderation.

Ein entscheidendes Merkmal von Deliver in der Pipeline ist die Unterstützung von metadata.json, das Metadaten in einem strukturierten JSON-Format speichert. Dies ermöglicht die programmatische Generierung von Metadaten aus externen CMS-Systemen oder die automatische Erstellung von Beschreibungen in mehreren Sprachen über eine Übersetzungs-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

Stellen Sie vor dem Aufruf von Deliver in der Pipeline sicher, dass alle Metadaten aktuell sind: Die Beschreibung entspricht der neuen Version, Screenshots sind für neue Funktionen aktualisiert und die Preisgruppe muss nicht geändert werden. Submit for review sendet die App zur Apple-Moderation, die 24 bis 48 Stunden für neue Apps und 2 bis 12 Stunden für Updates dauert.

Deliver unterstützt den Mechanismus app_version, der die Angabe der Zielversion für Metadatenupdates ermöglicht. Wenn keine Version angegeben ist, aktualisiert Deliver die aktuell aktive Version der App in App Store Connect. Um eine neue Version zu veröffentlichen, muss zunächst die entsprechende Version über die App Store Connect-Oberfläche oder API erstellt werden.

Häufige Fehler bei der Arbeit mit Deliver

Bei der Verwendung von Deliver stoßen Entwickler häufig auf Metadatenvalidierungsfehler, falsche Screenshot-Dateistrukturen und Authentifizierungsprobleme. Die Fehlerdiagnose in Deliver beginnt mit der Analyse der Befehlsprotokolle — Deliver gibt detaillierte Informationen zu jeder Upload-Phase und den Ablehnungsgründen aus.

Der Fehler „Invalid screenshot path“ tritt auf, wenn die Ordnerstruktur der Screenshots nicht dem erwarteten Format entspricht. Lösung: Überprüfen Sie, ob die Screenshot-Dateinamen dem Muster DeviceType_ScreenSize_Number.png folgen (z.B. AppleiPhone15ProMax_6.7_01.png). Deliver unterscheidet zwischen Groß- und Kleinschreibung und ist empfindlich gegenüber Trennzeichen in Dateinamen.

Der Fehler „Metadata validation failed“ zeigt an, dass die Metadaten nicht den App Store-Anforderungen entsprechen. Lösung: Überprüfen Sie die Länge der Beschreibung (bis zu 4000 Zeichen), der Schlüsselwörter (bis zu 100 Zeichen) und des Namens (bis zu 30 Zeichen). Die App Store Review Guidelines enthalten vollständige Anforderungen für jedes Metadatenfeld — es wird empfohlen, sie vor jedem Release zu überprüfen.

Beim Fehler „Apple ID not found“ existiert die App mit der angegebenen apple_identifier nicht in App Store Connect. Lösung: Erstellen Sie den App-Eintrag in App Store Connect über die Weboberfläche vor dem ersten Deliver-Aufruf, wobei Sie die Bundle-ID und den Namen angeben. Deliver erstellt keine neuen Apps — es aktualisiert nur vorhandene Einträge im Store.