Avaldame iOS-i rakendusi App Store'is GitLabi ja fastlane'i abil

Kuidas GitLab koos fastlane'iga kogub, allkirjastab ja avaldab iOS-i rakendusi App Store'is.

Hiljuti oli meil postitus selle kohta, kuidas kiiresti koguda ja käivitada Androidi rakendus GitLabi ja fastlane. Siin vaatame, kuidas koguda ja käivitada iOS-i rakendus ning avaldada see TestFlightis. Vaadake, kui äge ma teen muudatuse iPad Pro-l GitLab Web IDE-s, võtan kogumise ja saan testversiooni värskenduse sama iPad Pro-l, kus ma selle välja töötasin.

Siin kasutame lihtsat iOS-i rakendust Swiftis, millega ma videot salvestasin.

Mõned sõnad Apple Store'i konfiguratsioonist

Me vajame rakendust App Store'is, levitamise sertifikaate ja initsialiseerimise profiili, et kõik kokku siduda.

K kõige keerulisem on siin Apple'i rakenduste allkirjastamise õiguste seadistamine. Loodetavasti saate sellega ise hakkama. Kui olete algaja, annan ma vajalikku suunda, kuid siin me ei räägi Apple'i sertifikaatide haldamise nüanssidest, kuna need pidevalt muutuvad. See postitus aitab teil asjaga alustada.

Minu rakendused

Vajalik on rakendus App Store Connectis, et teil oleks ID konfiguratsiooni jaoks .xcodebuild. Rakenduse profiil ja ID ühendavad koodikogumikud, hinnad ja kättesaadavuse ning TestFlighti seadistamine, et jagada testrakendusi kasutajatega. Avalik testimine ei ole vajalik; privaatne testimine on piisav, kui teil on väike grupp, lihtne seadistus ja ei ole vaja lisalubasid Apple'ilt.

Seadistusprofiil

Lisaks rakenduse seadistusele vajate iOS’i jaotamise ja arendamise võtmeid, mis on loodud Apple Developer konsoolis sektsioonis Certificates, Identifiers & Profiles (Sertifikaadid, identifikaatorid ja profiilid). Kõik need sertifikaadid saab kokku panna seadistusprofiili.

Kasutajatel, kes peavad autentimist läbima, peab olema võimalik sertifikaate luua, vastasel juhul näete etappidel cert ja sigh vea.

Teised variandid

Lisaks sellele lihtsale meetodile on muidki viise sertifikaatide ja profiilide seadistamiseks. Seega, kui töötate teisiti, võib olla vajalik ümber seadistamine. Peamine on, et teil on vaja konfiguratsiooni. .xcodebuild, mis suunab vajalikud failid, ja võtme sidumine peab olema koostatava kasutaja arvutis, kelle nime all töötab jooksja. Digitaalallkirja jaoks kasutame fastlane'i, ja kui esineb probleeme või soovite rohkem teada, uurige nende põhjalikku dokumentatsiooni digitaalallkirjade kohta.

Selles näites kasutan lähenemist cert ja sigh, kuid reaalseks rakendamiseks sobib tõenäoliselt paremini match.

GitLabi ja fastlane'i ettevalmistamine

CI Runneri ettevalmistamine

Kogunud kõik need andmed, liigume edasi GitLab Runneri konfigureerimise juurde MacOS seadmes. Kahjuks saab iOS-i rakendusi luua tõeliselt ainult MacOS-is. Kuid kõik võib muutuda, ja kui ootad selles valdkonnas edusamme, siis jälgi projekte, nagu xcbuild ja , isign, ja meie sisemine ülesanne gitlab-ce#57576.

Jooksja seadistamine on väga lihtne. Järgige kehtivaid GitLab Runneri seadistamise juhiseid MacOS-is.

Märkus. Jooksja peab kasutama täitmisprogrammi shell. See on iOS-i kogumise jaoks MacOS-is hädavajalik, et töötada otse kasutajana, mitte konteinerite kaudu. Kui kasutate shell, kokkupanek ja testimine toimub kasutaja jooksja nimel, otse kokkupaneku hostis. See ei ole nii turvaline kui konteinerid, seega parem kerige edasi turvalisuse dokumentatsiooni, et midagi vahele ei jääks.

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'i võtmehoidja peab olema sellel hostil konfigureeritud juurdepääsuga võtmetele, mida Xcode vajab kokkupanekuks. Lihtsaim viis seda testida on sisse logida kasutajana, kes alustab kokkupanekut, ja proovida kokkupanekut käsitsi teostada. Kui süsteem küsib juurdepääsu võtmehoidjale, valige 'Alati lubada', et CI töötaks. Võib-olla tasub sisse logida ja vaadata esimesi paari torujuhtmeid, et veenduda, et nad enam võtmehoidjat ei küsi. Probleem on selles, et Apple ei lihtsusta automaatset režiimi, kuid kui te selle seadistate, siis läheb kõik hästi.

