Avaldame iOS rakendusi App Store'is GitLab'i ja fastlane'iga

Kuidas GitLab fastlane'iga koostab, allkirjastab ja avaldab iOS rakendusi App Store'is.

Hiljuti oli meil postitus, kuidas kiiresti kokku panna ja käivitada Android rakendus GitLab'i ja fastlane'i. Siin näeme, kuidas kokku panna ja käivitada iOS rakendus ning avaldada see TestFlight'is. Vaadake, kui äge ma muudan midagi iPad Pro's GitLab Web IDE's, võtan koondamise ja saan uuenduse rakenduse testversioonile samas iPad Pro's, kus ma selle loomise lõpetasin.

Siin lähme lihtsa iOS rakenduse juurde Swift'is, millega ma videot salvestasin.

Mõned sõnad Apple Store'i konfigureerimisest

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

Kõige raskem on seadistada allkirjastamisõigust App Store'is. Lootan, et saate sellega hakkama. Kui olete algaja, näitan vajalikku suunda, kuid siin me Apple'i tunnistuste halduse nüanssidest ei räägi, need muutuvad pidevalt. See postitus aitab teil alustada.

Minu rakendused

Tuleb App Store Connect'i rakendus, et teil oleks ID konfigureerimiseks .xcodebuild. Profiil ja rakenduse ID ühendavad koodikogumid, hinnad ja saadavuse, samuti TestFlight'i konfigureerimise rakenduste testimiseks kasutajate seas. Ärge tehke avalikku testimist, piisab privaatsetest testidest, kui teil on väike grupp, lihtne seadistus ja lisalubade taotlemise vajadus Apple'ilt.

Initsialiseerimise profiil

Peale rakenduse seadistamise on teil vaja jaotustunnistusi ja iOS arendusvõtmeid, mis on loodud sektsioonis Certificates, Identifiers & Profiles (Tunnistused, Identifikaatorid ja Profiilid) Apple Developer konsoolis. Kõik need tunnistused saab koondada initsialiseerimise profiili.

Kasutajad, kes lähevad autentimisele, peavad saama tunnistusi luua, vastasel juhul näete etappidel cert ja sigh viga.

Teised valikud

Peale selle lihtsa meetodi on ka teisi viise tunnistuste ja profiilide seadistamiseks. Seega, kui töötate teisiti, võite vajalikuks pidada ümber seadistamist. Kõige olulisem - teil on vajalik konfigureerimine. .xcodebuild, mis näitab vajalikud failid, ja võtme sidumine peab olema kergesti ligipääsetav ehituse arvutis, kus kasutaja, kelle nime all runner töötab, on sisse logitud. Digitaalallkirja loomiseks kasutame fastlane'i ja kui teil on probleeme või soovite rohkem teada, vaadake nende põhjalikku dokumentatsiooni digitaalallkirjade kohta.

Selles näites kasutan lähenemist cert ja sigh, kuid reaalsetes rakendustes sobib ehk paremini match.

GitLabi ja fastlane'i ettevalmistamine

CI Runneri ettevalmistamine

Kogudes kõik need andmed, liigume edasi GitLab runner'i seadistamise juurde MacOS seadmes. Kahjuks on iOSi rakenduste loomine reaalne ainult MacOS-is. Kuid kõik võib muutuda ja kui ootad arengut, siis jälgi projekte nagu xcbuild ja isign, ja meie siseülesannet gitlab-ce#57576.

Runners'i seadistamine on väga lihtne. Järgi kaasaegseid GitLab Runneri seadistamise juhiseid macOS-is.

Märkus. Runnery peaks kasutama käivitusprogrammi käsurea tõlgendus. See on iOS-i ehitamiseks macOS-is hädavajalik, et töötada otse kasutajana, mitte konteinerite kaudu. Kui kasutate käsurea tõlgendus, ehitamine ja testimine toimub runner'i kasutaja nimel otse ehitusmasinas. See ei ole nii turvaline kui konteinerid, seega tasub lugeda turvajuht, et miski ei jääks tähelepanuta.

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õtmeside peab olema seadistatud sellel hostil, et juurdepääsuks oleks võtmed, mida Xcode vajab ehitamiseks. Lihtsaim viis selle testimiseks on sisse logida kui kasutaja, kes käivitab ehituse, ja proovida ehitust käsitsi teostada. Kui süsteem küsib võtmesideme juurdepääsu, valige „Alati lubada“, et CI põhjalikult töötaks. Võib-olla tasub sisse logida ja jälgida esimest paari pipeline'i, et veenduda, et nad enam võtmeside juurdepääsu ei küsi. Probleem on selles, et Apple ei tee meile automaatrežiimiga lihtsaks, kuid kui olete selle seadistanud, siis on kõik korras.

