GitLab और fastlane के साथ iOS एप्लिकेशन को ऐप स्टोर पर प्रकाशित करना

फास्टलेन के साथ GitLab कैसे iOS एप्लिकेशन को ऐप स्टोर पर एकत्रित, हस्ताक्षरित और प्रकाशित करता है।

हमारे पास हाल ही में था एंड्रॉइड एप्लिकेशन को तुरंत बनाने और चलाने के तरीके के बारे में पोस्ट करें GitLab के साथ और तेज गति की लेन. यहां हम देखेंगे कि iOS ऐप कैसे बनाएं और चलाएं और इसे TestFlight पर कैसे प्रकाशित करें। देखें कि यह कितना अच्छा है मैं GitLab वेब IDE के साथ iPad Pro में बदलाव कर रहा हूं, मैं असेंबली लेता हूं और उसी आईपैड प्रो पर एप्लिकेशन के परीक्षण संस्करण का अपडेट प्राप्त करता हूं जहां मैंने इसे विकसित किया था।

यहां हम लेंगे स्विफ्ट पर सरल आईओएस ऐप, जिसके साथ मैंने वीडियो रिकॉर्ड किया।

Apple स्टोर कॉन्फ़िगरेशन के बारे में कुछ शब्द

हमें सब कुछ एक साथ जोड़ने के लिए एक ऐप स्टोर ऐप, वितरण प्रमाणपत्र और एक प्रावधान प्रोफ़ाइल की आवश्यकता होगी।

यहां सबसे कठिन काम ऐप स्टोर में हस्ताक्षर अधिकार स्थापित करना है। मुझे आशा है कि आप इसे स्वयं समझ सकते हैं। यदि आप नए हैं, तो मैं आपको सही दिशा बताऊंगा, लेकिन हम यहां Apple प्रमाणपत्रों को प्रबंधित करने की जटिलताओं के बारे में बात नहीं करेंगे, और वे लगातार बदल रहे हैं। यह पोस्ट आपको आरंभ करने में मदद करेगी.

मेरी एप्प्स

आपको ऐप स्टोर कनेक्ट में एक ऐप की आवश्यकता है ताकि आपके पास कॉन्फ़िगरेशन के लिए एक आईडी हो .xcodebuild. प्रोफ़ाइल और एप्लिकेशन आईडी उपयोगकर्ताओं को परीक्षण एप्लिकेशन वितरित करने के लिए कोड बिल्ड, मूल्य निर्धारण और उपलब्धता और टेस्टफ़्लाइट कॉन्फ़िगरेशन को जोड़ती है। सार्वजनिक परीक्षण न करें, यदि आपके पास एक छोटा समूह है, आसान सेटअप है, और Apple से अतिरिक्त अनुमति की आवश्यकता नहीं है, तो निजी परीक्षण पर्याप्त होगा।

आरंभीकरण प्रोफ़ाइल

ऐप सेटअप के अलावा, आपको Apple डेवलपर कंसोल के प्रमाणपत्र, पहचानकर्ता और प्रोफ़ाइल अनुभाग में बनाई गई iOS वितरण और विकास कुंजियों की आवश्यकता होगी। इन सभी प्रमाणपत्रों को एक प्रावधान प्रोफ़ाइल में जोड़ा जा सकता है।

जिन उपयोगकर्ताओं को प्रमाणित किया जाएगा उन्हें प्रमाणपत्र बनाने में सक्षम होना होगा, अन्यथा चरण प्रमाणपत्र और आह आपको एक त्रुटि दिखाई देगी.

अन्य विकल्प

इस सरल विधि के अलावा, प्रमाणपत्र और प्रोफ़ाइल कॉन्फ़िगर करने के अन्य तरीके भी हैं। इसलिए, यदि आप अलग तरीके से काम करते हैं, तो आपको अनुकूलन करना पड़ सकता है। सबसे महत्वपूर्ण बात यह है कि आपको कॉन्फ़िगरेशन की आवश्यकता है .xcodebuild, जो आवश्यक फ़ाइलों को इंगित करेगा, और किचेन उस उपयोगकर्ता के लिए बिल्ड कंप्यूटर पर उपलब्ध होना चाहिए जिसके नाम से रनर चल रहा है। डिजिटल हस्ताक्षर के लिए हम फास्टलेन का उपयोग करते हैं, और यदि कोई समस्या है या आप अधिक जानना चाहते हैं, तो उनका विवरण देखें डिजिटल हस्ताक्षर के बारे में दस्तावेज़ीकरण.

