Објавување на апликации за iOS во App Store со GitLab и fastlane

Како GitLab со fastlane собира, потпишува и објавува iOS апликации во App Store.

Неодамна имавме објава за тоа како брзо да изградите и стартувате апликација за Android со GitLab и брза лента. Овде ќе видиме како да изградиме и извршиме апликација за iOS и да ја објавиме на TestFlight. Проверете колку е кул Правам промена на iPad Pro со GitLab Web IDE, го земам склопот и добивам ажурирање на тест верзијата на апликацијата на истиот iPad Pro каде што ја развив.

Еве ние ќе земеме едноставна апликација за iOS на Swift, со кого го снимав видеото.

Неколку зборови за конфигурацијата на Apple Store

Ќе ни треба апликација App Store, сертификати за дистрибуција и профил за обезбедување за да се поврзе сè заедно.

Најтешката работа овде е поставувањето права за потпишување во App Store. Се надевам дека ќе можете сами да го сфатите ова. Ако сте нов, ќе ве упатам во вистинската насока, но овде нема да зборуваме за сложеноста на управувањето со сертификатите на Apple, а тие постојано се менуваат. Овој пост ќе ви помогне да започнете.

Мои апликации

Потребна ви е апликација во App Store Connect за да имате ID за конфигурација .xcodebuild. Профилот и ID на апликацијата ги комбинираат изградбите на кодот, цените и достапноста и конфигурацијата на TestFlight за дистрибуција на тест апликации до корисниците. Не правете јавно тестирање, приватното тестирање ќе биде доволно ако имате мала група, лесно поставување и не ви требаат дополнителни дозволи од Apple.

Профил на иницијализација

Покрај поставувањето на апликацијата, потребни ви се клучеви за дистрибуција и развој на iOS создадени во делот Сертификати, идентификатори и профили на програмерската конзола на Apple. Сите овие сертификати може да се комбинираат во профил за обезбедување.

Корисниците кои ќе бидат автентицирани треба да можат да креираат сертификати, инаку чекорите серт и воздишка ќе видите грешка.

други опции

Покрај овој едноставен метод, постојат и други начини за конфигурирање на сертификати и профили. Значи, ако работите поинаку, можеби ќе треба да се прилагодите. Најважно е дека ви треба конфигурација .xcodebuild, што ќе укаже на потребните датотеки, а приврзокот за клучеви мора да биде достапен на компјутерот за изградба на корисникот под чие име работи тркачот. За дигитален потпис користиме fastlane, а ако има проблеми или сакате да дознаете повеќе, проверете ги нивните детали документација за дигитални потписи.

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

Подготовка на GitLab и fastlane

Подготовка на CI Runner

Откако ги собравме сите овие податоци, преминуваме кон конфигурацијата на GitLab тркачот на уредот MacOS. За жал, можете да правите апликации за iOS само на MacOS. Но, сè може да се промени, и ако очекувате напредок во оваа област, внимавајте на проекти како xcbuild и знак, и нашата внатрешна задача gitlab-ce#57576.

Поставувањето на тркачот е многу едноставно. Следете ја струјата инструкции за поставување на GitLab Runner на macOS.

Забелешка. Тркачот мора да користи извршна програма shell. Ова е потребно за да се изгради iOS на macOS за да работи директно како корисник наместо преку контејнери. Доколку користите shell, градењето и тестирањето се изведуваат како корисник на тркач, директно на build-домаќинот. Не е толку безбеден како контејнерите, затоа подобро прелистувајте безбедносна документацијаза да не пропуштите ништо.

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
cd ~
gitlab-runner install
gitlab-runner start

Apple Keychain мора да биде конфигуриран на овој домаќин со пристап до клучевите што треба да ги изгради Xcode. Најлесен начин да го тестирате ова е да се најавите како корисник кој ќе ја изврши изградбата и да се обиде рачно да го изгради. Ако системот бара пристап до синџирот на клучеви, изберете Always Allow for CI да работи. Можеби вреди да влезете и да ги гледате првите неколку цевководи за да бидете сигурни дека повеќе не го бараат привезокот. Проблемот е што Apple не ни го олеснува користењето на автоматскиот режим, но штом ќе го започнете, сè ќе биде добро.

