Pilot (Fastlane): asosiy tushunchalar, TestFlight va mobil loyihalar uchun buildlarni boshqarish

Pilot (Fastlane) nima?

Pilot (Fastlane) — bu mobi ilovalarni beta test qilish uchun Apple platformasi bo'lgan TestFlight bilan ishlashni avtomatlashtirish uchun Fastlane ekotizimining komponenti. Pilot barcha muntazam operatsiyalarni o'z zimmasiga oladi: buildlarni yuklash, testerlarni qo'shish, guruhlarni boshqarish va build statusini kuzatish.

Pilot-siz beta versiyasini tarqatish jarayoni quyidagicha ko'rinadi: dasturchi qo'lda App Store Connect-ni ochadi, ilovani tanlaydi, IPA-ni Xcode Organizer orqali yuklaydi, tester guruhini sozlaydi va taklifnomalarni yuboradi. TestFlight — bu Apple-ning ilovalarning beta versiyalarini App Store-da rasmiy chiqarilishidan oldin testerlar orasida tarqatish xizmati.

App Store Connect Help (2025) ma'lumotlariga ko'ra, tashqi testerlar buildni birinchi o'rnatishdan oldin Beta App Review jarayonidan o'tishlari kerak — bu 1 soatdan 48 soatgacha davom etadi. Pilot avtomatik ravishda ko'rib chiqish statusini kuzatadi va build tashqi tester guruhlari orasida tarqatishga tayyor bo'lganida jamoani xabardor qiladi.

Pilot-ni testerlarga muntazam beta buildlarni yetkazish talab qilinadigan har qanday loyihada foydalaning — bu iOS ilovalari uchun CI/CD pipeline-larida bashorat qilinadigan yetkazish jarayonini ta'minlaydigan standart vositadir.

Pilot-ning TestFlight uchun asosiy funksiyalari

Pilot funksionalligi beta buildlarni boshqarishning to'liq hayotiy siklini qamrab oladi: binar faylni yuklashdan testerlarga yangi versiya haqida xabar berishgacha. Har bir funksiya alohida buyruq sifatida bashorat qilinadigan xatti-harakat va har bir qadamning batafsil loglanishi bilan amalga oshirilgan.

Buildlarni TestFlight-ga yuklash

fastlane pilot upload buyrug'i IPA faylini App Store Connect-ga yuklaydi va TestFlight-da yangi build yaratadi. Pilot avtomatik ravishda binar faylning to'g'riligini, versiya va ilova identifikatorining mosligini tekshiradi. App Store Connect — bu Apple-ning ilovalarni boshqarish platformasi, buildlarni yuklash, metadata, analitika va savdo hisobotlarini o'z ichiga oladi.

Yuklashdan so'ng Pilot Apple tomonidan binar faylni qayta ishlashni kutadi — jarayon build hajmiga qarab 5 daqiqadan 30 daqiqagacha davom etadi. Kutish vaqtida Pilot qayta ishlashning joriy statusi haqida ma'lumot bilan progress bar-ni ko'rsatadi: Processing, Validating yoki Ready. Muvaffaqiyatli qayta ishlashdan so'ng build tester guruhlariga tayinlash uchun mavjud bo'ladi.

Tester guruhlarini boshqarish

Pilot ham ichki, ham tashqi tester guruhlarini boshqarishni qo'llab-quvvatlaydi. Ichki testerlar — bu sizning Apple Developer jamoangiz a'zolari bo'lib, ular Beta App Review-dan o'tmasdan buildlarga darhol kirishadi. Tashqi testerlar — bu elektron pochta orqali taklif qilingan foydalanuvchilar bo'lib, birinchi o'rnatishdan oldin ko'rib chiqishni tasdiqlash talab qilinadi.

fastlane pilot add buyrug'i elektron pochta yoki Apple ID orqali guruhga yangi testerlarni qo'shadi. Pilot avtomatik ravishda taklifnomalarni yuboradi va tester taklifni qabul qilganligini tekshiradi. Ommaviy qo'shish uchun --testers_file_path parametri orqali fayldan elektron pochta ro'yxatini uzatish mumkin, bu yuzlab ishtirokchilardan iborat tester guruhini dastlabki yig'ishda qulaydir.

