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 Developer Consol-ის სერთიფიკატების, იდენტიფიკატორებისა და პროფილების განყოფილებაში. ყველა ეს სერთიფიკატი შეიძლება გაერთიანდეს უზრუნველყოფის პროფილში.

მომხმარებლებს, რომლებიც დამოწმებულნი იქნებიან, უნდა შეეძლოთ სერთიფიკატების შექმნა, წინააღმდეგ შემთხვევაში ეს ნაბიჯები დამოწმება და კვნესა თქვენ ნახავთ შეცდომას.

სხვა ვარიანტი

ამ მარტივი მეთოდის გარდა, არსებობს სერთიფიკატების და პროფილების კონფიგურაციის სხვა გზები. ასე რომ, თუ სხვაგვარად მუშაობთ, შეიძლება მოგიწიოთ ადაპტაცია. ყველაზე მნიშვნელოვანი ის არის, რომ თქვენ გჭირდებათ კონფიგურაცია .xcodebuild, რომელიც მიუთითებს აუცილებელ ფაილებზე და გასაღების ჯაჭვი ხელმისაწვდომი უნდა იყოს build კომპიუტერზე მომხმარებლისთვის, რომლის სახელითაც გაშვებულია runner. ციფრული ხელმოწერისთვის ჩვენ ვიყენებთ fastlane-ს და თუ არის პრობლემები ან გსურთ მეტი იცოდეთ, შეამოწმეთ მათი დეტალები დოკუმენტაცია ციფრული ხელმოწერების შესახებ.

ამ მაგალითში მე ვიყენებ მიდგომას დამოწმება და კვნესა, მაგრამ რეალური გამოყენებისთვის ის ალბათ უკეთესია ემთხვევა.

GitLab-ისა და fastlane-ის მომზადება

CI Runner-ის მომზადება

ყველა ამ მონაცემის შეგროვების შემდეგ, ჩვენ გადავდივართ GitLab runner-ის კონფიგურაციაზე MacOS მოწყობილობაზე. სამწუხაროდ, iOS-ის აპლიკაციების შექმნა მხოლოდ MacOS-ზე შეგიძლიათ. მაგრამ ყველაფერი შეიძლება შეიცვალოს და თუ ამ სფეროში პროგრესს ელით, თვალი ადევნეთ მსგავს პროექტებს xcbuild и ნიშანიდა ჩვენი შიდა ამოცანა gitlab-ce#57576.

მორბენალის დაყენება ძალიან მარტივია. მიჰყევით მიმდინარეობას ინსტრუქციები GitLab Runner-ის დაყენებისთვის macOS-ზე.

Შენიშვნა. მორბენალმა უნდა გამოიყენოს შესრულებადი პროგრამა shell. ეს საჭიროა macOS-ზე iOS-ის ასაშენებლად, რათა იმუშაოს უშუალოდ როგორც მომხმარებელმა და არა კონტეინერების მეშვეობით. თუ იყენებთ shell, მშენებლობა და ტესტირება ხორციელდება როგორც runner მომხმარებელი, პირდაპირ 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-ს უნდა ააშენოს. ამის შესამოწმებლად უმარტივესი გზაა შესვლა, როგორც მომხმარებელი, რომელიც გაუშვებს build-ს და შეეცდება ხელით შექმნას. თუ სისტემა ითხოვს წვდომას keychain, აირჩიეთ Always Allow for CI to work. შესაძლოა ღირდეს შესვლა და პირველი მილსადენების ყურება, რათა დარწმუნდეთ, რომ ისინი აღარ ითხოვენ საკინძს. უბედურება ის არის, რომ 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/

Ours .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 შესრულებადი, რომელიც არ მუშაობს სიმულატორში. თუ გსურთ გამომავალი სიმულატორისთვის, უბრალოდ დაამატეთ build target, რომელიც აწარმოებს მას და შემდეგ ჩართეთ იგი არტეფაქტის გზაზე.

სხვა გარემოს ცვლადები

აქ არის გარემოს რამდენიმე ცვლადი, რაც ყველაფერს ამუშავებს.

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