Deliver (Fastlane) — ano ito, pag-upload sa App Store at configuration sa pag-develop ng iOS at Android

Ano ang Deliver (Fastlane)?

Deliver (Fastlane) — ay isang bahagi ng Fastlane ecosystem na nag-a-automate ng proseso ng pag-publish ng mga mobile app sa App Store. Pinamamahalaan nito ang pag-upload ng mga binary file, pag-update ng metadata (pangalan, paglalarawan, mga keyword), pag-upload ng mga screenshot at pag-configure ng mga presyo para sa lahat ng wika ng lokalisasyon.

Kung wala ang Deliver, ang bawat release ay nangangailangan ng manu-manong pag-update ng impormasyon sa pamamagitan ng App Store Connect web interface: pagpuno ng paglalarawan sa maraming wika, pag-upload ng mga screenshot para sa bawat laki ng screen, pag-update ng mga keyword at pag-configure ng mga presyo. Pag-publish sa App Store — ay ang huling yugto ng lifecycle ng isang iOS app, kasama ang pag-verify ng binary file, moderasyon ng nilalaman at paglabas ng app sa produksyon.

Ayon sa App Store Connect Documentation (2025), ang mga app na may regular na pag-update ay tumatanggap ng 30% na mas maraming re-install at mas mahusay na nagra-rank sa paghahanap. Ang Deliver ay nagpapahintulot sa mga team na maglabas ng lingguhang pag-update, i-automate ang mga routine na hakbang ng pag-publish at bawasan ang panganib ng pagkakamali ng tao sa pagpuno ng metadata sa dose-dosenang wika.

Gamitin ang Deliver para sa anumang app na nai-publish sa App Store — lalong mahalaga para sa mga proyekto na may multilinggwal na lokalisasyon, kung saan ang manu-manong pag-update ng 32 wika ay tumatagal ng ilang oras.

Paano gumagana ang Deliver sa App Store Connect

Mekanismo ng paggana ng Deliver ay batay sa dalawang-yugtong proseso. Sa unang yugto, inihahanda ng tool ang metadata — sinusuri ang istraktura ng Deliverfile, naglo-load ng mga screenshot at lumilikha ng manifest ng mga pagbabago. Sa ikalawang yugto, ipinapadala ng Deliver ang data sa App Store Connect API, nag-upload ng binary file at sinimulan ang proseso ng pag-verify ng build sa panig ng Apple.

Gumagamit ang Deliver ng App Store Connect API para sa lahat ng operasyon, na ginagarantiyahan ang pagiging tugma sa mga bagong kinakailangan ng Apple at hindi kasama ang paggamit ng mga pribadong interface. App Store Connect API — ay ang opisyal na Apple REST API para sa pag-automate ng mga operasyon sa mga app, kabilang ang pag-upload ng mga build, pamamahala ng metadata at pagsubaybay sa status ng review.

Pag-upload ng mga binary file

Ang Deliver ay direktang nag-i-integrate sa Gym sa pamamagitan ng Fastlane: pagkatapos ng IPA build, ina-upload ito ng Deliver sa App Store Connect at sinisimulan ang proseso ng pagproseso. Ang parameter na --ipa ay nagpapahiwatig ng landas patungo sa binary file. Kung ang parameter ay hindi tinukoy, awtomatikong hinahanap ng Deliver ang huling IPA sa build directory na tinukoy sa Gymfile o naipasa sa pamamagitan ng mga nakaraang hakbang ng Fastlane.

Pagkatapos ng pag-upload, naghihintay ang Deliver ng pagkumpleto ng pagproseso ng binary file ng Apple — katulad ng Pilot, ang status ay sinusubaybayan sa pamamagitan ng progress bar. Mga available na status: Processing, Waiting For Review, In Review, Ready For Sale o Rejected. Ipinapaalam ng Deliver sa team ang bawat pagbabago ng status sa pamamagitan ng mga callback sa Fastfile.

Pamamahala ng metadata ng app

Pinamamahalaan ng Deliver ang buong set ng metadata ng app: pangalan, paglalarawan (maikli at buo), mga keyword, URL ng suporta at marketing, kategorya at rating ng edad. Metadata ng app — ay tekstuwal na impormasyon tungkol sa app na ipinapakita sa pahina ng App Store at ginagamit para sa pag-index ng paghahanap at ASO optimization.

Ang parameter na --submit_for_review ay nagpapadala ng app sa moderasyon kaagad pagkatapos ng pag-upload ng metadata. Ito ay isang mahalagang parameter para sa ganap na automated na release. Kung wala ito, ang Deliver ay nag-a-upload lamang ng data ngunit hindi nagpapadala ng app para sa review — ito ay kapaki-pakinabang para sa paunang pagsuri ng lahat ng field bago ang aktwal na pag-submit.

