GitLab र fastlane को साथ एप स्टोरमा iOS अनुप्रयोगहरू प्रकाशित गर्दै

फास्टलेनको साथ GitLab ले कसरी एप स्टोरमा iOS एपहरू सङ्कलन, सङ्केत र प्रकाशित गर्छ।

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

यहाँ हामी लिन्छौं स्विफ्टमा सरल iOS एपजससँग मैले भिडियो रेकर्ड गरेको छु ।

एप्पल स्टोर कन्फिगरेसन बारे केही शब्दहरू

हामीलाई एक एप स्टोर एप, वितरण प्रमाणपत्रहरू, र सबै कुरालाई एकसाथ जोड्नको लागि प्रावधान प्रोफाइल चाहिन्छ।

यहाँ सबैभन्दा गाह्रो कुरा एप स्टोरमा हस्ताक्षर गर्ने अधिकारहरू सेटअप गर्नु हो। म आशा गर्छु कि तपाईंले यो आफैलाई पत्ता लगाउन सक्नुहुन्छ। यदि तपाईं नयाँ हुनुहुन्छ भने, म तपाईंलाई सही दिशामा देखाउनेछु, तर हामी यहाँ Apple प्रमाणपत्रहरू प्रबन्ध गर्ने जटिलताहरूको बारेमा कुरा गर्दैनौं, र तिनीहरू निरन्तर परिवर्तन भइरहेका छन्। यो पोस्टले तपाईंलाई सुरु गर्न मद्दत गर्नेछ।

मेरा एपहरू

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

प्रारम्भिक प्रोफाइल

एप सेटअपको अतिरिक्त, तपाईंलाई एप्पल विकासकर्ता कन्सोलको प्रमाणपत्र, पहिचानकर्ता र प्रोफाइल खण्डमा सिर्जना गरिएको iOS वितरण र विकास कुञ्जीहरू चाहिन्छ। यी सबै प्रमाणपत्रहरूलाई प्रावधान प्रोफाइलमा जोड्न सकिन्छ।

प्रमाणीकरण गरिने प्रयोगकर्ताहरूले प्रमाणपत्रहरू सिर्जना गर्न सक्षम हुन आवश्यक छ, अन्यथा चरणहरू प्रमाणपत्र र सास तपाईले त्रुटि देख्नुहुनेछ।

अन्य विकल्प

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

यस उदाहरणमा म दृष्टिकोण प्रयोग गर्दैछु प्रमाणपत्र र सास, तर वास्तविक प्रयोगको लागि यो सम्भवतः राम्रो उपयुक्त छ म्याच.

GitLab र फास्टलेन तयारी गर्दै

CI धावक तयारी गर्दै

यो सबै डाटा सङ्कलन गरिसकेपछि, हामी MacOS उपकरणमा GitLab धावकको कन्फिगरेसनमा जान्छौं। दुर्भाग्यवश, तपाईं MacOS मा iOS एपहरू मात्र बनाउन सक्नुहुन्छ। तर सबै कुरा परिवर्तन हुन सक्छ, र यदि तपाइँ यस क्षेत्रमा प्रगतिको आशा गर्नुहुन्छ भने, जस्तै परियोजनाहरूमा नजर राख्नुहोस् xcbuild и चिन्हर हाम्रो आन्तरिक कार्य gitlab-ce#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

Xcode लाई निर्माण गर्न आवश्यक पर्ने कुञ्जीहरूमा पहुँच सहित Apple Keychain लाई यो होस्टमा कन्फिगर गरिएको हुनुपर्छ। यसलाई परीक्षण गर्ने सबैभन्दा सजिलो तरिका भनेको निर्माण चलाउने प्रयोगकर्ताको रूपमा लग इन गर्नु र यसलाई म्यानुअल रूपमा निर्माण गर्ने प्रयास गर्नु हो। यदि प्रणालीले किचेन पहुँचको लागि सोध्छ भने, CI लाई काम गर्न सधैं अनुमति दिनुहोस् चयन गर्नुहोस्। तिनीहरूले अब किचेनको लागि सोध्दैनन् भनी सुनिश्चित गर्नका लागि पाइपलाइनहरूको पहिलो जोडी हेर्न र हेर्न लायक हुन सक्छ। समस्या यो हो कि Apple ले हामीलाई अटो मोड प्रयोग गर्न सजिलो बनाउँदैन, तर एकचोटि तपाईंले यसलाई चलाउनु भयो, सबै कुरा ठीक हुनेछ।