# Yangi buildni TestFlight-ga yuklash
fastlane pilot upload --ipa "build/MyApp.ipa"

# Testerni guruhga qo'shish
fastlane pilot add --email "tester@company.com" \
      --groups "QA Team"

Pilot-ni sozlash va konfiguratsiyasi

Pilot konfiguratsiyasi alohida konfiguratsiya faylini talab qilmaydi — sozlamalar Appfile (umumiy Fastlane fayli) yoki buyruq qatori argumentlari orqali uzatiladi. Asosiy parametrlarga ilovaning apple_id-si, app_identifier, team_id va App Store Connect API-ga kirish uchun autentifikatsiya ma'lumotlari kiradi.

Autentifikatsiya uchun Pilot App Store Connect API Key (tavsiya etilgan usul) yoki Apple ID ikki faktorli autentifikatsiyasidan foydalanadi. App Store Connect API Key — bu App Store Connect-da yaratiladigan kirish kaliti bo'lib, parol va tasdiqlash kodini interaktiv kiritmasdan API bilan o'zaro aloqada bo'lish imkonini beradi.

# Appfile — Fastlane umumiy konfiguratsiyasi
app_identifier("com.company.app")
apple_id("developer@company.com")
team_id("TEAM123456")

# Pilot uchun muhit o'zgaruvchilari
# APP_STORE_CONNECT_API_KEY_PATH=/path/to/key.p8

app_identifier parametri ilovaning Bundle Identifier-ni aniqlaydi, u Xcode loyihasida va App Store Connect-da ko'rsatilgan identifikator bilan mos kelishi kerak. apple_id parametri ikki faktorli sxemada autentifikatsiya uchun, team_id esa hisob bir nechta Apple Developer jamoalariga bog'langan bo'lsa, ishlab chiqish jamoasini tanlash uchun ishlatiladi.

Pilot ishlashi uchun CI/CD muhitida App Store Connect API Key-ni sozlash kerak. Kalit App Store Connect → Users and Access → Keys → Generate API Key da yaratiladi. .p8 faylini CI tizimining sirlarida saqlang va unga yo'lni APP_STORE_CONNECT_API_KEY_PATH muhit o'zgaruvchisi yoki Pilot buyruqlarida --api_key_path parametri orqali ko'rsating.

Buildlarni boshqarish uchun Pilot buyruqlari

Pilot buyruqlar to'plami TestFlight bilan ishlashning barcha stsenariylarini qamrab oladi: buildlarni yuklash, testerlarni boshqarish, statuslarni ko'rish va metadatani kuzatish. Har bir buyruq CI/CD skriptlarida keyingi qayta ishlash uchun tuzilgan JSON natijani qaytaradi.

Build statuslarini ko'rish

fastlane pilot builds buyrug'i ilovaning barcha buildlari ro'yxatini versiya, qayta ishlash statusi va yuklash sanasi bilan ko'rsatadi. Build statusi quyidagilardan biri bo'lishi mumkin: Processing — Apple binar faylni qayta ishlaydi, Ready — build tarqatish uchun mavjud, Rejected — build tekshirish xatolari tufayli rad etilgan.

# TestFlight-da barcha buildlar ro'yxatini ko'rish
fastlane pilot builds

# Buildni tester guruhiga tayinlash
fastlane pilot distribute --build_number 42 \
      --groups "QA Team" --notify

# Muayyan build haqida ma'lumotni ko'rish
fastlane pilot build_info --build_number 42

fastlane pilot distribute buyrug'i buildni belgilangan tester guruhlariga tayinlaydi va bildirishnomalarni yuboradi. --notify parametri testerlarga yangi mavjud build haqida elektron pochta bildirishnomalarini yuborishni yoqadi — bu beta-testchilarni test jarayoniga jalb qilish va fikr-mulohazalarni tezlashtirish uchun juda muhimdir.

