🥇Мобилно ЦИЦД искуство: један стандард брзе траке за многе мобилне апликације

Желео бих да причам о континуираној интеграцији и испоруци за мобилне апликације које користе фастлане. Како имплементирамо ЦИ/ЦД на све мобилне апликације, како смо до тога дошли и шта се на крају догодило.

На мрежи већ постоји довољно материјала о алату, који нам је толико недостајао у старту, тако да намерно нећу детаљно описивати алат, већ ћу се осврнути само на оно што смо тада имали:

Чланак се састоји из два дела:

Позадина настанка мобилних ЦИ/ЦД у компанији
Техничко решење за увођење ЦИ/ЦД за Н-апликације

Први део је више носталгија за старим данима, а други је искуство које можете применити на себе.

Тако се то историјски десило

2015

Тек смо почели да развијамо мобилне апликације, тада нисмо знали ништа о континуираној интеграцији, о ДевОпс-у и другим модерним стварима. Сваку надоградњу апликације сам програмер је објавио са своје машине. А ако је за Андроид прилично једноставно - састављено, потписано .apk и отпремио га на Гоогле Девелопер Цонсоле, затим за иОС тадашњи алат за дистрибуцију преко Ксцоде-а оставио нам је сјајне вечери - покушаји преузимања архиве често су завршавали грешкама и морали смо да покушамо поново. Испоставило се да најнапреднији програмер не пише код неколико пута месечно, већ пушта апликацију.

2016

Одрасли смо, већ смо размишљали како да ослободимо програмере целог дана за издање, а појавила се и друга апликација која нас је само више гурнула ка аутоматизацији. Исте године смо први пут инсталирали Џенкинса и написали гомилу застрашујућих скрипти, веома сличних онима које фастлане показује у својој документацији.

$ xcodebuild clean archive -archivePath build/MyApp 
    -scheme MyApp

$ xcodebuild -exportArchive 
                        -exportFormat ipa 
                        -archivePath "build/MyApp.xcarchive" 
                        -exportPath "build/MyApp.ipa" 
                        -exportProvisioningProfile "ProvisioningProfileName"

$ cd /Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/

$ ./altool —upload-app 
-f {abs path to your project}/build/{release scheme}.ipa  
-u "[email protected]" 
-p "PASS_APPLE_ID"

Нажалост, до сада су само наши програмери знали како ове скрипте функционишу и зашто је потребан овај бескрајни гомила кључева, а када се нешто поново поквари, добили су „прелепе вечери“ за анализу логова.

2017

Ове године смо сазнали да постоји таква ствар као што је фастлане. Није било толико информација као сада – како покренути једну, како је користити. А сам алат је у то време још увек био груб: сталне грешке су нас само разочарале и било је тешко поверовати у магичну аутоматизацију коју су обећавали.

Међутим, главни услужни програми укључени у фастлане језгро су gym и pilot, успели смо да га покренемо.

Наше скрипте су мало побољшане.

$ fastlane gym  —-workspace "Example.xcworkspace" 
                --scheme "AppName" 
                —-buildlog_path "/tmp" 
                -—clean

Они су побољшани, ако само зато што нису сви параметри неопходни за xcodebuild, треба да назначите - gym самостално ће разумети где и шта лежи. А за више финог подешавања, можете навести исте тастере као у xcodebuild, само је именовање тастера јасније.

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

Нажалост, мерења брзине монтаже xcodebuild и gym Нисмо то урадили, али ћемо веровати документацији - до 30% убрзања.

Јединствени процес за све апликације

2018. година и данас

До 2018. године, процес изградње и пуштања апликација у потпуности се преселио на Џенкинс, програмери су престали да издају са својих машина, а само је тим за издавање имао право на издавање.

Већ смо желели да побољшамо покретање тестова и статичке анализе, а наше скрипте су расле и расле. Расте и мењају се заједно са нашим апликацијама. У то време је било око 10 апликација.С обзиром да имамо две платформе, то је око 20 „живих“ скрипти.

Сваки пут када смо желели да додамо нови корак у скрипту, морали смо да копирамо и залепимо делове у све схелл скрипте. Можда смо могли да радимо пажљивије, али често су се такве промене завршавале грешкама у куцању, које су се претварале у вечери да тим за издавање поправи скрипте и сазна који је паметњаковић додао ову команду и шта она заправо ради. Генерално, не може се рећи да су скрипте за монтажу за једну платформу биле бар донекле сличне. Иако су свакако урадили исто.

