Deliver (Fastlane) — nədir, App Store-a yükləmə və iOS və Android inkişafında konfiqurasiya

Deliver (Fastlane) nədir?

Deliver (Fastlane) — bu, mobil proqramların App Store-da nəşr prosesini avtomatlaşdıran Fastlane ekosisteminin komponentidir. O, ikili faylların yüklənməsini, metadatanın (ad, təsvir, açar sözlər) yenilənməsini, ekran görüntülərinin yüklənməsini və bütün lokallaşdırma dilləri üçün qiymətlərin qurulmasını idarə edir.

Deliver olmadan hər buraxılış App Store Connect veb-interfeysi vasitəsilə məlumatların əl ilə yenilənməsini tələb edir: bir neçə dildə təsvirin doldurulması, hər ekran ölçüsü üçün ekran görüntülərinin yüklənməsi, açar sözlərin yenilənməsi və qiymətlərin qurulması. App Store-da nəşr — iOS proqramının həyat dövrünün ikili faylın yoxlanılması, məzmunun moderasiyası və proqramın istehsalata buraxılmasını əhatə edən son mərhələsidir.

App Store Connect Documentation (2025) məlumatına görə, müntəzəm yeniləmələri olan proqramlar 30% daha çox təkrar quraşdırma alır və axtarışda daha yaxşı sıralanır. Deliver komandalara həftəlik yeniləmələr buraxmağa imkan verir, nəşrin adi addımlarını avtomatlaşdırır və onlarla dildə metadatanın doldurulmasında insan səhvi riskini azaldır.

Deliver-i App Store-da nəşr olunan hər hansı proqram üçün istifadə edin — bu, xüsusilə çoxdilli lokallaşdırması olan layihələr üçün dəyərlidir, burada 32 dilin əl ilə yenilənməsi bir neçə saat çəkir.

Deliver App Store Connect ilə necə işləyir

Deliver-in iş mexanizmi iki mərhələli prosesə əsaslanır. Birinci mərhələdə vasitə metadatanı hazırlayır — Deliverfile strukturunu yoxlayır, ekran görüntülərini yükləyir və dəyişiklik manifestini yaradır. İkinci mərhələdə Deliver məlumatları App Store Connect API-ə göndərir, ikili faylı yükləyir və Apple tərəfindən kompilasiyanın yoxlanılması prosesini işə salır.

Deliver bütün əməliyyatlar üçün App Store Connect API-dən istifadə edir ki, bu da Apple-ın yeni tələbləri ilə uyğunluğu təmin edir və özəl interfeyslərin istifadəsini istisna edir. App Store Connect API — bu, proqramlarla əməliyyatların avtomatlaşdırılması, o cümlədən kompilasiyaların yüklənməsi, metadatanın idarə edilməsi və rəy statusunun izlənməsi üçün Apple-ın rəsmi REST API-dir.

İkili faylların yüklənməsi

Deliver Fastlane vasitəsilə birbaşa Gym ilə inteqrasiya olunur: IPA kompilasiyasından sonra Deliver onu App Store Connect-ə yükləyir və emal prosesini işə salır. --ipa parametri ikili fayla yolu göstərir. Parametr göstərilməyibsə, Deliver avtomatik olaraq Gymfile-də göstərilən və ya Fastlane-in əvvəlki addımları ilə ötürülən kompilasiya qovluğunda son IPA-nı tapır.

Yükləmədən sonra Deliver Apple tərəfindən ikili faylın emalının bitməsini gözləyir — Pilot kimi, status gedişat çubuğu vasitəsilə izlənilir. Mövcud statuslar: Processing, Waiting For Review, In Review, Ready For Sale və ya Rejected. Deliver Fastfile-dəki callback-lər vasitəsilə komandaya hər status dəyişikliyi barədə məlumat verir.

Proqram metadatasının idarə edilməsi

Deliver proqramın tam metadata dəstini idarə edir: ad, təsvir (qısa və tam), açar sözlər, dəstək və marketinq URL-i, kateqoriya və yaş reytinqi. Proqram metadatası — bu, App Store səhifəsində göstərilən və axtarış indeksasiyası və ASO optimallaşdırılması üçün istifadə olunan proqram haqqında mətn məlumatıdır.

--submit_for_review parametri metadatanın yüklənməsindən dərhal sonra proqramı moderasiyaya göndərir. Bu, tam avtomatlaşdırılmış buraxılış üçün əsas parametrdir. Onsuz Deliver yalnız məlumatları yükləyir, lakin proqramı rəyə göndərmir — bu, faktiki təqdimatdan əvvəl bütün sahələrin ilkin yoxlanılması üçün faydalıdır.

