मोबाइल CICD अनुभव: धेरै मोबाइल अनुप्रयोगहरूको लागि एक फास्टलेन मानक

म फास्टलेन प्रयोग गरी मोबाइल एपहरूको लागि निरन्तर एकीकरण र डेलिभरीको बारेमा कुरा गर्न चाहन्छु। हामी कसरी सबै मोबाइल अनुप्रयोगहरूमा CI/CD लागू गर्छौं, हामी त्यहाँ कसरी पुग्यौं र अन्तमा के भयो।

उपकरणमा नेटवर्कमा पहिले नै पर्याप्त सामग्री छ, जुन हामीसँग सुरुमा अभाव थियो, त्यसैले म जानाजानी उपकरणलाई विस्तृत रूपमा वर्णन गर्नेछैन, तर हामीसँग त्यसबेला के थियो भनेर मात्र सन्दर्भ गर्नेछु:

• आधिकारिक फास्टलेन दस्तावेज
• अन्य कम्पनीहरूबाट उदाहरणहरू
• हामी फास्टलेन प्रयोग गरेर आईओएस अनुप्रयोगहरूको एसेम्बली स्वचालित गर्छौं

लेख दुई भागहरु मिलेर बनेको छ:

• कम्पनीमा मोबाइल CI/CD को उदयको पृष्ठभूमि
• एन-एप्लिकेशनहरूको लागि CI/CD रोल आउट गर्नको लागि प्राविधिक समाधान

पहिलो भाग पुरानो दिनहरु को लागी अधिक पुरानो सम्झना हो, र दोस्रो एक अनुभव हो जुन तपाईले आफैलाई लागू गर्न सक्नुहुन्छ।

ऐतिहासिक रूपमा यो यसरी भएको छ

वर्ष १ 2015 XNUMX।

हामीले भर्खरै मोबाइल अनुप्रयोगहरू विकास गर्न थाल्यौं, त्यसपछि हामीलाई निरन्तर एकीकरण, DevOps र अन्य फैशनेबल चीजहरूको बारेमा केही थाहा थिएन। प्रत्येक एप्लिकेसन अपडेट विकासकर्ता आफैले आफ्नो मेसिनबाट रोल आउट गरेको थियो। र यदि एन्ड्रोइडको लागि यो एकदम सरल छ - भेला, हस्ताक्षर .apk र यसलाई Google विकासकर्ता कन्सोलमा अपलोड गर्‍यो, त्यसपछि iOS को लागि Xcode मार्फत वितरण उपकरणले हामीलाई ठूलो साँझ छोड्यो - संग्रह डाउनलोड गर्ने प्रयासहरू प्राय: त्रुटिहरूमा समाप्त भयो र हामीले फेरि प्रयास गर्नुपर्‍यो। यो पत्ता लाग्यो कि सबैभन्दा उन्नत विकासकर्ताले महिनामा धेरै पटक कोड लेख्दैन, बरु अनुप्रयोग जारी गर्दछ।

वर्ष १ 2016 XNUMX।

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

$ xcodebuild clean archive -archivePath build/MyApp 
    -scheme MyApp

$ xcodebuild -exportArchive 
                        -exportFormat ipa 
                        -archivePath "build/MyApp.xcarchive" 
                        -exportPath "build/MyApp.ipa" 
                        -exportProvisioningProfile "ProvisioningProfileName"

$ cd /Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/

$ ./altool —upload-app 
-f {abs path to your project}/build/{release scheme}.ipa  
-u "[email protected]" 
-p "PASS_APPLE_ID"

दुर्भाग्यवश, अहिले सम्म हाम्रा विकासकर्ताहरूलाई मात्र थाहा थियो कि यी स्क्रिप्टहरू कसरी काम गर्छन् र किन कुञ्जीहरूको यो अन्तहीन स्ट्याक आवश्यक छ, र जब केहि फेरि बिग्रियो, तिनीहरूले लगहरू विश्लेषण गर्न "भव्य साँझहरू" पाए।

वर्ष १ 2017 XNUMX।

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