फास्टलेन init

परियोजनामा ​​फास्टलेन प्रयोग गर्न, चलाउनुहोस् fastlane init। मात्र पछ्याउनुहोस् फास्टलेन स्थापना र चलाउनका लागि निर्देशनहरू, विशेष गरी को बारे मा खण्ड मा Gemfile, किनभने हामीलाई स्वचालित CI पाइपलाइन मार्फत छिटो र अनुमानित प्रक्षेपण चाहिन्छ।

तपाईंको परियोजना डाइरेक्टरीमा, यी आदेशहरू चलाउनुहोस्:

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 निर्माण चरणहरू परिभाषित गर्दछ। हामीले धेरै फास्टलेनका बिल्ट-इन सुविधाहरू प्रयोग गर्छौं, त्यसैले यहाँ पनि सबै कुरा स्पष्ट छ। हामी एउटा लाइन सिर्जना गर्छौं जसले प्रमाणपत्रहरू प्राप्त गर्छ, एसेम्बली गर्छ र TestFlight मा अपलोड गर्छ। यदि आवश्यक भएमा तपाईले यस प्रक्रियालाई विभिन्न कार्यहरूमा विभाजन गर्न सक्नुहुन्छ। यी सबै कार्यहरू (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

यो एक वैकल्पिक फाइल हो, तर मैले यसलाई म्यानुअल रूपमा पूर्वनिर्धारित आउटपुट डाइरेक्टरी परिवर्तन गर्न र हालको फोल्डरमा आउटपुट राख्नको लागि सिर्जना गरेको छु। यसले CI लाई सरल बनाउँछ। यदि रुचि छ भने, बारे पढ्नुहोस् 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

फास्टलेनको लागि प्रमाणीकरण एप स्टोरमा प्रमाणीकरण गर्न र TestFlight मा अपलोड गर्न आवश्यक छ। यो गर्नका लागि, CI मा प्रयोग गरिने अनुप्रयोगको लागि पासवर्ड सिर्जना गर्नुहोस्। विवरणहरू यहाँ.

यदि तपाइँसँग दुई-कारक प्रमाणीकरण छ भने, एउटा चर सिर्जना गर्नुहोस् FASTLANE_SESSION (त्यहाँ निर्देशनहरू)।

FASTLANE_USER и FASTLANE_PASSWORD

कि प्रमाणपत्र र सास अनुरोधमा प्रारम्भिक प्रोफाइल र प्रमाणपत्रहरू भनिन्छ, तपाईंले चरहरू सेट गर्न आवश्यक छ FASTLANE_USER и FASTLANE_PASSWORD। विवरणहरू यहाँ। यदि तपाइँ फरक हस्ताक्षर विधि प्रयोग गर्दै हुनुहुन्छ भने यो आवश्यक छैन।

निष्कर्षमा

तपाईंले यो सबै काम कसरी देख्न सक्नुहुन्छ मेरो सरल उदाहरणमा.

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

फास्टलेनको अर्को राम्रो विशेषता हो स्वचालित स्क्रिनसटहरू एप स्टोरको लागि, जुन सेटअप गर्न धेरै सजिलो छ।

हामीलाई तपाईंको अनुभवको बारेमा टिप्पणीहरूमा भन्नुहोस् र iOS एप विकासको लागि GitLab सुधार गर्नका लागि आफ्ना विचारहरू साझा गर्नुहोस्।

स्रोत: www.habr.com