Pagtatrabaho sa mga screenshot

Awtomatikong nag-a-upload ang Deliver ng mga screenshot para sa lahat ng kombinasyon ng device at wika mula sa tinukoy na direktoryo. Ang mga pangalan ng file ay dapat sumunod sa pattern: iPhone_6.5_01.png para sa iPhone na may 6.5 pulgadang diagonal sa unang slot. Ang Deliver mismo ang tumutukoy sa laki ng screenshot at inaayos ito sa mga kinakailangan ng Apple para sa bawat uri ng device.

Ang mga screenshot ay nai-upload sa tamang pagkakasunod-sunod at para sa bawat wika ng lokalisasyon nang hiwalay. Kung para sa isang wika ay walang nakitang mga screenshot, ginagamit ng Deliver ang mga bersyong Ingles bilang backup na opsyon. Lokalisasyon ng mga screenshot — ay isang mandatoryong kinakailangan para sa mga app na gustong mag-rank nang maayos sa App Store ng iba't ibang bansa, dahil isinasaalang-alang ng Apple ang lokal na nilalaman sa mga resulta ng paghahanap.

# Pangunahing command para sa pag-upload sa App Store
fastlane deliver

# Pag-upload na may pagtukoy ng metadata at mga screenshot
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Preview nang walang pag-upload
fastlane deliver --preview

Configuration ng Deliver sa pamamagitan ng Deliverfile

Deliverfile — ay isang configuration file ng Fastlane para sa pag-imbak ng metadata ng app sa structured na Ruby format. Hindi tulad ng manu-manong pagpuno ng mga form sa App Store Connect, pinapayagan ng Deliverfile ang pag-version ng metadata sa Git at pagsuri ng mga pagbabago sa pamamagitan ng code review bago ang pag-publish.