यद्यपि, फास्टलेन कोरमा समावेश गरिएका मुख्य उपयोगिताहरू हुन् gym и pilot, हामीले सुरु गर्न सफल भयौं ।

हाम्रो स्क्रिप्ट अलिकति सुधार गरिएको छ।

$ fastlane gym  —-workspace "Example.xcworkspace" 
                --scheme "AppName" 
                —-buildlog_path "/tmp" 
                -—clean

तिनीहरू सुधारिएका छन्, यदि सबै प्यारामिटरहरूका लागि आवश्यक नभएकाले मात्र xcodebuild, तपाईंले संकेत गर्न आवश्यक छ - gym कहाँ र के छ भनेर स्वतन्त्र रूपमा बुझ्नेछ। र थप फाइन-ट्युनिङको लागि, तपाईंले मा जस्तै समान कुञ्जीहरू निर्दिष्ट गर्न सक्नुहुन्छ xcodebuild, कुञ्जीहरूको नामकरण मात्र स्पष्ट छ।

यस पटक, जिम र बिल्ट-इन xcpretty ढाँचाको लागि धन्यवाद, निर्माण लगहरू धेरै पढ्न योग्य भएका छन्। यसले भाँचिएको एसेम्बलीहरू फिक्स गर्नमा समय बचत गर्न थाल्यो, र कहिलेकाहीँ रिलिज टोलीले आफैं पत्ता लगाउन सक्छ।

दुर्भाग्यवश, विधानसभा गति मापन xcodebuild и gym हामीले यो गरेनौं, तर हामी कागजातमा विश्वास गर्नेछौं - 30% गति सम्म।

सबै अनुप्रयोगहरूको लागि एकल प्रक्रिया

वर्ष 2018 र वर्तमान

2018 सम्म, एप्लिकेसनहरू निर्माण र रोल आउट गर्ने प्रक्रिया पूर्ण रूपमा जेनकिन्समा सारियो, विकासकर्ताहरूले आफ्ना मेसिनहरूबाट रिलिज गर्न बन्द गरे, र रिलीज गर्ने टोलीलाई मात्र रिलीज गर्ने अधिकार थियो।

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

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

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

2018 को गर्मीमा, हामीले फेरि एक पटक अझै विकास भइरहेको फास्टलेन तिर हेर्यौं।

कार्य #1: सबै स्क्रिप्ट चरणहरू संक्षेप गर्नुहोस् र तिनीहरूलाई फास्टफाइलमा पुन: लेख्नुहोस्

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

हामीले हामीसँग के छ भनेर हेर्‍यौं र 4 चरणहरू पहिचान गर्यौं जुन हाम्रो CI/CD को वर्णनसँग मिल्छ:

• निर्माण - निर्भरताहरू स्थापना गर्दै, अभिलेख संकलन,
• परीक्षण - चलिरहेको विकासकर्ता एकाइ परीक्षण, कभरेज गणना,
• सोनार - सबै लिन्टरहरू सुरू गर्दछ र सोनारक्यूबमा रिपोर्टहरू पठाउँदछ,
• deploy — अल्फा (TestFlight) मा कलाकृति पठाउँदै।

र यदि तपाईं विवरणहरूमा जानुभएन भने, कार्यहरूमा प्रयोग गरिएका कुञ्जीहरू छोडेर, तपाईंले यो फास्टफाइल पाउनुहुनेछ:

default_platform(:ios)

platform :ios do
  before_all do
    unlock
  end

  desc "Build stage"
  lane :build do
    match
    prepare_build
    gym
  end

  desc "Prepare build stage: carthage and cocoapods"
  lane :prepare_build do
    pathCartfile = ""
    Dir.chdir("..") do
      pathCartfile = File.join(Dir.pwd, "/Cartfile")
    end
    if File.exist?(pathCartfile)
      carthage
    end
    pathPodfile = ""
    Dir.chdir("..") do
      pathPodfile = File.join(Dir.pwd, "/Podfile")
    end
    if File.exist?(pathPodfile)
      cocoapods
    end
  end

  desc "Test stage"
  lane :test do
    scan
    xcov
  end

  desc "Sonar stage (after run test!)"
  lane :run_sonar do
    slather
    lizard
    swiftlint
    sonar
  end

  desc "Deploy to testflight stage"
  lane :deploy do
    pilot
  end

  desc "Unlock keychain"
  private_lane :unlock do
    pass = ENV['KEYCHAIN_PASSWORD']
    unlock_keychain(
      password: pass
    )
  end
