Pilot (Fastlane): əsas anlayışlar, TestFlight və mobil layihələr üçün build idarəetməsi

Pilot (Fastlane) nədir?

Pilot (Fastlane) — mobil tətbiqlərin beta testi üçün Apple platforması olan TestFlight ilə işi avtomatlaşdırmaq üçün Fastlane ekosisteminin komponentidir. Pilot bütün rutin əməliyyatları öz üzərinə götürür: buildlərin yüklənməsi, testerlərin əlavə edilməsi, qrupların idarə edilməsi və build statusunun izlənməsi.

Pilot olmadan beta versiyasının yayılması prosesi belə görünür: proqramçı əl ilə App Store Connect-i açır, tətbiqi seçir, IPA-nı Xcode Organizer vasitəsilə yükləyir, tester qrupunu konfiqurasiya edir və dəvətlər göndərir. TestFlight — Apple-ın tətbiqlərin beta versiyalarını App Store-da rəsmi buraxılışdan əvvəl testerlər arasında yaymaq üçün xidmətidir.

App Store Connect Help (2025) məlumatına görə, xarici testerlər buildin ilk quraşdırılmasından əvvəl Beta App Review prosesindən keçməlidirlər — bu 1 saatdan 48 saata qədər vaxt aparır. Pilot avtomatik olaraq rəy statusunu izləyir və komandanı buildin xarici tester qrupları arasında yayılmağa hazır olması barədə xəbərdar edir.

Pilot-dan müntəzəm olaraq beta buildlərin testerlərə çatdırılması tələb olunan istənilən layihədə istifadə edin — bu, iOS tətbiqləri üçün CI/CD pipeline-larında proqnozlaşdırılan çatdırılma prosesini təmin edən standart vasitədir.

Pilot-un TestFlight üçün əsas funksiyaları

Pilot funksionallığı beta buildlərin idarə edilməsinin tam həyat dövrünü əhatə edir: binar faylın yüklənməsindən testerlərə yeni versiya barədə xəbərdarlığa qədər. Hər bir funksiya proqnozlaşdırılan davranışı və hər addımın ətraflı loglanması ilə ayrıca əmr şəklində tətbiq edilmişdir.

Buildlərin TestFlight-a yüklənməsi

fastlane pilot upload əmri IPA faylını App Store Connect-ə yükləyir və TestFlight-da yeni build yaradır. Pilot avtomatik olaraq binar faylın düzgünlüyünü, versiya və tətbiq identifikatorunun uyğunluğunu yoxlayır. App Store Connect — Apple-ın tətbiqlərin idarə edilməsi platformasıdır, buildlərin yüklənməsi, metadata, analitika və satış hesabatları daxildir.

Yükləmədən sonra Pilot Apple tərəfindən binar faylın emalını gözləyir — proses buildin ölçüsündən asılı olaraq 5 dəqiqədən 30 dəqiqəyə qədər davam edir. Gözləmə müddətində Pilot emalın cari statusu haqqında məlumat olan gedişat çubuğu göstərir: Processing, Validating və ya Ready. Uğurlu emaldan sonra build tester qruplarına təyin edilmək üçün əlçatan olur.

Tester qruplarının idarə edilməsi

Pilot həm daxili, həm də xarici tester qruplarının idarə edilməsini dəstəkləyir. Daxili testerlər — Apple Developer komandanızın üzvləridir, buildlərə Beta App Review-dan keçmədən dərhal giriş əldə edirlər. Xarici testerlər — email vasitəsilə dəvət edilmiş istifadəçilərdir, ilk quraşdırmadan əvvəl rəyin təsdiqlənməsi tələb olunur.

fastlane pilot add əmri email və ya Apple ID vasitəsilə qrupa yeni testerlər əlavə edir. Pilot avtomatik olaraq dəvətlər göndərir və testerin dəvəti qəbul edib-etmədiyini yoxlayır. Kütləvi əlavə etmək üçün --testers_file_path parametri vasitəsilə fayldan email siyahısını ötürmək olar ki, bu da yüzlərlə iştirakçıdan ibarət tester qrupunun ilkin toplanması zamanı əlverişlidir.