# Deliverfile — metadata ng app
app_identifier("com.company.app")
title("MyApp")
description("Paglalarawan ng app para sa tindahan")
keywords("mobile, app, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Mga wika ng lokalisasyon ng metadata
languages(["en-US", "ru", "de"])

Ang parameter na languages ay tumutukoy kung para sa aling mga wika mai-upload ang metadata. Para sa bawat wika, dapat gumawa ng hiwalay na direktoryo sa folder na fastlane/metadata na may kaukulang mga file ng paglalarawan, mga keyword at mga tekstong pang-marketing. Sinusuportahan ng Deliver ang hanggang 32 App Store na wika nang sabay-sabay.

Para sa pag-upload ng mga screenshot, ginagamit ang direktoryo na screenshots sa loob ng Fastlane folder. Istraktura ng folder: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Awtomatikong nag-a-upload ang Deliver ng mga screenshot para sa mga tinukoy na wika at device, inaayos ang mga sukat sa mga kinakailangan ng Apple. Inirerekomenda ang paggamit ng Snapshot para sa pagbuo ng mga screenshot — ang kanilang output format ay katugma sa Deliver.

Ang grupo ng presyo ay naka-configure sa pamamagitan ng parameter na price_tier, na tumatanggap ng numero ng antas ng presyo mula 0 hanggang 87. Ang mga grupo ng presyo ng Apple ay awtomatikong kino-convert sa mga pera ng lahat ng bansa ng presensya. Pinapayagan ng Deliver ang pagbabago ng presyo sa loob ng isang release, na kapaki-pakinabang para sa mga pansamantalang promo o pagbabago ng modelo ng negosyo ng app.

Mga command ng Deliver para sa pag-publish ng mga app

Interface ng Deliver ay may kasamang mga command para sa pag-upload ng metadata, mga binary file, mga screenshot at buong release. Ang pangunahing command na fastlane deliver na walang parameter ay gumagamit ng data mula sa Deliverfile at metadata directory para sa buong cycle ng pag-publish.

Ang command na fastlane deliver --preview ay nagsisimula ng paunang pag-verify ng metadata nang walang aktwal na pag-upload sa App Store Connect. --force ay kinakailangan para sa pag-upload — kung wala ito, ang Deliver ay gumagana sa preview mode. Ang parameter na --skip_binary ay nag-a-upload lamang ng metadata at mga screenshot, nilalaktawan ang pag-upload ng binary file — ito ay maginhawa para sa mabilis na pag-update ng mga ASO field nang walang bagong release.

# Buong release na may pag-upload ng binary file
fastlane deliver --force --ipa "build/App.ipa"

# Pag-upload lamang ng metadata nang walang binary file
fastlane deliver --force --skip_binary

# Pag-update lamang ng mga screenshot
fastlane deliver --force --skip_metadata

Ang parameter na --skip_metadata ay nag-a-upload lamang ng mga screenshot at binary file, pinapanatili ang umiiral na metadata nang walang pagbabago. Ito ay kapaki-pakinabang para sa mga hotfix release, kapag kailangan mong mabilis na maglabas ng pag-aayos nang hindi binabago ang paglalarawan at mga ASO field. Ang kombinasyon ng mga flag ay nagpapahintulot sa flexible na pamamahala ng bawat yugto ng pag-publish nang hiwalay.

Integrasyon ng Deliver sa release pipeline

Release pipeline kasama ang Deliver — ay isang kumpletong CI/CD process para sa iOS na nag-a-automate ng lahat ng yugto mula sa commit hanggang sa pag-publish sa App Store. Ang tipikal na pipeline ay may kasamang: Match para sa mga certificate, Gym para sa IPA build, Snapshot para sa mga screenshot at Deliver para sa pag-upload ng lahat ng data sa App Store na may kasunod na pagpapadala sa moderasyon.

Ang pangunahing tampok ng Deliver sa pipeline — suporta para sa metadata.json, na nag-iimbak ng metadata sa structured na JSON format. Ito ay nagpapahintulot sa programmatic na pagbuo ng metadata mula sa panlabas na CMS system o awtomatikong paglikha ng paglalarawan sa maraming wika sa pamamagitan ng translation API.

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

Bago tawagan ang Deliver sa pipeline, siguraduhin na ang lahat ng metadata ay napapanahon: ang paglalarawan ay tumutugma sa bagong bersyon, ang mga screenshot ay na-update para sa mga bagong feature at ang grupo ng presyo ay hindi nangangailangan ng pagbabago. Submit for review ay nagpapadala ng app sa Apple moderasyon, na tumatagal mula 24 hanggang 48 oras para sa mga bagong app at mula 2 hanggang 12 oras para sa mga update.

Sinusuportahan ng Deliver ang mekanismo ng app_version, na nagpapahintulot sa iyo na tukuyin ang target na bersyon para sa pag-update ng metadata. Kung ang bersyon ay hindi tinukoy, ina-update ng Deliver ang kasalukuyang aktibong bersyon ng app sa App Store Connect. Para sa pag-release ng bagong bersyon, kinakailangan munang lumikha ng kaukulang bersyon sa pamamagitan ng App Store Connect interface o API.

Mga karaniwang error kapag nagtatrabaho sa Deliver

Kapag gumagamit ng Deliver, ang mga developer ay madalas na nakakaranas ng mga error sa pag-validate ng metadata, hindi tamang istraktura ng file ng mga screenshot at mga problema sa pagpapatotoo. Diagnosis ng error ng Deliver ay nagsisimula sa pagsusuri ng mga log ng command — nagpapakita ang Deliver ng detalyadong impormasyon tungkol sa bawat yugto ng pag-upload at mga dahilan ng pagtanggi.

Ang error na „Invalid screenshot path„ ay nangyayari kapag ang istraktura ng folder na may mga screenshot ay hindi tumutugma sa inaasahang format. Solusyon: suriin ang mga pangalan ng file ng screenshot para sa pagsunod sa pattern na DeviceType_ScreenSize_Number.png (halimbawa AppleiPhone15ProMax_6.7_01.png). Ang Deliver ay sensitibo sa malaki at maliit na titik at mga separator sa mga pangalan ng file.

Ang error na „Metadata validation failed„ ay nagpapahiwatig ng hindi pagsunod ng metadata sa mga kinakailangan ng App Store. Solusyon: suriin ang haba ng paglalarawan (hanggang 4000 character), mga keyword (hanggang 100 character) at pangalan (hanggang 30 character). App Store Review Guidelines ay naglalaman ng kumpletong mga kinakailangan para sa bawat field ng metadata — inirerekomenda na suriin ang mga ito bago ang bawat release.

Sa error na „Apple ID not found„ ang app ay hindi umiiral sa App Store Connect na may tinukoy na apple_identifier. Solusyon: lumikha ng tala ng app sa App Store Connect sa pamamagitan ng web interface bago ang unang tawag sa Deliver, na tinutukoy ang Bundle Identifier at pangalan. Ang Deliver ay hindi lumilikha ng mga bagong app — ito ay nag-a-update lamang ng mga umiiral na tala sa tindahan.