Да би се покренуо процес за нову апликацију, било је потребно потрошити један дан да се изабере „свежа“ верзија ових скрипти, отклони грешке и каже „да, ради“.

У лето 2018. поново смо се осврнули на брзу траку која се још увек развија.

Задатак #1: сумирајте све кораке скрипте и поново их напишите у Фастфиле-у

Када смо почели, наше скрипте су изгледале као крпа за ноге која се састоји од свих степеница и штака у једном сценарију шкољке у Џенкинсу. Још нисмо прешли на цевовод и поделу по етапу.

Погледали смо шта имамо и идентификовали 4 корака који одговарају опису нашег ЦИ/ЦД-а:

буилд - инсталирање зависности, склапање архиве,
тест — покретање тестова јединица програмера, израчунавање покривености,
сонар - покреће све линтере и шаље извештаје у СонарКубе,
деплои — слање артефакта алфа (ТестФлигхт).

А ако не улазите у детаље, изостављајући кључеве који се користе у радњама, добићете овај Фастфиле:

default_platform(:ios)

platform :ios do
  before_all do
    unlock
  end

  desc "Build stage"
  lane :build do
    match
    prepare_build
    gym
  end

  desc "Prepare build stage: carthage and cocoapods"
  lane :prepare_build do
    pathCartfile = ""
    Dir.chdir("..") do
      pathCartfile = File.join(Dir.pwd, "/Cartfile")
    end
    if File.exist?(pathCartfile)
      carthage
    end
    pathPodfile = ""
    Dir.chdir("..") do
      pathPodfile = File.join(Dir.pwd, "/Podfile")
    end
    if File.exist?(pathPodfile)
      cocoapods
    end
  end

  desc "Test stage"
  lane :test do
    scan
    xcov
  end

  desc "Sonar stage (after run test!)"
  lane :run_sonar do
    slather
    lizard
    swiftlint
    sonar
  end

  desc "Deploy to testflight stage"
  lane :deploy do
    pilot
  end

  desc "Unlock keychain"
  private_lane :unlock do
    pass = ENV['KEYCHAIN_PASSWORD']
    unlock_keychain(
      password: pass
    )
  end
end

У ствари, наш први Фастфиле се показао монструозан, с обзиром на неке од штака које су нам још увек биле потребне и број параметара које смо заменили:

lane :build do
carthage(
  command: "update",
  use_binaries: false,
  platform: "ios",
  cache_builds: true)
cocoapods(
  clean: true,
    podfile: "./Podfile",
    use_bundle_exec: false)

gym(
  workspace: "MyApp.xcworkspace",
  configuration: "Release",
  scheme: "MyApp",
  clean: true,
  output_directory: "/build",
  output_name: "my-app.ipa")
end 

lane :deploy do
 pilot(
  username: "[email protected]",
  app_identifier: "com.example.app",
  dev_portal_team_id: "TEAM_ID_NUMBER_DEV",
  team_id: "ITS_TEAM_ID")
end

У горњем примеру, само део параметара које треба да наведемо: ово су параметри изградње – шема, конфигурација, називи профила за обезбеђивање, као и параметри дистрибуције – Аппле ИД налога програмера, лозинка, ИД апликације итд. на. Као прву апроксимацију, све ове кључеве стављамо у посебне датотеке - Gymfile, Matchfile и Appfile.

Сада у Џенкинсу можете да позивате кратке команде које не замућују поглед и лако су читљиве оком:

# fastlane ios <lane_name>

$ fastlane ios build
$ fastlane ios test
$ fastlane ios run_sonar
$ fastlane ios deploy

Ура, супер смо

Шта сте добили? Јасне команде за сваки корак. Очишћене скрипте, уредно поређане у фастлане датотеке. Радујући се, отрчали смо код програмера тражећи од њих да додају све што им је потребно у своја спремишта.

Али с временом смо схватили да ћемо наићи на исте потешкоће – и даље бисмо имали 20 скрипти за склапање које би на овај или онај начин почеле да живе сопственим животом, било би теже уређивати их, пошто би се скрипте преселиле у репозиторије, а тамо нисмо имали приступ. И, уопште, на овај начин неће бити могуће решити наш бол.

