Deliver (Fastlane) — ce este, încărcarea în App Store și configurarea în dezvoltarea iOS și Android

Ce este Deliver (Fastlane)?

Deliver (Fastlane) — este o componentă a ecosistemului Fastlane care automatizează procesul de publicare a aplicațiilor mobile în App Store. Gerează încărcarea fișierelor binare, actualizarea metadatelor (nume, descriere, cuvinte cheie), încărcarea capturilor de ecran și configurarea prețurilor pentru toate limbile de localizare.

Fără Deliver, fiecare lansare necesită actualizarea manuală a informațiilor prin interfața web App Store Connect: completarea descrierii în mai multe limbi, încărcarea capturilor de ecran pentru fiecare dimensiune de ecran, actualizarea cuvintelor cheie și configurarea prețurilor. Publicarea în App Store — este etapa finală a ciclului de viață al unei aplicații iOS, care include verificarea fișierului binar, moderarea conținutului și lansarea aplicației în producție.

Conform App Store Connect Documentation (2025), aplicațiile cu actualizări regulate primesc cu 30% mai multe reinstalări și se clasează mai bine în căutare. Deliver permite echipelor să lanseze actualizări săptămânale, automatizând pașii de rutină ai publicării și reducând riscul de eroare umană la completarea metadatelor în zeci de limbi.

Folosiți Deliver pentru orice aplicație publicată în App Store — este deosebit de valoros pentru proiecte cu localizare multilingvă, unde actualizarea manuală a 32 de limbi durează câteva ore.

Cum funcționează Deliver cu App Store Connect

Mecanismul de funcționare al Deliver se bazează pe un proces în două etape. În prima etapă, instrumentul pregătește metadatele — verifică structura Deliverfile, încarcă capturile de ecran și generează manifestul modificărilor. În a doua etapă, Deliver trimite datele către App Store Connect API, încarcă fișierul binar și pornește procesul de verificare a build-ului de către Apple.

Deliver folosește App Store Connect API pentru toate operațiunile, ceea ce garantează compatibilitatea cu noile cerințe Apple și exclude utilizarea interfețelor private. App Store Connect API — este API-ul REST oficial Apple pentru automatizarea operațiunilor cu aplicații, inclusiv încărcarea build-urilor, gestionarea metadatelor și urmărirea statusului de revizuire.

Încărcarea fișierelor binare

Deliver se integrează direct cu Gym prin Fastlane: după build-ul IPA, Deliver îl încarcă în App Store Connect și pornește procesul de procesare. Parametrul --ipa indică calea către fișierul binar. Dacă parametrul nu este specificat, Deliver găsește automat ultimul IPA în directorul de build specificat în Gymfile sau transmis prin pașii anteriori ai Fastlane.

După încărcare, Deliver așteaptă finalizarea procesării fișierului binar de către Apple — similar cu Pilot, statusul este urmărit printr-o bară de progres. Statusurile disponibile: Processing, Waiting For Review, In Review, Ready For Sale sau Rejected. Deliver notifică echipa despre fiecare schimbare de status prin callback-uri în Fastfile.

Gestionarea metadatelor aplicației

Deliver gestionează setul complet de metadate ale aplicației: nume, descriere (scurtă și completă), cuvinte cheie, URL de suport și marketing, categorie și rating de vârstă. Metadatele aplicației — sunt informațiile text despre aplicație care sunt afișate pe pagina App Store și utilizate pentru indexarea în căutare și optimizarea ASO.

Parametrul --submit_for_review trimite aplicația la moderare imediat după încărcarea metadatelor. Acesta este un parametru cheie pentru o lansare complet automatizată. Fără el, Deliver doar încarcă datele, dar nu trimite aplicația la revizuire — acest lucru este util pentru verificarea preliminară a tuturor câmpurilor înainte de trimiterea efectivă.

Lucrul cu capturile de ecran

Deliver încarcă automat capturi de ecran pentru toate combinațiile de dispozitive și limbi din directorul specificat. Numele fișierelor trebuie să respecte șablonul: iPhone_6.5_01.png pentru iPhone cu diagonala de 6.5 inci pe primul slot. Deliver determină singur dimensiunea capturii de ecran și o potrivește cu cerințele Apple pentru fiecare tip de dispozitiv.

Capturile de ecran sunt încărcate în ordinea corectă și pentru fiecare limbă de localizare separat. Dacă pentru o limbă nu se găsesc capturi de ecran, Deliver folosește versiunile în engleză ca opțiune de rezervă. Localizarea capturilor de ecran — este o cerință obligatorie pentru aplicațiile care doresc să se claseze bine în App Store din diferite țări, deoarece Apple ia în considerare conținutul local în rezultatele căutării.

# Comanda de bază pentru încărcarea în App Store
fastlane deliver

# Încărcarea cu specificarea metadatelor și capturilor de ecran
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Previzualizare fără încărcare
fastlane deliver --preview

Configurarea Deliver prin Deliverfile

Deliverfile — este un fișier de configurare Fastlane pentru stocarea metadatelor aplicației într-un format Ruby structurat. Spre deosebire de completarea manuală a formularelor în App Store Connect, Deliverfile permite versionarea metadatelor în Git și verificarea modificărilor prin code review înainte de publicare.

