मोबाइल सीआईसीडी अनुभव: कई मोबाइल अनुप्रयोगों के लिए एक फास्टलेन मानक

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

टूल पर नेटवर्क पर पहले से ही पर्याप्त सामग्री मौजूद है, जिसकी शुरुआत में हमारे पास बहुत कमी थी, इसलिए मैं जानबूझकर टूल का विस्तार से वर्णन नहीं करूंगा, लेकिन केवल वही संदर्भित करूंगा जो हमारे पास तब था:

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

लेख में दो भाग हैं:

• कंपनी में मोबाइल सीआई/सीडी के उद्भव की पृष्ठभूमि
• एन-अनुप्रयोगों के लिए सीआई/सीडी शुरू करने के लिए तकनीकी समाधान

पहला भाग पुराने दिनों के लिए अधिक पुरानी यादों का है, और दूसरा एक ऐसा अनुभव है जिसे आप स्वयं पर लागू कर सकते हैं।

ऐतिहासिक रूप से ऐसा ही हुआ

वर्ष 2015

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

वर्ष 2016

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

$ 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

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

हालाँकि, फास्टलेन कोर में शामिल मुख्य उपयोगिताएँ हैं 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 चरणों की पहचान की जो हमारे सीआई/सीडी के विवरण में फिट बैठते हैं:

• निर्माण - निर्भरताएँ स्थापित करना, संग्रह को असेंबल करना,
• परीक्षण - डेवलपर इकाई परीक्षण चलाना, कवरेज की गणना करना,
• सोनार - सभी लिंटर लॉन्च करता है और सोनारक्यूब को रिपोर्ट भेजता है,
• परिनियोजन - अल्फा (टेस्टफ्लाइट) पर एक आर्टिफैक्ट भेजना।

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

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: एन अनुप्रयोगों के लिए एकल फास्टफ़ाइल प्राप्त करें

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

फास्टलेन पर्यावरण चर को संभाल सकता है, और हमने पहले ही किचेन पासवर्ड सेट करके यह कोशिश की है:

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.
आप एक उदाहरण देख सकते हैं यहां.

सीआई पर, कॉल में ज्यादा बदलाव नहीं हुआ है; एक विशिष्ट एप्लिकेशन के लिए एक कॉन्फ़िगरेशन कुंजी जोड़ी गई है:

# 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.

Android एप्लिकेशन और ReactNative के लिए एक समान सेट बनाया गया था, फ़ाइलें एक ही रिपॉजिटरी में हैं, लेकिन विभिन्न शाखाओं में हैं iOS, android и react_native.

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

अब इतना तो पक्का है

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

ऐसा लगता है कि एंड्रॉइड के लिए फास्टफाइल और एप्लिकेशन हस्ताक्षर के साथ बिंदु अस्पष्ट बना हुआ है, यदि लेख दिलचस्प है, तो मैं एक निरंतरता लिखूंगा; मुझे आपके प्रश्न या सुझाव "आप इस समस्या का समाधान कैसे करेंगे" टिप्पणियों में या टेलीग्राम पर देखकर खुशी होगी बश्किरोवा.

स्रोत: www.habr.com