इस उदाहरण में मैं दृष्टिकोण का उपयोग कर रहा हूँ प्रमाणपत्र और आह, लेकिन वास्तविक उपयोग के लिए यह संभवतः बेहतर अनुकूल है मैच.

GitLab और fastlane तैयार किया जा रहा है

सीआई रनर तैयार करना

यह सारा डेटा एकत्र करने के बाद, हम MacOS डिवाइस पर GitLab रनर के कॉन्फ़िगरेशन पर आगे बढ़ते हैं। दुर्भाग्य से, आप केवल MacOS पर iOS ऐप्स बना सकते हैं। लेकिन सब कुछ बदल सकता है, और यदि आप इस क्षेत्र में प्रगति की उम्मीद करते हैं, तो जैसी परियोजनाओं पर नज़र रखें xcbuild и संकेत, और हमारा आंतरिक कार्य गिटलैब-सीई#57576.

रनर को स्थापित करना बहुत सरल है। वर्तमान का पालन करें MacOS पर GitLab रनर स्थापित करने के निर्देश.

टिप्पणी। धावक को एक निष्पादन योग्य प्रोग्राम का उपयोग करना होगा shell. कंटेनर के बजाय सीधे उपयोगकर्ता के रूप में काम करने के लिए macOS पर iOS बनाने के लिए यह आवश्यक है। यदि आप उपयोग कर रहे हैं shell, निर्माण और परीक्षण सीधे बिल्ड होस्ट पर रनर उपयोगकर्ता के रूप में किया जाता है। यह कंटेनर जितना सुरक्षित नहीं है, इसलिए बेहतर होगा कि ब्राउज़ करें सुरक्षा दस्तावेजताकि आप कुछ भी न चूकें.

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 किचेन को इस होस्ट पर उन कुंजियों तक पहुंच के साथ कॉन्फ़िगर किया जाना चाहिए जिन्हें Xcode को बनाने की आवश्यकता है। इसका परीक्षण करने का सबसे आसान तरीका उपयोगकर्ता के रूप में लॉग इन करना है जो बिल्ड चलाएगा और इसे मैन्युअल रूप से बनाने का प्रयास करेगा। यदि सिस्टम किचेन एक्सेस मांगता है, तो सीआई को काम करने के लिए हमेशा अनुमति दें का चयन करें। यह सुनिश्चित करने के लिए कि वे अब चाबी का गुच्छा न मांगें, अंदर जाकर पहले कुछ पाइपलाइनों को देखना उचित हो सकता है। समस्या यह है कि Apple हमारे लिए ऑटो मोड का उपयोग करना आसान नहीं बनाता है, लेकिन एक बार जब आप इसे शुरू कर देंगे, तो सब कुछ ठीक हो जाएगा।

फास्टलेन init

किसी प्रोजेक्ट में फास्टलेन का उपयोग करने के लिए, चलाएँ fastlane init. बस पालन करें फास्टलेन को स्थापित करने और चलाने के निर्देश, विशेष रूप से अनुभाग में जेमफाइल, क्योंकि हमें एक स्वचालित सीआई पाइपलाइन के माध्यम से तेज़ और पूर्वानुमानित लॉन्च की आवश्यकता है।

अपनी प्रोजेक्ट निर्देशिका में, ये आदेश चलाएँ:

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

फास्टलेन एक बुनियादी कॉन्फ़िगरेशन मांगेगा और फिर तीन फाइलों के साथ प्रोजेक्ट में एक फास्टलेन फ़ोल्डर बनाएगा:

1. fastlane/Appfile

यहां कुछ भी जटिल नहीं है. बस सुनिश्चित करें कि आपकी ऐप्पल आईडी और ऐप आईडी सही हैं।

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

2. fastlane/Fastfile