Задатак #2: набавите један Фастфиле за Н апликација

Сада се чини да решавање проблема није тако тешко - поставите променљиве и идемо. Да, у ствари, тако је проблем решен. Али у тренутку када смо то зезнули, нисмо имали ни стручност у самом фастлане-у, ни у Руби-у у којем је написан фастлане, нити корисних примера на мрежи - сви који су тада писали о фастлане-у били су ограничени на пример за једну апликацију за један програмер.

Фастлане може да обрађује променљиве окружења, а ми смо то већ испробали постављањем лозинке за привезак кључева:

ENV['KEYCHAIN_PASSWORD']

Након што смо погледали наше скрипте, идентификовали смо заједничке делове:

#for build, test and deploy
APPLICATION_SCHEME_NAME=appScheme
APPLICATION_PROJECT_NAME=app.xcodeproj
APPLICATION_WORKSPACE_NAME=app.xcworkspace
APPLICATION_NAME=appName

OUTPUT_IPA_NAME=appName.ipa

#app info
APP_BUNDLE_IDENTIFIER=com.example.appName
[email protected]
TEAM_ID=ABCD1234
FASTLANE_ITC_TEAM_ID=123456789

Сада, да бисмо почели да користимо ове кључеве у фастлане датотекама, морали смо да смислимо како да их тамо испоручимо. Фастлане има решење за ово: учитавање променљивих преко дотенв. Документација каже да ако вам је важно да учитате кључеве за различите сврхе, направите неколико конфигурационих датотека у директоријуму фастлане .env, .env.default, .env.development.

А онда смо одлучили да ову библиотеку користимо мало другачије. Хајде да ставимо у спремиште програмера не фастлане скрипте и њихове мета информације, већ јединствене кључеве ове апликације у датотеци .env.appName.

Они сами Fastfile, Appfile, Matchfile и Gymfile, сакрили смо га у посебно спремиште. Тамо је сакривена додатна датотека са кључевима лозинки са других сервиса - .env.
Можете видети пример овде.

На ЦИ позив се није много променио; додат је конфигурациони кључ за одређену апликацију:

# fastlane ios <lane_name> --env appName

$ fastlane ios build --env appName
$ fastlane ios test --env appName
$ fastlane ios run_sonar --env appName
$ fastlane ios deploy --env appName

Пре покретања команди, учитавамо наше спремиште са скриптама. Не изгледа тако лепо:

git clone [email protected]/FastlaneCICD.git fastlane_temp

cp ./fastlane_temp/fastlane/* ./fastlane/
cp ./fastlane_temp/fastlane/.env fastlane/.env

Оставио сам ово решење за сада, иако Фастлане има решење за преузимање Фастфиле преко акција import_from_git, али ради само за Фастфиле, али не и за друге датотеке. Ако желите „стварно лепо“, можете написати своје action.

Сличан сет је направљен за Андроид апликације и РеацтНативе, датотеке су у истом спремишту, али у различитим гранама iOS, android и react_native.

Када тим за издавање жели да дода неки нови корак, промене у скрипти се снимају преко МР-а у гит-у, више нема потребе да се траже кривци за покварене скрипте, и уопште, сада морате да покушате да га разбијете.

Сада је то то сигурно

Раније смо трошили време одржавајући све скрипте, ажурирајући их и поправљајући све последице ажурирања. Било је веома разочаравајуће када су разлози за грешке и застоје у издањима биле једноставне грешке у куцању које је било тако тешко пратити у збрци схелл скрипти. Сада су такве грешке сведене на минимум. Промене се уводе у све апликације одједном. А потребно је 15 минута да се нова апликација стави у процес - поставите цевовод шаблона на ЦИ и додајте кључеве у спремиште програмера.

Чини се да поента са Фастфиле-ом за Андроид и потписом апликације остаје необјашњена; ако је чланак занимљив, писаћу наставак. Биће ми драго да видим ваша питања или предлоге „како бисте решили овај проблем“ у коментарима или на Телеграму башкирова.

Извор: ввв.хабр.цом

Мобиле ЦИЦД искуство: један брзи стандард за многе мобилне апликације