Build metadatani boshqarish uchun --changelog parametri ishlatiladi, u yangi versiyadagi o'zgarishlar tavsifi matnini belgilaydi. Bu matn testerlarga TestFlight ilovasida test taklifnomasida ko'rsatiladi. Har bir buildda asosiy o'zgarishlarni, tuzatilgan xatolarni va yangi funksiyalarni ko'rsatish tavsiya etiladi.

Pilot-ni CI/CD pipeline-ga integratsiyasi

Pilot CI/CD da — iOS ilovasini yetkazish pipeline-ning yakuniy bosqichidir. Gym IPA-ni qurgan va testlar o'tgandan so'ng, Pilot buildni TestFlight-ga yuklaydi va tester guruhlari orasida taqsimlaydi. Bu QA jamoalariga repozitoriyaga commitdan bir necha daqiqa o'tgach ilovaning yangi versiyasini olish imkonini beradi.

Oddiy iOS CI/CD pipeline ketma-ketlikni o'z ichiga oladi: Match (sertifikatlar), Gym (IPA qurish), Pilot (TestFlight-ga yuklash va tarqatish). Har bir bosqich oldingisiga bog'liq bo'lib, bu testerlarga faqat haqiqiy va imzolangan buildlarni yetkazishni kafolatlaydi.

# Fastfile-da to'liq 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 buyrug'ida CI vazifasi doirasida Apple tomonidan binar faylni qayta ishlash tugashini kutmaslik imkonini beradi — Pilot yuklash so'rovini yuboradi, build identifikatorini oladi va ishini tugatadi. Bu pipeline-ni tezlashtiradi, chunki qayta ishlash 30 daqiqagacha davom etishi mumkin va bu vaqt CI runner-da kutishga sarflanmaydi.

CI-da Pilot to'g'ri ishlashi uchun App Store Connect API kalitini sozlash kerak. .p8 kalit faylini CI tizimining xavfsiz omborida saqlang va yo'lni APP_STORE_CONNECT_API_KEY_PATH muhit o'zgaruvchisi orqali uzating. Pilot bu kalitdan API-da ikki faktorli autentifikatsiyasiz autentifikatsiya qilish uchun foydalanadi, bu avtomatik stsenariylar uchun juda muhimdir.

Pilot bilan ishlashda odatiy muammolar

Pilot-dan foydalanganda dasturchilar eng ko'p autentifikatsiya xatolari, ilovaning noto'g'ri konfiguratsiyasi va Apple tomonidan binar fayllarni qayta ishlash bilan bog'liq muammolarga duch kelishadi. Muammolarni diagnostikasi Pilot pilot builds buyrug'i orqali App Store Connect-da build statusini tekshirish bilan boshlanadi.

«Your app is not available for testing in TestFlight» xatosi ilova App Store Connect-da test uchun sozlanmaganida yuzaga keladi. Yechim: App Store Connect-da TestFlight bo'limini oching, ilova uchun testni faollashtiring va Export Compliance shifrlash turi uchun to'g'ri to'ldirilganligiga ishonch hosil qiling.

«Missing iOS Distribution signing identity» xatosi Keychain-da Distribution sertifikati yo'qligini ko'rsatadi. Yechim: Pilot-ni chaqirishdan oldin to'g'ri sertifikatni yuklash uchun Match-ni ishga tushiring. Distribution sertifikati Development-dan farq qiladi — u TestFlight yoki App Store orqali tarqatish uchun mo'ljallangan buildlarni imzolash uchun ishlatiladi.

«Invalid Provisioning Profile» xatosi build tanlangan eksport usuli uchun noto'g'ri profilni o'z ichiga oladi. Yechim: Gym Match-dagi profil turiga mos keladigan to'g'ri export_method dan foydalanayotganligini tekshiring. Agar build ishlab chiqish profili bilan qurilgan bo'lsa, Pilot uni TestFlight-ga yuklay olmaydi — app-store yoki ad-hoc profili talab qilinadi.