Pilot (Fastlane): кључни појмови, TestFlight и управљање билдовима за мобилне пројекте

Шта је Pilot (Fastlane)?

Pilot (Fastlane) — је компонента Fastlane екосистема за аутоматизацију рада са TestFlight-ом — Apple платформом за бета тестирање мобилних апликација. Pilot преузима све рутинске операције: отпремање билдова, додавање тестера, управљање групама и праћење статуса билдова.

Без Pilot-а, процес дистрибуције бета верзије изгледа овако: програмер ручно отвара App Store Connect, бира апликацију, отпрема IPA преко Xcode Organizer-а, подешава групу тестера и шаље позивнице. TestFlight — је Apple сервис за дистрибуцију бета верзија апликација међу тестерима пре званичног објављивања у App Store-у.

Према App Store Connect Help (2025), екстерни тестери морају да прођу процес Beta App Review пре прве инсталације билда — ово траје од 1 до 48 сати. Pilot аутоматски прати статус ревизије и обавештава тим о спремности билда за дистрибуцију међу екстерним групама тестера.

Користите Pilot у било ком пројекту где је потребна редовна испорука бета билдова тестерима — то је стандардни алат за CI/CD пајплајнове iOS апликација који обезбеђује предвидљив процес испоруке.

Основне функције Pilot-а за TestFlight

Функционалност Pilot-а покрива комплетан животни циклус управљања бета билдовима: од отпремања бинарне датотеке до обавештавања тестера о новој верзији. Свака функција је имплементирана као посебна команда са предвидљивим понашањем и детаљним логовањем сваког корака.

Отпремање билдова у TestFlight

Команда fastlane pilot upload отпрема IPA датотеку у App Store Connect и креира нови билд у TestFlight-у. Pilot аутоматски проверава валидност бинарне датотеке, усклађеност верзије и идентификатора апликације. App Store Connect — је Apple платформа за управљање апликацијама, укључујући отпремање билдова, метаподатке, аналитику и извештаје о продаји.

Након отпремања, Pilot чека обраду бинарне датотеке од стране Apple-а — процес траје од 5 до 30 минута у зависности од величине билда. Током чекања, Pilot приказује траку напретка са информацијом о тренутном статусу обраде: Processing, Validating или Ready. Након успешне обраде, билд постаје доступан за додељивање групама тестера.

Управљање групама тестера

Pilot подржава управљање како интерним, тако и екстерним групама тестера. Интерни тестери — су чланови вашег Apple Developer тима који добијају приступ билдовима тренутно, без проласка кроз Beta App Review. Екстерни тестери — су корисници позвани путем е-поште којима је потребно одобрење ревизије пре прве инсталације.

Команда fastlane pilot add додаје нове тестере у групу путем е-поште или Apple ID-ја. Pilot аутоматски шаље позивнице и проверава да ли је тестер прихватио позив. За масовно додавање можете пренети листу е-пошта из датотеке преко параметра --testers_file_path, што је згодно приликом почетног прикупљања групе тестера од стотинак учесника.

# Отпремање новог билда у TestFlight
fastlane pilot upload --ipa "build/MyApp.ipa"

# Додавање тестера у групу
fastlane pilot add --email "tester@company.com" \
      --groups "QA Team"

Подешавање и конфигурација Pilot-а

Конфигурација Pilot-а не захтева посебну конфигурациону датотеку — подешавања се преносе преко Appfile-а (заједничка Fastlane датотека) или аргумената командне линије. Основни параметри укључују apple_id апликације, app_identifier, team_id и акредитиве за приступ App Store Connect API-ју.

За аутентификацију, Pilot користи App Store Connect API Key (препоручени начин) или двофакторску аутентификацију Apple ID-ја. App Store Connect API Key — је кључ приступа који се генерише у App Store Connect-у и омогућава интеракцију са API-јем без интерактивног уноса лозинке и кода за потврду.

# Appfile — општа конфигурација Fastlane-а
app_identifier("com.company.app")
apple_id("developer@company.com")
team_id("TEAM123456")

# Променљиве окружења за Pilot
# APP_STORE_CONNECT_API_KEY_PATH=/path/to/key.p8

Параметар app_identifier одређује Bundle Identifier апликације, који мора да се поклапа са идентификатором наведеним у Xcode пројекту и App Store Connect-у. Параметар apple_id се користи за аутентификацију у двофакторској шеми, а team_id — за избор развојног тима, ако је налог повезан са више Apple Developer тимова.