end

वास्तवमा, हाम्रो पहिलो फास्टफाइल राक्षसी भयो, हामीलाई अझै आवश्यक पर्ने केही बैसाखीहरू र हामीले प्रतिस्थापन गरेका प्यारामिटरहरूको संख्यालाई विचार गर्दै:

lane :build do
carthage(
  command: "update",
  use_binaries: false,
  platform: "ios",
  cache_builds: true)
cocoapods(
  clean: true,
    podfile: "./Podfile",
    use_bundle_exec: false)

gym(
  workspace: "MyApp.xcworkspace",
  configuration: "Release",
  scheme: "MyApp",
  clean: true,
  output_directory: "/build",
  output_name: "my-app.ipa")
end 

lane :deploy do
 pilot(
  username: "[email protected]",
  app_identifier: "com.example.app",
  dev_portal_team_id: "TEAM_ID_NUMBER_DEV",
  team_id: "ITS_TEAM_ID")
end

माथिको उदाहरणमा, हामीले निर्दिष्ट गर्न आवश्यक प्यारामिटरहरूको मात्र अंश: यी निर्माण प्यारामिटरहरू हुन् - स्कीमा, कन्फिगरेसन, प्रावधान प्रोफाइल नामहरू, साथै वितरण प्यारामिटरहरू - विकासकर्ता खाताको एप्पल आईडी, पासवर्ड, अनुप्रयोग आईडी, र यस्तै। मा। पहिलो अनुमानको रूपमा, हामीले यी सबै कुञ्जीहरूलाई विशेष फाइलहरूमा राख्छौं - Gymfile, Matchfile и Appfile.

अब जेन्किन्समा तपाईले छोटो आदेशहरू कल गर्न सक्नुहुन्छ जुन दृश्यलाई धमिलो पार्दैन र आँखाले सजिलै पढ्न सकिन्छ:

# fastlane ios <lane_name>

$ fastlane ios build
$ fastlane ios test
$ fastlane ios run_sonar
$ fastlane ios deploy

हुर्रे, हामी महान छौं

के पाउनुभयो ? प्रत्येक चरणको लागि आदेशहरू खाली गर्नुहोस्। सफा स्क्रिप्टहरू, फास्टलेन फाइलहरूमा राम्ररी व्यवस्थित। रमाईलो गर्दै, हामी विकासकर्ताहरूलाई उनीहरूको भण्डारमा आवश्यक पर्ने सबै कुरा थप्न आग्रह गर्दै दौडियौं।

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

कार्य #2: N अनुप्रयोगहरूको लागि एकल फास्टफाइल प्राप्त गर्नुहोस्

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

फास्टलेनले वातावरणीय चरहरू ह्यान्डल गर्न सक्छ, र हामीले किचेन पासवर्ड सेट गरेर पहिले नै यो प्रयास गरिसकेका छौं:

ENV['KEYCHAIN_PASSWORD']

हाम्रा लिपिहरू हेरेपछि, हामीले साझा भागहरू पहिचान गर्यौं:

#for build, test and deploy
APPLICATION_SCHEME_NAME=appScheme
APPLICATION_PROJECT_NAME=app.xcodeproj
APPLICATION_WORKSPACE_NAME=app.xcworkspace
APPLICATION_NAME=appName

OUTPUT_IPA_NAME=appName.ipa

#app info
APP_BUNDLE_IDENTIFIER=com.example.appName
[email protected]
TEAM_ID=ABCD1234
FASTLANE_ITC_TEAM_ID=123456789