# Deliverfile — metadatele aplicației
app_identifier("com.company.app")
title("MyApp")
description("Descrierea aplicației pentru magazin")
keywords("mobil, aplicație, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Limbile de localizare a metadatelor
languages(["en-US", "ru", "de"])

Parametrul languages determină pentru care limbi vor fi încărcate metadatele. Pentru fiecare limbă trebuie creat un director separat în folderul fastlane/metadata cu fișierele corespunzătoare de descriere, cuvinte cheie și texte de marketing. Deliver suportă simultan până la 32 de limbi App Store.

Pentru încărcarea capturilor de ecran se folosește directorul screenshots din folderul Fastlane. Structura folderelor: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver încarcă automat capturile de ecran pentru limbile și dispozitivele specificate, potrivind dimensiunile cu cerințele Apple. Se recomandă utilizarea Snapshot pentru generarea capturilor de ecran — formatul lor de ieșire este compatibil cu Deliver.

Grupul de prețuri se configurează prin parametrul price_tier, care acceptă numărul nivelului de preț de la 0 la 87. Grupurile de prețuri Apple sunt convertite automat în valutele tuturor țărilor de prezență. Deliver permite schimbarea prețului în cadrul lansării, ceea ce este util pentru promoții temporare sau modificarea modelului de afaceri al aplicației.

Comenzile Deliver pentru publicarea aplicațiilor

Interfața Deliver include comenzi pentru încărcarea metadatelor, fișierelor binare, capturilor de ecran și lansarea completă. Comanda principală fastlane deliver fără parametri folosește datele din Deliverfile și directorul metadata pentru ciclul complet de publicare.

Comanda fastlane deliver --preview pornește verificarea preliminară a metadatelor fără încărcarea efectivă în App Store Connect. --force este necesar pentru încărcare — fără el, Deliver funcționează în modul previzualizare. Parametrul --skip_binary încarcă doar metadatele și capturile de ecran, omițând încărcarea fișierului binar — acest lucru este convenabil pentru actualizarea rapidă a câmpurilor ASO fără o nouă lansare.

# Lansare completă cu încărcarea fișierului binar
fastlane deliver --force --ipa "build/App.ipa"

# Încărcarea doar a metadatelor fără fișier binar
fastlane deliver --force --skip_binary

# Actualizarea doar a capturilor de ecran
fastlane deliver --force --skip_metadata

Parametrul --skip_metadata încarcă doar capturile de ecran și fișierul binar, păstrând metadatele existente fără modificări. Acest lucru este util pentru lansările hotfix, când trebuie să publicați rapid o corecție fără a modifica descrierea și câmpurile ASO. Combinația de flaguri permite gestionarea flexibilă a fiecărei etape de publicare separat.

Integrarea Deliver în pipeline-ul de lansare

Pipeline-ul de lansare cu Deliver — este un proces CI/CD complet pentru iOS, care automatizează toate etapele de la commit la publicarea în App Store. Un pipeline tipic include: Match pentru certificate, Gym pentru build-ul IPA, Snapshot pentru capturi de ecran și Deliver pentru încărcarea tuturor datelor în App Store cu trimiterea ulterioară la moderare.

Caracteristica cheie a Deliver în pipeline — suportul pentru metadata.json, care stochează metadatele într-un format JSON structurat. Acest lucru permite generarea programatică a metadatelor din sisteme CMS externe sau crearea automată a descrierii în mai multe limbi prin API de traducere.

# Pipeline de lansare în 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

Înainte de a apela Deliver în pipeline, asigurați-vă că toate metadatele sunt actualizate: descrierea corespunde noii versiuni, capturile de ecran sunt actualizate pentru noile funcții, iar grupul de prețuri nu necesită modificări. Submit for review trimite aplicația la moderarea Apple, care durează între 24 și 48 de ore pentru aplicațiile noi și între 2 și 12 ore pentru actualizări.

Deliver suportă mecanismul app_version, care permite specificarea versiunii țintă pentru actualizarea metadatelor. Dacă versiunea nu este specificată, Deliver actualizează versiunea activă curentă a aplicației în App Store Connect. Pentru lansarea unei noi versiuni, trebuie să creați mai întâi versiunea corespunzătoare prin interfața App Store Connect sau API.

Erori tipice la lucrul cu Deliver

La utilizarea Deliver, dezvoltatorii întâmpină adesea erori de validare a metadatelor, structura incorectă a fișierelor de capturi de ecran și probleme de autentificare. Diagnosticarea erorilor Deliver începe cu analiza logurilor comenzii — Deliver afișează informații detaliate despre fiecare etapă de încărcare și motivele respingerii.

Eroarea „Invalid screenshot path„ apare atunci când structura folderelor cu capturi de ecran nu corespunde formatului așteptat. Soluție: verificați numele fișierelor de capturi de ecran pentru conformitatea cu șablonul DeviceType_ScreenSize_Number.png (de exemplu AppleiPhone15ProMax_6.7_01.png). Deliver este sensibil la majuscule și separatori în numele fișierelor.

Eroarea „Metadata validation failed„ indică neconformitatea metadatelor cu cerințele App Store. Soluție: verificați lungimea descrierii (până la 4000 de caractere), a cuvintelor cheie (până la 100 de caractere) și a numelui (până la 30 de caractere). App Store Review Guidelines conține cerințe complete pentru fiecare câmp de metadate — se recomandă verificarea acestora înainte de fiecare lansare.

La eroarea „Apple ID not found„ aplicația nu există în App Store Connect cu apple_identifier specificat. Soluție: creați o înregistrare a aplicației în App Store Connect prin interfața web înainte de prima apelare a Deliver, specificând Bundle Identifier și numele. Deliver nu creează aplicații noi — actualizează doar înregistrările existente în magazin.