Ekran görüntüləri ilə iş

Deliver göstərilən qovluqdan bütün cihaz və dil kombinasiyaları üçün ekran görüntülərini avtomatik yükləyir. Fayl adları nümunəyə uyğun olmalıdır: birinci slotda 6.5 düym diaqonallı iPhone üçün iPhone_6.5_01.png. Deliver özü ekran görüntüsünün ölçüsünü müəyyən edir və onu Apple-ın hər cihaz növü üçün tələbləri ilə uyğunlaşdırır.

Ekran görüntüləri düzgün qaydada və hər lokallaşdırma dili üçün ayrıca yüklənir. Dil üçün ekran görüntüləri tapılmazsa, Deliver ehtiyat variant kimi ingilis versiyalarından istifadə edir. Ekran görüntülərinin lokallaşdırılması — müxtəlif ölkələrin App Store-da yaxşı sıralanmaq istəyən proqramlar üçün məcburi tələbdir, çünki Apple axtarış nəticələrində yerli məzmunu nəzərə alır.

# App Store-a yükləmək üçün əsas əmr
fastlane deliver

# Metadata və ekran görüntülərinin göstərilməsi ilə yükləmə
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Yükləmədən öncədən baxış
fastlane deliver --preview

Deliver-in Deliverfile vasitəsilə konfiqurasiyası

Deliverfile — bu, proqramın metadatasını strukturlaşdırılmış Ruby formatında saxlamaq üçün Fastlane konfiqurasiya faylıdır. App Store Connect-də formaların əl ilə doldurulmasından fərqli olaraq, Deliverfile metadatanı Git-də versiyalamağa və nəşrdən əvvəl code review vasitəsilə dəyişiklikləri yoxlamağa imkan verir.