fastlane init

Fastlane'i kasutamiseks projektis käivitage fastlane init. Lihtsalt järgige fastlane'i installimise ja käivitamise juhiseid, eriti jaotisest, mis käsitleb Gemfile'i, kuna me vajame kiiret ja ettearvatavat käivitust automaatse CI toru kaudu.

Kataloogis käivitage need käsud:

xcode-select --install
sudo gem install fastlane -NV
# Alternatiivselt kasutades Homebrew
# brew cask install fastlane
fastlane init

fastlane küsib põhikonfiguratsiooni ja loob seejärel projekti kausta fastlane kolme faili jaoks:

1. fastlane/Appfile

Siin ei ole midagi keerulist. Lihtsalt veenduge, et 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 ehitusetapid. Kasutame palju fastlane'i sisseehitatud funktsioone, nii et siin on samuti kõik arusaadav. Loome ühe rea, mis saab sertifikaadid, koostab ja laadib selle TestFlighti. Vajadusel võite need protsessid jagada erinevateks ülesanneteks. Kõik need toimingud (get_certificates, get_provisioning_profile, gym ja upload_to_testflight) kuuluvad juba fastlane'i alla.

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

default_platform(:ios)

platform :ios do
  desc "Ehita rakendus"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

See on valikuline fail, kuid ma lõin selle käsitsi, et muuta vaikeväljundkaust ja paigutada väljund praegusesse kausta. See lihtsustab CI-d. Kui olete huvitatud, lugege gym ja selle parameetreid dokumentatsioonist dokumentatsioon.

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

Meie .gitlab-ci.yml

Nii et meil on CI-jooksja projektiks ja oleme valmis katsetama torujuhet. Vaadakem, mis meil on .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

Kõik on suurepärane! Seame UTF-8 formaadi fastlane'ile, nagu nõutud, kasutame strateegiat clone täitva programmiga, käsurea tõlgendustagamaks, et meil on iga koostamise jaoks puhas tööruum, ja lihtsalt kutsume flappybuild fastlane, nagu näha ülal. Lõpptulemusena saame kokku panna, allkirjastada ja tootmise viia viimane koostamine TestFlighti.

Saame ka artefakti ja salvestame selle koos koostamisega. Pange tähele, et formaat .ipa on allkirjastatud ARM-eärisk, mis ei tööta simulaatoris. Kui soovite väljundit simulaatori jaoks, lisage lihtsalt koostamis siht, mis seda toodab, ja seejärel lisage see artefakti teele.

Teised keskkonnamuutujad

Siin on paar keskkonnamuutujat, mis aitavad kõike toimida.

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD ja FASTLANE_SESSION

App Store'i ja TestFlight'i autentimiseks on vajalik fastlane'i autentimine. Selleks looge rakenduse parool, mida kasutatakse CI-s. Üksikasjad siin.

Kui teil on kahefaasiline autentimine, looge muutujad FASTLANE_SESSION (juhised on seal).

FASTLANE_USER ja FASTLANE_PASSWORD

Et cert ja sigh kutsuda välja algatusprofiil ja sertifikaadid vastavalt nõudmisele, tuleb seadistada muutujad FASTLANE_USER ja FASTLANE_PASSWORD. Üksikasjad siin. Seda ei ole vaja, kui kasutate muud allkirjastamismeetodit.

Kokkuvõtteks

Kuidas see kõik toimib, on näha minu lihtsas näites.

Loodan, et see oli kasulik ja inspireeris teid töötama iOS kogumistega GitLab'is. Siin on veel nõuandeid CI fastlane'i jaoks, igaks juhuks. Võib-olla soovite kasutada CI_BUILD_ID (inkrementaalse kogumise jaoks), et automaatsete versioonide inkrementimist.

Veel üks lahe võimalus fastlane'is on automaatne ekraanipilt App Store'i jaoks, mida on väga lihtne seadistada.

Rääkige kommentaarides oma kogemustest ja jagage ideid GitLab'i täiustamiseks iOS rakenduste arendamiseks.

Allikas: habr.com