# Yeni buildin TestFlight-a yüklənməsi
fastlane pilot upload --ipa "build/MyApp.ipa"

# Testerin qrupa əlavə edilməsi
fastlane pilot add --email "tester@company.com" \
      --groups "QA Team"

Pilot-un quraşdırılması və konfiqurasiyası

Pilot konfiqurasiyası ayrıca konfiqurasiya faylı tələb etmir — parametrlər Appfile (ümumi Fastlane faylı) və ya əmr sətri arqumentləri vasitəsilə ötürülür. Əsas parametrlərə tətbiqin apple_id-si, app_identifier, team_id və App Store Connect API-yə giriş üçün etimadnamə məlumatları daxildir.

Doğrulama üçün Pilot App Store Connect API Key (tövsiyə olunan üsul) və ya Apple ID iki faktorlu doğrulamadan istifadə edir. App Store Connect API Key — App Store Connect-də yaradılan giriş açarıdır, şifrə və təsdiq kodu daxil etmədən API ilə qarşılıqlı əlaqəyə imkan verir.

# Appfile — Fastlane ümumi konfiqurasiyası
app_identifier("com.company.app")
apple_id("developer@company.com")
team_id("TEAM123456")

# Pilot üçün mühit dəyişənləri
# APP_STORE_CONNECT_API_KEY_PATH=/path/to/key.p8

app_identifier parametri tətbiqin Bundle Identifier-nı müəyyən edir, Xcode layihəsində və App Store Connect-də göstərilən identifikatorla uyğun olmalıdır. apple_id parametri iki faktorlu sxemdə doğrulama üçün, team_id isə hesab bir neçə Apple Developer komandasına bağlı olduqda inkişaf komandasının seçilməsi üçün istifadə olunur.

Pilot-un işləməsi üçün CI/CD mühitində App Store Connect API Key konfiqurasiya edilməlidir. Açar App Store Connect → Users and Access → Keys → Generate API Key bölməsində yaradılır. .p8 faylını CI sisteminin sirlərində saxlayın və ona olan yolu APP_STORE_CONNECT_API_KEY_PATH mühit dəyişəni və ya Pilot əmrlərində --api_key_path parametri vasitəsilə göstərin.

Build idarəetməsi üçün Pilot əmrləri

Pilot əmr dəsti TestFlight ilə işin bütün ssenarilərini əhatə edir: buildlərin yüklənməsi, testerlərin idarə edilməsi, statuslara baxmaq və metadataya nəzarət. Hər bir əmr CI/CD skriptlərində sonrakı emal üçün strukturlaşdırılmış JSON nəticəsi qaytarır.

Build statuslarına baxış

fastlane pilot builds əmri tətbiqin bütün buildlərinin siyahısını versiya, emal statusu və yükləmə tarixi ilə göstərir. Build statusu aşağıdakılardan biri ola bilər: Processing — Apple binar faylı emal edir, Ready — build yayılma üçün əlçatandır, Rejected — build doğrulama səhvləri səbəbindən rədd edilmişdir.

# TestFlight-da bütün buildlərin siyahısına baxış
fastlane pilot builds

# Buildin tester qrupuna təyin edilməsi
fastlane pilot distribute --build_number 42 \
      --groups "QA Team" --notify

# Konkret build haqqında məlumat
fastlane pilot build_info --build_number 42

fastlane pilot distribute əmri buildi göstərilən tester qruplarına təyin edir və bildirişlər göndərir. --notify parametri testerlərə yeni əlçatan build haqqında email bildirişlərinin göndərilməsini aktivləşdirir — bu, beta testçilərin test prosesinə cəlb edilməsi və əks əlaqənin sürətləndirilməsi üçün vacibdir.