# Deliverfile — proqram metadatası
app_identifier("com.company.app")
title("MyApp")
description("Mağaza üçün proqram təsviri")
keywords("mobil, proqram, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Metadata lokallaşdırma dilləri
languages(["en-US", "ru", "de"])

languages parametri metadatanın hansı dillər üçün yüklənəcəyini müəyyən edir. Hər dil üçün fastlane/metadata qovluğunda təsvir, açar sözlər və marketinq mətnlərinin müvafiq faylları ilə ayrıca qovluq yaradılmalıdır. Deliver eyni anda 32 App Store dilini dəstəkləyir.

Ekran görüntülərini yükləmək üçün Fastlane qovluğu daxilində screenshots qovluğu istifadə olunur. Qovluq strukturu: screenshots/[Dil]/[CihazNövü]_[EkranÖlçüsü]_[Nömrə].png. Deliver göstərilən dillər və cihazlar üçün ekran görüntülərini avtomatik yükləyir, ölçüləri Apple-ın tələbləri ilə uyğunlaşdırır. Ekran görüntülərini yaratmaq üçün Snapshot-dan istifadə etmək tövsiyə olunur — onların çıxış formatı Deliver ilə uyğundur.

Qiymət qrupu 0-dan 87-yə qədər qiymət səviyyəsinin nömrəsini qəbul edən price_tier parametri vasitəsilə konfiqurasiya edilir. Apple-ın qiymət qrupları avtomatik olaraq bütün mövcud ölkələrin valyutalarına çevrilir. Deliver buraxılış çərçivəsində qiyməti dəyişməyə imkan verir ki, bu da müvəqqəti promosiyalar və ya proqramın biznes modelinin dəyişdirilməsi üçün faydalıdır.

Proqramların nəşri üçün Deliver əmrləri

Deliver interfeysi metadata, ikili fayllar, ekran görüntüləri və tam buraxılışın yüklənməsi üçün əmrləri əhatə edir. Parametrsiz fastlane deliver əsas əmri tam nəşr dövrü üçün Deliverfile və metadata qovluğundan məlumatları istifadə edir.

fastlane deliver --preview əmri App Store Connect-ə faktiki yükləmədən metadatanın ilkin yoxlanılmasını işə salır. Yükləmə üçün --force tələb olunur — onsuz Deliver öncədən baxış rejimində işləyir. --skip_binary parametri yalnız metadata və ekran görüntülərini yükləyir, ikili faylın yüklənməsini atlayır — bu, yeni buraxılış olmadan ASO sahələrinin sürətli yenilənməsi üçün əlverişlidir.

# İkili faylın yüklənməsi ilə tam buraxılış
fastlane deliver --force --ipa "build/App.ipa"

# İkili fayl olmadan yalnız metadatanın yüklənməsi
fastlane deliver --force --skip_binary

# Yalnız ekran görüntülərinin yenilənməsi
fastlane deliver --force --skip_metadata

--skip_metadata parametri yalnız ekran görüntülərini və ikili faylı yükləyir, mövcud metadatanı dəyişmədən saxlayır. Bu, təsvir və ASO sahələrini dəyişdirmədən tez bir düzəliş buraxmaq lazım olduqda hotfix buraxılışları üçün faydalıdır. Bayraqların kombinasiyası nəşrin hər mərhələsini ayrıca çevik idarə etməyə imkan verir.

Deliver-in buraxılış axınına inteqrasiyası

Buraxılış axını Deliver ilə — bu, committən App Store-da nəşrə qədər bütün mərhələləri avtomatlaşdıran iOS üçün tam CI/CD prosesidir. Tipik axına daxildir: sertifikatlar üçün Match, IPA kompilasiyası üçün Gym, ekran görüntüləri üçün Snapshot və bütün məlumatların App Store-a yüklənməsi və sonra moderasiyaya göndərilməsi üçün Deliver.

Deliver-in axında əsas xüsusiyyəti metadatanı strukturlaşdırılmış JSON formatında saxlayan metadata.json dəstəyidir. Bu, metadatanı xarici CMS sistemlərindən proqramlı şəkildə yaratmağa və ya tərcümə API-si vasitəsilə bir neçə dildə avtomatik təsvir yaratmağa imkan verir.

# Fastfile-də buraxılış axını
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

Axında Deliver-i çağırmazdan əvvəl bütün metadatanın aktual olduğundan əmin olun: təsvir yeni versiyaya uyğundur, ekran görüntüləri yeni funksiyalar üçün yenilənib, qiymət qrupu dəyişiklik tələb etmir. Submit for review proqramı Apple moderasiyasına göndərir, bu da yeni proqramlar üçün 24 saatdan 48 saata qədər, yeniləmələr üçün isə 2 saatdan 12 saata qədər davam edir.

Deliver metadatanın yenilənməsi üçün hədəf versiyanı göstərməyə imkan verən app_version mexanizmini dəstəkləyir. Versiya göstərilməyibsə, Deliver App Store Connect-də cari aktiv proqram versiyasını yeniləyir. Yeni versiyanı buraxmaq üçün əvvəlcədən App Store Connect interfeysi və ya API vasitəsilə müvafiq versiya yaradılmalıdır.

Deliver ilə işləyərkən tipik səhvlər

Deliver istifadə edərkən tərtibatçılar tez-tez metadata yoxlanılması səhvləri, ekran görüntüsü fayllarının səhv strukturu və autentifikasiya problemləri ilə qarşılaşırlar. Səhv diaqnostikası Deliver əmrinin jurnallarının təhlili ilə başlayır — Deliver yükləmənin hər mərhələsi və rədd edilmə səbəbləri haqqında ətraflı məlumat göstərir.

„Invalid screenshot path„ səhvi ekran görüntüləri olan qovluqların strukturu gözlənilən formata uyğun gəlmədikdə yaranır. Həll yolu: ekran görüntüsü fayl adlarının DeviceType_ScreenSize_Number.png nümunəsinə uyğunluğunu yoxlayın (məsələn AppleiPhone15ProMax_6.7_01.png). Deliver fayl adlarında böyük/kiçik hərf və ayırıcılara həssasdır.

„Metadata validation failed„ səhvi metadatanın App Store tələblərinə uyğunsuzluğunu göstərir. Həll yolu: təsvirin uzunluğunu (4000 simvola qədər), açar sözləri (100 simvola qədər) və adı (30 simvola qədər) yoxlayın. App Store Review Guidelines metadata sahələrinin hər biri üçün tam tələbləri ehtiva edir — hər buraxılışdan əvvəl onları yoxlamaq tövsiyə olunur.

„Apple ID not found„ səhvi zamanı proqram göstərilən apple_identifier ilə App Store Connect-də mövcud deyil. Həll yolu: Deliver-ə ilk zəngdən əvvəl veb-interfeys vasitəsilə App Store Connect-də proqram qeydini yaradın, Bundle Identifier və adı göstərin. Deliver yeni proqramlar yaratmır — o, yalnız mağazada mövcud qeydləri yeniləyir.