अब, फास्टलेन फाइलहरूमा यी कुञ्जीहरू प्रयोग गर्न सुरु गर्न, हामीले तिनीहरूलाई त्यहाँ कसरी डेलिभर गर्ने भनेर पत्ता लगाउनुपर्छ। फास्टलेनसँग यसको समाधान छ: dotenv मार्फत चर लोड गर्दै। कागजातले भन्छ कि यदि तपाईलाई विभिन्न उद्देश्यका लागि कुञ्जीहरू लोड गर्न महत्त्वपूर्ण छ भने, फास्टलेन डाइरेक्टरीमा धेरै कन्फिगरेसन फाइलहरू सिर्जना गर्नुहोस्। .env, .env.default, .env.development.

र त्यसपछि हामीले यो पुस्तकालयलाई अलि फरक तरिकाले प्रयोग गर्ने निर्णय गर्यौं। फास्टलेन स्क्रिप्टहरू र यसको मेटा जानकारीलाई विकासकर्ताहरूको भण्डारमा होइन, तर फाइलमा यस अनुप्रयोगको अद्वितीय कुञ्जीहरू राखौं। .env.appName.

आफैलाई Fastfile, Appfile, Matchfile и Gymfile, हामीले यसलाई छुट्टै भण्डारमा लुकायौं। अन्य सेवाहरूबाट पासवर्ड कुञ्जीहरू सहितको अतिरिक्त फाइल त्यहाँ लुकेको थियो - .env.
तपाईं एक उदाहरण देख्न सक्नुहुन्छ यहाँ.

CI मा, कल धेरै परिवर्तन भएको छैन; एक विशेष अनुप्रयोगको लागि कन्फिगरेसन कुञ्जी थपिएको छ:

# fastlane ios <lane_name> --env appName

$ fastlane ios build --env appName
$ fastlane ios test --env appName
$ fastlane ios run_sonar --env appName
$ fastlane ios deploy --env appName

आदेशहरू चलाउनु अघि, हामी स्क्रिप्टहरूसँग हाम्रो भण्डार लोड गर्छौं। त्यति राम्रो लाग्दैन:

git clone [email protected]/FastlaneCICD.git fastlane_temp

cp ./fastlane_temp/fastlane/* ./fastlane/
cp ./fastlane_temp/fastlane/.env fastlane/.env

अहिलेको लागि यो समाधान छोड्नुहोस्, यद्यपि फास्टलेनसँग फास्टफाइल मार्फत डाउनलोड गर्ने समाधान छ कार्य import_from_git, तर यसले फास्टफाइलका लागि मात्र काम गर्छ, तर अन्य फाइलहरूको लागि होइन। यदि तपाइँ "साँच्चै सुन्दर" चाहनुहुन्छ भने, तपाइँ आफ्नो लेख्न सक्नुहुन्छ action.

एउटै सेट एन्ड्रोइड अनुप्रयोगहरू र ReactNative को लागि बनाइएको थियो, फाइलहरू एउटै भण्डारमा छन्, तर विभिन्न शाखाहरूमा iOS, android и react_native.

जब रिलीज टोलीले केहि नयाँ चरण थप्न चाहन्छ, स्क्रिप्टमा परिवर्तनहरू MR मार्फत git मा रेकर्ड गरिन्छ, त्यहाँ अब कुनै टुक्रा लिपिहरूको अपराधीहरू खोज्न आवश्यक छैन, र सामान्यतया, अब तपाईंले यसलाई तोड्ने प्रयास गर्नुपर्छ।

अब यो पक्का छ

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

यस्तो देखिन्छ कि एन्ड्रोइड र अनुप्रयोग हस्ताक्षरको लागि फास्टफाइलको बिन्दु अस्पष्ट रहन्छ; यदि लेख रोचक छ भने, म एक निरन्तरता लेख्नेछु। म तपाईका प्रश्नहरू वा सुझावहरू "तपाईंले यो समस्या कसरी समाधान गर्नुहुन्छ" टिप्पणीहरूमा वा टेलिग्राममा देख्न पाउँदा खुसी हुनेछु। bashkirova.

स्रोत: www.habr.com