Build metadata idarə edilməsi üçün --changelog parametri istifadə olunur, yeni versiyadakı dəyişikliklərin təsvir mətnini təyin edir. Bu mətn testerlərə TestFlight tətbiqində test dəvətində göstərilir. Hər builddə əsas dəyişiklikləri, düzəldilmiş səhvləri və yeni funksiyaları göstərmək tövsiyə olunur.

Pilot-un CI/CD pipeline-na inteqrasiyası

Pilot CI/CD-də — iOS tətbiqinin çatdırılma pipeline-nın son mərhələsidir. Gym IPA-nı qurduqdan və testlər keçdikdən sonra Pilot buildi TestFlight-a yükləyir və tester qruplarına paylayır. Bu, QA komandalarına repozitoriyaya committən bir neçə dəqiqə sonra tətbiqin yeni versiyasını əldə etməyə imkan verir.

Tipik iOS CI/CD pipeline ardıcıllığı daxildir: Match (sertifikatlar), Gym (IPA qurulması), Pilot (TestFlight-a yükləmə və paylama). Hər bir mərhələ əvvəlkindən asılıdır ki, bu da testerlərə yalnız etibarlı və imzalanmış buildlərin çatdırılmasını təmin edir.

# Fastfile-da tam pipeline
lane :beta do
    match(type: :appstore)
    gym(scheme: "MyApp", export_method: "app-store")
    pilot("build/MyApp.ipa", groups: ["QA", "PM"])
end

skip_waiting parametri upload əmrində CI tapşırığı çərçivəsində Apple tərəfindən binar faylın emalının tamamlanmasını gözləməməyə imkan verir — Pilot yükləmə sorğusu göndərir, build identifikatorunu alır və işini bitirir. Bu, pipeline-ı sürətləndirir, çünki emal 30 dəqiqəyə qədər davam edə bilər və bu vaxt CI runner-də gözləməyə sərf edilmir.

CI-da Pilot-un düzgün işləməsi üçün App Store Connect API açarını konfiqurasiya etmək lazımdır. .p8 açar faylını CI sisteminin təhlükəsiz anbarında saxlayın və yolu APP_STORE_CONNECT_API_KEY_PATH mühit dəyişəni vasitəsilə ötürün. Pilot bu açardan interaktiv daxiletmə olmadan API-də doğrulama üçün istifadə edir ki, bu da avtomatik ssenarilər üçün vacibdir.

Pilot ilə işləyərkən tipik problemlər

Pilot istifadə edərkən proqramçılar ən çox doğrulama səhvləri, tətbiqin səhv konfiqurasiyası və Apple tərəfindən binar faylların emalı ilə bağlı problemlərlə qarşılaşırlar. Problemlərin diaqnostikası Pilot pilot builds əmri vasitəsilə App Store Connect-də build statusunun yoxlanılması ilə başlayır.

«Your app is not available for testing in TestFlight» səhvi, tətbiq App Store Connect-də test üçün konfiqurasiya edilmədikdə baş verir. Həll yolu: App Store Connect-də TestFlight bölməsini açın, tətbiq üçün testi aktivləşdirin və Export Compliance-ın şifrələmə növünüz üçün düzgün doldurulduğuna əmin olun.

«Missing iOS Distribution signing identity» səhvi Keychain-də Distribution sertifikatının olmamasını göstərir. Həll yolu: Pilot-u çağırmazdan əvvəl düzgün sertifikatı yükləmək üçün Match-i işə salın. Distribution sertifikatı Development-dan fərqlənir — TestFlight və ya App Store vasitəsilə yayılmaq üçün nəzərdə tutulmuş buildləri imzalamaq üçün istifadə olunur.

«Invalid Provisioning Profile» səhvi zamanı build seçilmiş ixrac metodu üçün yanlış profil ehtiva edir. Həll yolu: Gym-in Match-dəki profil növünə uyğun düzgün export_method istifadə etdiyini yoxlayın. Əgər build development profili ilə yığılıbsa, Pilot onu TestFlight-a yükləyə bilməyəcək — app-store və ya ad-hoc profili tələb olunur.