Deliver (Fastlane) — apa itu, upload ke App Store dan konfigurasi dalam pengembangan iOS dan Android

Apa itu Deliver (Fastlane)?

Deliver (Fastlane) — adalah komponen ekosistem Fastlane yang mengotomatiskan proses publikasi aplikasi mobile di App Store. Ia mengelola upload file biner, pembaruan metadata (nama, deskripsi, kata kunci), upload screenshot, dan pengaturan harga untuk semua bahasa lokalisasi.

Tanpa Deliver, setiap rilis memerlukan pembaruan manual informasi melalui antarmuka web App Store Connect: mengisi deskripsi dalam beberapa bahasa, mengupload screenshot untuk setiap ukuran layar, memperbarui kata kunci, dan mengatur harga. Publikasi di App Store — adalah tahap akhir dari siklus hidup aplikasi iOS, yang mencakup verifikasi file biner, moderasi konten, dan merilis aplikasi ke produksi.

Menurut App Store Connect Documentation (2025), aplikasi dengan pembaruan rutin menerima 30% lebih banyak instalasi ulang dan mendapat peringkat lebih baik dalam pencarian. Deliver memungkinkan tim untuk merilis pembaruan mingguan, mengotomatiskan langkah-langkah rutin publikasi dan mengurangi risiko kesalahan manusia saat mengisi metadata dalam puluhan bahasa.

Gunakan Deliver untuk aplikasi apa pun yang dipublikasikan di App Store — sangat berharga untuk proyek dengan lokalisasi multibahasa, di mana pembaruan manual 32 bahasa memakan waktu beberapa jam.

Bagaimana Deliver bekerja dengan App Store Connect

Mekanisme kerja Deliver didasarkan pada proses dua tahap. Pada tahap pertama, alat menyiapkan metadata — memeriksa struktur Deliverfile, memuat screenshot, dan menghasilkan manifes perubahan. Pada tahap kedua, Deliver mengirim data ke App Store Connect API, mengupload file biner, dan memulai proses verifikasi build oleh Apple.

Deliver menggunakan App Store Connect API untuk semua operasi, yang menjamin kompatibilitas dengan persyaratan baru Apple dan mengecualikan penggunaan antarmuka pribadi. App Store Connect API — adalah REST API resmi Apple untuk mengotomatiskan operasi dengan aplikasi, termasuk upload build, pengelolaan metadata, dan pelacakan status review.

Upload file biner

Deliver terintegrasi langsung dengan Gym melalui Fastlane: setelah build IPA, Deliver menguploadnya ke App Store Connect dan memulai proses pemrosesan. Parameter --ipa menunjukkan jalur ke file biner. Jika parameter tidak ditentukan, Deliver secara otomatis menemukan IPA terakhir di direktori build yang ditentukan di Gymfile atau diteruskan melalui langkah Fastlane sebelumnya.

Setelah upload, Deliver menunggu penyelesaian pemrosesan file biner oleh Apple — mirip dengan Pilot, status dilacak melalui bilah kemajuan. Status yang tersedia: Processing, Waiting For Review, In Review, Ready For Sale atau Rejected. Deliver memberi tahu tim tentang setiap perubahan status melalui callback di Fastfile.

Pengelolaan metadata aplikasi

Deliver mengelola set lengkap metadata aplikasi: nama, deskripsi (pendek dan lengkap), kata kunci, URL dukungan dan pemasaran, kategori, dan peringkat usia. Metadata aplikasi — adalah informasi teks tentang aplikasi yang ditampilkan di halaman App Store dan digunakan untuk indeksasi pencarian dan optimasi ASO.

Parameter --submit_for_review mengirim aplikasi ke moderasi segera setelah upload metadata. Ini adalah parameter kunci untuk rilis yang sepenuhnya otomatis. Tanpa itu, Deliver hanya mengupload data tetapi tidak mengirim aplikasi untuk review — ini berguna untuk pemeriksaan awal semua bidang sebelum pengiriman aktual.

Bekerja dengan screenshot

Deliver secara otomatis mengupload screenshot untuk semua kombinasi perangkat dan bahasa dari direktori yang ditentukan. Nama file harus sesuai dengan pola: iPhone_6.5_01.png untuk iPhone dengan diagonal 6,5 inci di slot pertama. Deliver sendiri menentukan ukuran screenshot dan menyesuaikannya dengan persyaratan Apple untuk setiap tipe perangkat.

Screenshot diupload dalam urutan yang benar dan untuk setiap bahasa lokalisasi secara terpisah. Jika untuk suatu bahasa tidak ditemukan screenshot, Deliver menggunakan versi bahasa Inggris sebagai opsi cadangan. Lokalisasi screenshot — adalah persyaratan wajib bagi aplikasi yang ingin mendapat peringkat baik di App Store berbagai negara, karena Apple mempertimbangkan konten lokal dalam hasil pencarian.

# Perintah dasar upload ke App Store
fastlane deliver

# Upload dengan menentukan metadata dan screenshot
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Pratinjau tanpa upload
fastlane deliver --preview

Konfigurasi Deliver melalui Deliverfile

Deliverfile — adalah file konfigurasi Fastlane untuk menyimpan metadata aplikasi dalam format Ruby terstruktur. Berbeda dengan pengisian formulir manual di App Store Connect, Deliverfile memungkinkan versioning metadata di Git dan pemeriksaan perubahan melalui code review sebelum publikasi.