За рад Pilot-а потребно је подесити App Store Connect API Key у CI/CD окружењу. Кључ се генерише у App Store Connect → Users and Access → Keys → Generate API Key. Сачувајте .p8 датотеку у тајнама CI система и наведите путању до ње преко променљиве окружења APP_STORE_CONNECT_API_KEY_PATH или параметра --api_key_path у Pilot командама.

Команде Pilot-а за управљање билдовима

Скуп команди Pilot-а покрива све сценарије рада са TestFlight-ом: отпремање билдова, управљање тестерима, преглед статуса и праћење метаподатака. Свака команда враћа структурирани JSON излаз за даљу обраду у CI/CD скриптама.

Преглед статуса билдова

Команда fastlane pilot builds приказује листу свих билдова апликације са назнаком верзије, статуса обраде и датума отпремања. Статус билда може бити један од: Processing — Apple обрађује бинарну датотеку, Ready — билд је доступан за дистрибуцију, Rejected — билд је одбијен због грешака у валидацији.

# Преглед листе свих билдова у TestFlight-у
fastlane pilot builds

# Додељивање билда групи тестера
fastlane pilot distribute --build_number 42 \
      --groups "QA Team" --notify

# Преглед информација о одређеном билду
fastlane pilot build_info --build_number 42

Команда fastlane pilot distribute додељује билд наведеним групама тестера и шаље обавештења. Параметар --notify укључује слање е-поште обавештења тестерима о новом доступном билду — ово је кључно за ангажовање бета тестера у процесу тестирања и убрзавање повратних информација.

За управљање метаподацима билда користи се параметар --changelog, који поставља текст описа промена у новој верзији. Овај текст се приказује тестерима у позивници за тестирање у TestFlight апликацији. Препоручује се навођење кључних промена, исправљених грешака и нових функција у сваком билду.

Интеграција Pilot-а у CI/CD пајплајн

Pilot у CI/CD — је финална фаза пајплајна испоруке iOS апликације. Након што је Gym саставио IPA, а тестови су положени, Pilot отпрема билд у TestFlight и распоређује га по групама тестера. Ово омогућава QA тимовима да добију нову верзију апликације неколико минута након комита у репозиторијум.

Типичан iOS CI/CD пајплајн укључује секвенцу: Match (сертификати), Gym (састављање IPA), Pilot (отпремање у TestFlight и дистрибуција). Свака фаза зависи од претходне, што гарантује испоруку само валидних и потписаних билдова тестерима.

# Комплетан пајплајн у Fastfile-у
lane :beta do
    match(type: :appstore)
    gym(scheme: "MyApp", export_method: "app-store")
    pilot("build/MyApp.ipa", groups: ["QA", "PM"])
end

Параметар skip_waiting у команди upload омогућава да се не чека завршетак обраде бинарне датотеке од стране Apple-а у оквиру CI задатка — Pilot шаље захтев за отпремање, добија идентификатор билда и завршава рад. Ово убрзава пајплајн, јер обрада може трајати до 30 минута, који се не троше на чекање у CI раннеру.

За исправан рад Pilot-а у CI-ју потребно је подесити App Store Connect API кључ. Сачувајте .p8 датотеку кључа у безбедном складишту CI система и пренесите путању преко променљиве окружења APP_STORE_CONNECT_API_KEY_PATH. Pilot користи овај кључ за аутентификацију у API-ју без двофакторске аутентификације, што је кључно за аутоматске сценарије.

Типични проблеми при раду са Pilot-ом

При коришћењу Pilot-а, програмери се најчешће сусрећу са грешкама аутентификације, неисправном конфигурацијом апликације и проблемима са обрадом бинарних датотека од стране Apple-а. Дијагностика проблема Pilot-а почиње провером статуса билда у App Store Connect-у преко команде pilot builds.

Грешка «Your app is not available for testing in TestFlight» настаје када апликација није подешена за тестирање у App Store Connect-у. Решење: отворите одељак TestFlight у App Store Connect-у, активирајте тестирање за апликацију и уверите се да је Export Compliance исправно попуњен за ваш тип шифровања.

Грешка «Missing iOS Distribution signing identity» указује на одсуство Distribution сертификата у Keychain-у. Решење: покрените Match за учитавање исправног сертификата пре позивања Pilot-а. Distribution сертификат се разликује од Development-а — користи се за потписивање билдова намењених дистрибуцији путем TestFlight-а или App Store-а.

Код грешке «Invalid Provisioning Profile» билд садржи неисправан профил за изабрани метод извоза. Решење: проверите да Gym користи исправан export_method, који одговара типу профила у Match-у. Ако је билд састављен са development профилом, Pilot неће моћи да га отпреми у TestFlight — потребан је app-store или ad-hoc профил.