Fastfile निर्माण चरणों को परिभाषित करता है। हम फास्टलेन की बहुत सारी अंतर्निहित सुविधाओं का उपयोग करते हैं, इसलिए यहां भी सब कुछ स्पष्ट है। हम एक लाइन बनाते हैं जो प्रमाणपत्र प्राप्त करती है, असेंबली करती है और उसे टेस्टफ़्लाइट पर अपलोड करती है। यदि आवश्यक हो तो आप इस प्रक्रिया को विभिन्न कार्यों में विभाजित कर सकते हैं। ये सभी ऑपरेशन (get_certificates, get_provisioning_profile, gym и upload_to_testflight) पहले से ही फास्टलेन में शामिल हैं।

कार्रवाई 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

यह एक वैकल्पिक फ़ाइल है, लेकिन मैंने डिफ़ॉल्ट आउटपुट निर्देशिका को बदलने और आउटपुट को वर्तमान फ़ोल्डर में रखने के लिए इसे मैन्युअल रूप से बनाया है। यह सीआई को सरल बनाता है. यदि रुचि हो तो इसके बारे में पढ़ें gym और इसके पैरामीटर प्रलेखन.

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

हमारा .gitlab-ci.yml

इसलिए, हमारे पास परियोजना के लिए एक सीआई रनर है, और हम पाइपलाइन का परीक्षण करने के लिए तैयार हैं। आइए देखें कि हमारे पास क्या है .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 पर सेट किया है, रणनीति का उपयोग करें clone प्रोग्राम क्रियान्वित करने के साथ shell, ताकि हमारे पास प्रत्येक असेंबली के लिए एक साफ़ कार्यक्षेत्र हो, और बस कॉल करें flappybuild फास्टलेन, जैसा कि ऊपर देखा गया है। परिणामस्वरूप, हमें TestFlight में नवीनतम असेंबली की असेंबली, हस्ताक्षर और तैनाती मिलती है।

हम कलाकृतियां भी प्राप्त करते हैं और इसे असेंबली के साथ सहेजते हैं। कृपया ध्यान दें कि प्रारूप .ipa एक हस्ताक्षरित एआरएम निष्पादन योग्य है जो सिम्युलेटर में नहीं चलता है। यदि आप सिम्युलेटर के लिए आउटपुट चाहते हैं, तो बस उस बिल्ड लक्ष्य को जोड़ें जो इसे उत्पन्न करता है, और फिर इसे आर्टिफैक्ट पथ में शामिल करें।

अन्य पर्यावरण चर

यहां कुछ पर्यावरण चर हैं जो सब कुछ काम करते हैं।

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

फास्टलेन के लिए प्रमाणीकरण को ऐप स्टोर में प्रमाणित करना और टेस्टफ्लाइट पर अपलोड करना आवश्यक है। ऐसा करने के लिए, एप्लिकेशन के लिए एक पासवर्ड बनाएं जिसका उपयोग सीआई में किया जाएगा। विवरण यहां.

यदि आपके पास दो-कारक प्रमाणीकरण है, तो एक वेरिएबल बनाएं FASTLANE_SESSION (वहां निर्देश)।

FASTLANE_USER и FASTLANE_PASSWORD

कि प्रमाणपत्र और आह अनुरोध पर आरंभीकरण प्रोफ़ाइल और प्रमाणपत्र कहा जाता है, आपको चर सेट करने की आवश्यकता है FASTLANE_USER и FASTLANE_PASSWORD. विवरण यहां. यदि आप किसी भिन्न हस्ताक्षर पद्धति का उपयोग कर रहे हैं तो यह आवश्यक नहीं है।

अंत में

आप देख सकते हैं कि यह सब कैसे काम करता है मेरे सरल उदाहरण में.

मुझे आशा है कि यह मददगार था और आपको GitLab प्रोजेक्ट में iOS बिल्ड के साथ काम करने के लिए प्रेरित किया। यहाँ एक और है सीआई युक्तियाँ फास्टलेन के लिए, बस मामले में। आप शायद उपयोग करना चाहें CI_BUILD_ID (वृद्धिशील निर्माण के लिए) स्वचालित रूप से वृद्धि संस्करण.

फास्टलेन का एक और बढ़िया फीचर है स्वचालित स्क्रीनशॉट ऐप स्टोर के लिए, जिसे सेट अप करना बहुत आसान है।

अपने अनुभव के बारे में हमें टिप्पणियों में बताएं और iOS ऐप डेवलपमेंट के लिए GitLab को बेहतर बनाने के लिए अपने विचार साझा करें।

स्रोत: www.habr.com