# Deliverfile — metadata aplikasi
app_identifier("com.company.app")
title("MyApp")
description("Deskripsi aplikasi untuk toko")
keywords("mobile, aplikasi, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Bahasa lokalisasi metadata
languages(["en-US", "ru", "de"])

Parameter languages menentukan untuk bahasa mana metadata akan diupload. Untuk setiap bahasa, direktori terpisah harus dibuat di folder fastlane/metadata dengan file deskripsi, kata kunci, dan teks pemasaran yang sesuai. Deliver mendukung hingga 32 bahasa App Store secara bersamaan.

Untuk mengupload screenshot, gunakan direktori screenshots di dalam folder Fastlane. Struktur folder: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver secara otomatis mengupload screenshot untuk bahasa dan perangkat yang ditentukan, menyesuaikan ukuran dengan persyaratan Apple. Disarankan menggunakan Snapshot untuk menghasilkan screenshot — format outputnya kompatibel dengan Deliver.

Grup harga dikonfigurasi melalui parameter price_tier, yang menerima nomor tingkat harga dari 0 hingga 87. Grup harga Apple secara otomatis dikonversi ke mata uang semua negara tempat aplikasi tersedia. Deliver memungkinkan perubahan harga dalam rilis, yang berguna untuk promosi sementara atau perubahan model bisnis aplikasi.

Perintah Deliver untuk publikasi aplikasi

Antarmuka Deliver mencakup perintah untuk mengupload metadata, file biner, screenshot, dan rilis lengkap. Perintah utama fastlane deliver tanpa parameter menggunakan data dari Deliverfile dan direktori metadata untuk siklus publikasi penuh.

Perintah fastlane deliver --preview memulai verifikasi awal metadata tanpa upload aktual ke App Store Connect. --force diperlukan untuk upload — tanpa itu, Deliver bekerja dalam mode pratinjau. Parameter --skip_binary hanya mengupload metadata dan screenshot, melewatkan upload file biner — ini nyaman untuk pembaruan cepat bidang ASO tanpa rilis baru.

# Rilis lengkap dengan upload file biner
fastlane deliver --force --ipa "build/App.ipa"

# Upload hanya metadata tanpa file biner
fastlane deliver --force --skip_binary

# Pembaruan hanya screenshot
fastlane deliver --force --skip_metadata

Parameter --skip_metadata hanya mengupload screenshot dan file biner, mempertahankan metadata yang ada tanpa perubahan. Ini berguna untuk rilis hotfix, ketika perlu merilis perbaikan cepat tanpa mengubah deskripsi dan bidang ASO. Kombinasi flag memungkinkan pengelolaan fleksibel setiap tahap publikasi secara terpisah.

Integrasi Deliver dalam pipeline rilis

Pipeline rilis dengan Deliver — adalah proses CI/CD lengkap untuk iOS yang mengotomatiskan semua tahap dari commit hingga publikasi di App Store. Pipeline tipikal meliputi: Match untuk sertifikat, Gym untuk build IPA, Snapshot untuk screenshot, dan Deliver untuk mengupload semua data ke App Store dengan pengiriman selanjutnya ke moderasi.

Fitur utama Deliver dalam pipeline — dukungan untuk metadata.json, yang menyimpan metadata dalam format JSON terstruktur. Ini memungkinkan pembuatan metadata secara terprogram dari sistem CMS eksternal atau pembuatan deskripsi otomatis dalam beberapa bahasa melalui API terjemahan.

# Pipeline rilis di 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

Sebelum memanggil Deliver dalam pipeline, pastikan semua metadata terkini: deskripsi sesuai dengan versi baru, screenshot diperbarui untuk fitur baru, dan grup harga tidak memerlukan perubahan. Submit for review mengirim aplikasi ke moderasi Apple, yang memakan waktu 24 hingga 48 jam untuk aplikasi baru dan 2 hingga 12 jam untuk pembaruan.

Deliver mendukung mekanisme app_version, yang memungkinkan Anda menentukan versi target untuk pembaruan metadata. Jika versi tidak ditentukan, Deliver memperbarui versi aktif aplikasi saat ini di App Store Connect. Untuk merilis versi baru, Anda harus terlebih dahulu membuat versi yang sesuai melalui antarmuka App Store Connect atau API.

Kesalahan umum saat bekerja dengan Deliver

Saat menggunakan Deliver, pengembang sering menghadapi kesalahan validasi metadata, struktur file screenshot yang salah, dan masalah autentikasi. Diagnosis kesalahan Deliver dimulai dengan analisis log perintah — Deliver menampilkan informasi terperinci tentang setiap tahap upload dan alasan penolakan.

Kesalahan „Invalid screenshot path„ terjadi ketika struktur folder dengan screenshot tidak sesuai dengan format yang diharapkan. Solusi: periksa nama file screenshot untuk kesesuaian dengan pola DeviceType_ScreenSize_Number.png (misalnya AppleiPhone15ProMax_6.7_01.png). Deliver sensitif terhadap huruf kapital dan pemisah dalam nama file.

Kesalahan „Metadata validation failed„ menunjukkan ketidaksesuaian metadata dengan persyaratan App Store. Solusi: periksa panjang deskripsi (hingga 4000 karakter), kata kunci (hingga 100 karakter), dan nama (hingga 30 karakter). App Store Review Guidelines berisi persyaratan lengkap untuk setiap bidang metadata — disarankan untuk memeriksanya sebelum setiap rilis.

Pada kesalahan „Apple ID not found„ aplikasi tidak ada di App Store Connect dengan apple_identifier yang ditentukan. Solusi: buat catatan aplikasi di App Store Connect melalui antarmuka web sebelum panggilan Deliver pertama, tentukan Bundle Identifier dan nama. Deliver tidak membuat aplikasi baru — ia hanya memperbarui catatan yang ada di toko.