fastlane init

Fastlane'i kasutamiseks projektis käivitage fastlane init. Järgige lihtsalt fastlane'i installimise ja käivitamise juhiseid, eriti osas Gemfile, sest meil on vaja kiiret ja ennustatavat käivitamist läbi automaatse CI toru.

Projektikataloogis käivitage need käsud:

xcode-select --install
sudo gem install fastlane -NV
# Alternatiivina kasutage Homebrew'd
# brew cask install fastlane
fastlane init

fastlane küsib põhilist seadistust ja loob seejärel projekti kausta fastlane kolm faili:

1. fastlane/Appfile

Siin pole midagi keerulist. Lihtsalt kontrollige, kas Apple ID ja rakenduse ID on õigesti määratud.

app_identifier("com.vontrance.flappybird") # Teie rakenduse paketi identifikaator
apple_id("your-email@your-domain.com") # Teie Apple'i e-posti aadress

2. fastlane/Fastfile

Fastfile määratleb koostamisprotsessid. Me kasutame palju sisseehitatud funktsioone fastlane'ist, seega on siin ka kõik arusaadav. Loome ühe rea, mis saab sertifikaadid, koostab ja laadib selle TestFlighti. Kui vaja, saate selle protsessi jagada erinevateks ülesanneteks. Kõik need toimingud (get_certificates, get_provisioning_profile, gym ja upload_to_testflight) kuuluvad juba fastlane'i sisse.

Toimingud get_certificates ja get_provisioning_profile seotud allkirjastamise lähenemisega cert ja sigh. Kui kasutate match või midagi muud, tehke muudatusi.

default_platform(:ios)

platform :ios do
  desc "Rakenduse kokku panemine"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

See ei ole kohustuslik fail, aga ma lõin selle käsitsi, et muuta vaikimisi väljundkausta ja panna väljundid praegusesse kausta. See lihtsustab CI-d. Kui huvi, loe lähemalt gym ja selle parameetreid dokumentatsioonis.

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

Meie .gitlab-ci.yml

Nii et meil on CI-jooksja projekti jaoks ja oleme valmis katsetama torujuhet. Vaatame, mis meil on .gitlab-ci.yml:

stages:
  - build

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

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

Kõik on suurepärane! Seame UTF-8 formaadi fastlane'i jaoks, nagu nõutud, kasutame strateegiat clone täidetava programmiga shell, et meil oleks iga ehituse jaoks puhas tööruum, ja lihtsalt kutsume flappybuild fastlane, nagu eespool nähtud. Tulemuseks on ehitus, allkiri ja viimase ehituse juurutamine TestFlighti.

Saame ka artefakti ja salvestame selle koos ehitusega. Pane tähele, et formaadi .ipa on allkirjastatud ARM täidetav fail, mis ei toimi simulaatoris. Kui soovid väljundit simulaatori jaoks, lisa lihtsalt ehituslähtese eesmärk, mis seda tootab, ja seejärel lisa see artefakti teele.

Muud keskkonnamuutujad

Siin on paar keskkonnamuutujat, millel kõik toimib.

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD ja FASTLANE_SESSION

App Store'i autentimiseks ja TestFlighti üleslaadimiseks on vajalik fastlane'i autentimine. Selleks looge rakenduse parool, mida kasutatakse CI-s. Lisainfot siit.

Kui teil on kahefaktoriline autentimine, looge muutuja FASTLANE_SESSION (juhised leiate sealt).

FASTLANE_USER ja FASTLANE_PASSWORD

Et cert ja sigh kutsuti välja algatamisprofiil ja sertifikaadid nõudmisel, tuleb määrata muutujad FASTLANE_USER ja FASTLANE_PASSWORD. Lisainfot siit. See ei ole vajalik, kui kasutate teist allkirjastamisviisi.

Kokkuvõtteks

Saate näha, kuidas see kõik toimib minu lihtsas näites.

Loodan, et see oli kasulik ja ma inspireerisin teid töötama iOSi kogumistega GitLabis. Siin on veel CI näpunäiteid fastlane'i jaoks, juhuks kui soovite kasutada CI_BUILD_ID (inkrementaalsete kogumiste jaoks), et automaatne inkrementimine versiooniga.

Veel üks lahe võimalus fastlane'is on automaatne ekraanipiltide tegemine App Store'i jaoks, mille seadistamine on väga lihtne.

Rääkige kommentaarides oma kogemusest ja jagage ideid GitLabi parandamiseks iOSi rakenduste arendamiseks.

Allikas: habr.com