fastlane init

За да користите fastlane во проект, стартувајте fastlane init. Само следете инструкции за инсталирање и водење fastlane, особено во делот за Gemfile, бидејќи ни треба брзо и предвидливо лансирање преку автоматизиран CI гасовод.

Во директориумот на вашиот проект, извршете ги овие команди:

xcode-select --install
sudo gem install fastlane -NV
# Alternatively using Homebrew
# brew cask install fastlane
fastlane init

fastlane ќе побара основна конфигурација и потоа ќе создаде папка fastlane во проектот со три датотеки:

1. fastlane/Appfile

Нема ништо комплицирано овде. Само проверете дали вашиот Apple ID и App ID се точни.

app_identifier("com.vontrance.flappybird") # The bundle identifier of your app
apple_id("[email protected]") # Your Apple email address

2. fastlane/Fastfile

Fastfile ги дефинира чекорите за градење. Ние користиме многу вградени функции на fastlane, така што сè е јасно и овде. Создаваме една линија која прима сертификати, ја врши склопувањето и ја поставува на TestFlight. Доколку е потребно, можете да го поделите овој процес на различни задачи. Сите овие операции (get_certificates, get_provisioning_profile, gym и upload_to_testflight) веќе се вклучени во fastlane.

Активност get_certificates и get_provisioning_profile поврзани со пристапот на потпишување серт и воздишка. Доколку користите натпревар или што и да е, направи промени.

default_platform(:ios)

platform :ios do
  desc "Build the application"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

Ова е опционална датотека, но ја создадов рачно за да го сменам стандардниот директориум за излез и да го ставам излезот во тековната папка. Ова го поедноставува CI. Ако сте заинтересирани, прочитајте за gym и неговите параметри во документација.

https://docs.fastlane.tools/actions/gym/

Наше .gitlab-ci.yml

Значи, имаме CI тркач за проектот и подготвени сме да го тестираме гасоводот. Ајде да видиме во што имаме .gitlab-ci.yml:

stages:
  - build

variables:
  LC_ALL: "en_US.UTF-8"
  LANG: "en_US.UTF-8"
  GIT_STRATEGY: clone

build:
  stage: build
  script:
    - bundle install
    - bundle exec fastlane flappybuild
  artifacts:
    paths:
    - ./FlappyBird.ipa

Все отлично! Го поставивме форматот на UTF-8 за fastlane по потреба, користете стратегија clone со програма за извршување shell, за да имаме чист работен простор за секое склопување и едноставно јавете се flappybuild fastlane, како што се гледа погоре. Како резултат на тоа, добиваме склопување, потпис и распоредување на најновото склопување во TestFlight.

Го добиваме и артефактот и го зачувуваме со склопот. Ве молиме имајте предвид дека форматот .ipa е потпишана извршна датотека на ARM што не работи во симулаторот. Ако сакате излез за симулаторот, само додадете ја целта за изградба што го произведува, а потоа вклучете ја во патеката за артефакт.

Други променливи на животната средина

Има неколку променливи на околината што прават сè да функционира.

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

Потребна е автентикација за fastlane за автентикација во App Store и поставување на TestFlight. За да го направите ова, креирајте лозинка за апликацијата што ќе се користи во CI. Детали тука.

Ако имате двофакторна автентикација, креирајте променлива FASTLANE_SESSION (инструкции таму).

FASTLANE_USER и FASTLANE_PASSWORD

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

Во заклучок

Можете да видите како сето тоа функционира во мојот едноставен пример.

Се надевам дека ова беше корисно и ве инспирираше да работите со iOS-градбите во проект на GitLab. Еве уште еден CI совети за fastlane, за секој случај. Можеби ќе сакате да користите CI_BUILD_ID (за инкрементални градби) до автоматски ја зголемува верзијата.

Друга кул карактеристика на fastlane е автоматски слики од екранот за App Store, кои се многу лесни за поставување.

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

Извор: www.habr.com