Публикуване на iOS приложения в App Store с GitLab и fastlane

Как GitLab с fastlane събира, подписва и публикува iOS приложения в App Store.

Наскоро имахме публикация за това как бързо да създадете и стартирате приложение за Android с GitLab и fastlane. Тук ще видим как да създадем и стартираме приложение за 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. Всички тези сертификати могат да се комбинират в профил за осигуряване.

Потребителите, които ще бъдат удостоверени, се нуждаят от възможността да създават сертификати, в противен случай стъпките cert и въздишка ще видите грешка.

други опции

Освен този прост метод, има и други начини за настройка на сертификати и профили. Така че, ако работите по различен начин, може да се наложи да се пренастроите. Най-важното е, че ще ви трябва конфигурация .xcodebuild, който ще сочи към необходимите файлове, а ключодържателят трябва да е наличен на компютъра за компилация за потребителя, под чието име работи runner-ът. Ние използваме fastlane за цифрово подписване и ако имате проблеми или искате да научите повече, вижте техните подробности документация за цифров подпис.

В този пример използвам подхода cert и въздишка, но за реална употреба вероятно е по-подходящ мач.

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

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

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

Настройването на бегача е много лесно. Следете актуално инструкции за настройка на GitLab Runner на macOS.

Забележка. Бегачът трябва да използва изпълняваща програма shell. Това е необходимо, за да се създаде iOS на macOS, за да работи директно като потребител, а не чрез контейнери. Ако използвате shell, изграждането и тестването се извършват като потребител на runner, точно на хоста за изграждане. Не е толкова безопасно, колкото контейнерите, така че по-добре обърнете документация за сигурностза да не пропуснете нищо.

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 трябва да изгради. Най-лесният начин да тествате това е да влезете като потребител, който ще стартира компилацията и да опитате да компилирате ръчно. Ако системата поиска достъп до ключодържателя, изберете „Винаги позволявай“, за да работи CI. Може би си струва да влезете и да наблюдавате първата двойка тръбопроводи, за да сте сигурни, че вече няма да искат ключодържател. Проблемът е, че Apple не ни улеснява да работим с автоматичен режим, но когато го настроите, всичко ще бъде наред.

fastlane инициал

За да използвате 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 свързани с подхода на подписване cert и въздишка. Ако използвате мач или нещо друго, направете промени.

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 runner за проекта и сме готови да тестваме тръбопровода. Да видим какво имаме .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

За да се удостоверите в App Store и да качите в TestFlight, имате нужда от удостоверяване за fastlane. За да направите това, създайте парола за приложение, която ще се използва в CI. Подробности тук.

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

FASTLANE_USER и FASTLANE_PASSWORD

Че cert и въздишка наречен профил за инициализация и сертификати при поискване, трябва да зададете променливи FASTLANE_USER и FASTLANE_PASSWORD. Подробности тук. Това не е необходимо, ако използвате различен метод на подписване.

В заключение

Можете да видите как работи всичко в моя прост пример.

Надявам се, че това е било полезно и ви е вдъхновило да работите с компилации на iOS в проекта GitLab. Ето още една CI съвети за фастлейн, за всеки случай. Може би искате да използвате CI_BUILD_ID (за постепенни компилации) до версия с автоматично нарастване.

Друга страхотна функция на fastlane е автоматични екранни снимки за App Store, които са много лесни за настройка.

Разкажете ни за опита си в коментарите и споделете идеи за подобряване на GitLab за разработка на приложения за iOS.

Източник: www.habr.com