फायरबेस टेस्ट लैब में इंस्ट्रूमेंटल टेस्ट चलाएं। भाग 1: आईओएस परियोजना

मेरा नाम दिमित्री है, मैं एमईएल विज्ञान में एक परीक्षक के रूप में काम करता हूं। हाल ही में, मैंने फायरबेस टेस्ट लैब से अपेक्षाकृत नए फीचर से निपटने का काम खत्म किया - अर्थात्, मूल XCUITest परीक्षण ढांचे का उपयोग करते हुए iOS अनुप्रयोगों के इंस्ट्रूमेंटल परीक्षण के साथ।

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

इसलिए, यदि आपके पास एक आईओएस परियोजना पर यूआई परीक्षण हैं, तो आज आप उन्हें गुड कॉर्पोरेशन द्वारा प्रदान किए जाने वाले वास्तविक उपकरणों पर चलाने की कोशिश कर सकते हैं। रुचि - बिल्ली में आपका स्वागत है।

कहानी में, मैंने कुछ स्रोत डेटा पर निर्माण करने का फैसला किया है - गिटहब और सर्किलसी बिल्ड सिस्टम पर एक निजी भंडार। एप्लिकेशन का नाम है अमेजनऐप, बंडलएड है। com.company.amazingapp। मैं तुरंत बाद के भ्रम को कम करने के लिए इस डेटा का हवाला देता हूं।

यदि आपने अपनी परियोजना में अलग-अलग समाधान कार्यान्वित किए हैं - टिप्पणियों में अपना अनुभव साझा करें।

1. परीक्षण स्वयं

UI परीक्षणों के लिए एक नई परियोजना शाखा बनाएँ:

$ git checkout develop $ git pull $ git checkout -b “feature/add-ui-tests” 

Xcode में प्रोजेक्ट खोलें और UI परीक्षणों [XCode -> फ़ाइल -> नया -> लक्ष्य -> ​​iOS परीक्षण बंडल] के साथ एक नया लक्ष्य बनाएं, इसे टॉकिंग नाम AmazingAppUITests दें।



निर्मित लक्ष्य के बिल्ड चरणों में जाएं और संकलित स्रोतों में टारगेट डिपेंडेंसी - अमेजन एप की उपस्थिति के लिए जांच करें - AmazingAppUITests.swift।

विभिन्न विधानसभा विकल्पों को अलग-अलग योजनाओं में अलग करना अच्छा है। हम अपने UI परीक्षणों [XCode -> उत्पाद -> योजना -> नई योजना] के लिए एक योजना बनाते हैं और इसे एक ही नाम देते हैं: AmazingAppUITests।

निर्मित योजना में मुख्य एप्लिकेशन का लक्ष्य शामिल होना चाहिए - AmazingApp और लक्ष्य UI परीक्षण - AmazingAppUITests - स्क्रीनशॉट देखें



अगला, UI परीक्षणों के लिए एक नया बिल्ड कॉन्फ़िगरेशन बनाएं। Xcode में, प्रोजेक्ट फ़ाइल पर क्लिक करें, जानकारी अनुभाग पर जाएँ। "+" पर क्लिक करें और एक नया विन्यास बनाएं, उदाहरण के लिए XCtest। कोड साइनिंग की बात आती है तो हमें भविष्य में डांस करने से बचने के लिए इसकी आवश्यकता होगी।



आपकी परियोजना में कम से कम तीन लक्ष्य हैं: मुख्य अनुप्रयोग, इकाई परीक्षण (क्योंकि वे सही हैं?) और लक्षित यूआई परीक्षण हमने बनाए।

टारगेट अमेज़ॅन पर जाएं, सेटिंग्स टैब बनाएं, कोड साइनिंग आइडेंटिटी सेक्शन। XCtest को कॉन्फ़िगर करने के लिए, iOS डेवलपर का चयन करें। कोड साइनिंग स्टाइल अनुभाग में, मैनुअल का चयन करें। हमने अभी तक प्रोविज़निंग प्रोफ़ाइल नहीं बनाई है, लेकिन थोड़ी देर बाद हम निश्चित रूप से इसमें वापस आएंगे।

लक्ष्य AmazingAppUITests के लिए हम ऐसा ही करते हैं, लेकिन कॉलम उत्पाद बंडल आइडेंटिफ़ायर में हम com.company.amazingappuitests दर्ज करते हैं।

2. Apple डेवलपर कार्यक्रम में एक परियोजना की स्थापना

हम Apple डेवलपर प्रोग्राम पृष्ठ पर जाते हैं, प्रमाणपत्र, पहचानकर्ता और प्रोफ़ाइल अनुभाग पर और फिर पहचानकर्ता आइटम के ऐप आईडी कॉलम पर जाते हैं। एक नया ऐप आईडी बनाएं जिसका नाम AmazingAppUITests और bundleID com.company.amazingappuitests है।



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



हमने इस बिंदु पर developer.apple.com के साथ काम करना समाप्त कर दिया है, लेकिन हमने ब्राउज़र विंडो को कम से कम नहीं किया है। हम फास्टलेन पर प्रलेखन के साथ साइट पर जाते हैं और कवर से कवर तक मैच की उपयोगिता के बारे में पढ़ते हैं।

एक चौकस पाठक ने देखा कि इस उपयोगिता का उपयोग करने के लिए हमें एक निजी रिपॉजिटरी और एक खाते की आवश्यकता होगी, जिसकी पहुंच Apple डेवलपर प्रोग्राम और जीथब दोनों तक हो। हम बनाते हैं (यदि अचानक यह नहीं है) InfrastructureAccount@your.company.domain फॉर्म का एक खाता, एक शक्तिशाली पासवर्ड के साथ आते हैं, इसे developer.apple.com में पंजीकृत करें, और इसे प्रोजेक्ट प्रशासक के रूप में नियुक्त करें। इसके बाद, अपने खाते को अपनी कंपनी के गिथब रिपॉजिटरी तक पहुंच दें और एक नया निजी भंडार बनाएं जिसका नाम है अमेजन एपैच।

3. फास्टलेन और मैच उपयोगिता का विन्यास

टर्मिनल खोलें, प्रोजेक्ट फ़ोल्डर में जाएं और आधिकारिक मैनुअल में संकेत के अनुसार फास्टलेन को प्रारंभ करें। कमांड डालने के बाद

 $ fastlane init 

आपको उपलब्ध उपयोग कॉन्फ़िगरेशन चुनने के लिए प्रेरित किया जाएगा। हम चौथे आइटम का चयन करते हैं - मैनुअल प्रोजेक्ट सेटअप।



एक नई फास्टलेन निर्देशिका परियोजना में दिखाई दी है, जिसमें दो फाइलें हैं - एपफाइल और फास्टफाइल। संक्षेप में - Appfile में हम सेवा डेटा संग्रहीत करते हैं, और Fastfile में हम जॉब लिखते हैं, Fastlane शब्दावली में गलियों को कहते हैं। मैं आधिकारिक दस्तावेज पढ़ने की सलाह देता हूं: एक , दो ।

अपने पसंदीदा पाठ संपादक में Appfile खोलें और इसे निम्न रूप में लाएँ:

 app_identifier "com.company.amazingapp" # Bundle ID apple_dev_portal_id "infrastructureaccount@your.company.domain" #   ,     iOS   Apple Developer Program. team_id "LSDY3IFJAY9" # Your Developer Portal Team ID 

हम टर्मिनल पर लौटते हैं और आधिकारिक मैनुअल के अनुसार हम मैच को कॉन्फ़िगर करना शुरू करते हैं।

 $ fastlane match init $ fastlane match development 

अगला, अनुरोधित डेटा दर्ज करें - रिपॉजिटरी, खाता, पासवर्ड, आदि।

महत्वपूर्ण: जब आप पहली बार मैच उपयोगिता शुरू करते हैं, तो आपको रिपॉजिटरी को डिक्रिप्ट करने के लिए एक पासवर्ड दर्ज करने के लिए कहा जाएगा। यह पासवर्ड रखना बहुत महत्वपूर्ण है, सीआई सर्वर की स्थापना के चरण में यह हमारे लिए उपयोगी होगा!

फास्टलेन फ़ोल्डर में एक नई फ़ाइल दिखाई दी - माचिसाइल। अपने पसंदीदा टेक्स्ट एडिटर में खोलें और फॉर्म में लाएं:

 git_url("https://github.com/YourCompany/AmazingAppMatch") #       . type("development") # The default type, can be: appstore, adhoc, enterprise or development app_identifier("com.company.amazingapp") username("infrastructureaccount@your.company.domain") # Your Infrastructure account Apple Developer Portal username 

हम इसे इस तरह से भरते हैं यदि हम Crashlytics और / या AppStore में पोस्टिंग के लिए साइन टू बिल्ड बिल्ड का उपयोग करना चाहते हैं, अर्थात अपने आवेदन की बंडल आईडी पर हस्ताक्षर करने के लिए।

लेकिन, जैसा कि हम याद करते हैं, टेस्ट बिल्ड बनाने के लिए हमने एक विशेष वाइल्डकार्ड आईडी बनाई। इसलिए, Fastfile खोलें और एक नई लेन डालें:

 lane :testing_build_for_firebase do match( type: "development", readonly: true, app_identifier: "com.company.*", git_branch: "uitests" #     development     . ) end 

सहेजें, टर्मिनल में दर्ज करें

 fastlane testing_build_for_firebase 

और देखें कि फास्टलेन ने एक नया प्रमाणपत्र कैसे बनाया और उसे रिपॉजिटरी में डाल दिया। बहुत बढ़िया!

Xcode खोलें। अब हमारे पास मैच डेवलपमेंट com.company की आवश्यक प्रोविज़निंग प्रोफाइल है। * टाइप करें, जिसे AmazingApp और AmazingAppUITests लक्ष्यों के लिए प्रोविज़निंग प्रोफ़ाइल अनुभाग में निर्दिष्ट किया जाना चाहिए।



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

मूल उदाहरण से कॉपी करें ताकि हमारा लेन टेस्टिंग_बिल्डर /for_firebase अंततः इस तरह दिखे:

 lane :testing_build_for_firebase do match( type: "development", readonly: true, app_identifier: "com.company.*", git_branch: "uitests" ) scan( scheme: 'AmazingAppUITests', # UI Test scheme clean: true, # Recommended: This would ensure the build would not include unnecessary files skip_detect_devices: true, # Required build_for_testing: true, # Required sdk: 'iphoneos', # Required should_zip_build_products: true, # Must be true to set the correct format for Firebase Test Lab ) firebase_test_lab_ios_xctest( gcp_project: 'AmazingAppUITests', # Your Google Cloud project name (    ) devices: [ # Device(s) to run tests on { ios_model_id: 'iphonex', # Device model ID, see gcloud command above ios_version_id: '12.0', # iOS version ID, see gcloud command above locale: 'en_US', # Optional: default to en_US if not set orientation: 'portrait' # Optional: default to portrait if not set } ] ) end 

CircleCI में फास्टलेन को कॉन्फ़िगर करने की पूरी जानकारी के लिए, मैं आधिकारिक दस्तावेज एक, दो को पढ़ने की सलाह देता हूं।

एक नए कार्य के साथ हमारे config.yml को जोड़ना न भूलें:

 build-for-firebase-test-lab: macos: xcode: "10.1.0" working_directory: ~/project shell: /bin/bash --login -o pipefail steps: - checkout - attach_workspace: at: ~/project - run: sudo bundle install #   - run: name: install gcloud-sdk #  mac    gcloud command: | ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null ; brew install caskroom/cask/brew-cask 2> /dev/null brew cask install google-cloud-sdk - run: name: build app for testing command: fastlane testing_build_for_firebase #  lane     firebase प्रयोगशाला: build-for-firebase-test-lab: macos: xcode: "10.1.0" working_directory: ~/project shell: /bin/bash --login -o pipefail steps: - checkout - attach_workspace: at: ~/project - run: sudo bundle install #   - run: name: install gcloud-sdk #  mac    gcloud command: | ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null ; brew install caskroom/cask/brew-cask 2> /dev/null brew cask install google-cloud-sdk - run: name: build app for testing command: fastlane testing_build_for_firebase #  lane     firebase 

4. लेकिन हमारी टेस्ट बेंच का क्या? फायरबेस को कॉन्फ़िगर करें।

हम आगे बढ़ते हैं, वास्तव में, किस लेख के लिए लिखा गया था।

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

हमारे बुनियादी ढांचे के खाते (या किसी अन्य, कोई अंतर नहीं) में प्रवेश करें, और फायरबेस कंसोल पृष्ठ पर जाएं । एक नया प्रोजेक्ट बनाएं जिसका नाम है AmazingAppUITests।

महत्वपूर्ण: लेन फायरबेज में फास्टफाइल में पिछले चरण में_स्टेस्ट_लैब_ओस_एक्सक्टेस्ट, gcp_project पैरामीटर को प्रोजेक्ट के नाम से मेल खाना चाहिए।



डिफ़ॉल्ट सेटिंग्स हमारे साथ काफी ठीक हैं।

हम टैब को बंद नहीं करते हैं, उसी खाते के तहत जिसे हम गॉलकॉड में पंजीकृत करते हैं - यह एक आवश्यक उपाय है, क्योंकि फायरबेस के साथ संचार गक्लाउड कंसोल इंटरफ़ेस का उपयोग करके होता है।

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

आइए फायरबेस परियोजना के साथ टैब पर वापस जाएं और इसे ब्लेज़ टैरिफ प्लान में स्थानांतरित करें - अब हमारे पास सीमा पार होने की स्थिति में भुगतान करने के लिए कुछ है।

Gcloud इंटरफ़ेस में, हमारे फायरबेस प्रोजेक्ट का चयन करें, "कैटलॉग" मुख्य मेनू आइटम का चयन करें और क्लाउड परीक्षण एपीआई और क्लाउड उपकरण परिणाम एपीआई जोड़ें।



फिर मेनू आइटम "आईएएम और प्रशासन" पर जाएं -> सेवा खाते -> एक सेवा खाता बनाएं। हम परियोजना को संपादित करने का अधिकार देते हैं।



JSON प्रारूप में एक एपीआई कुंजी बनाएँ



हमें थोड़ी देर बाद डाउनलोड किए गए JSON की आवश्यकता होगी, लेकिन अभी के लिए, हम परीक्षण लैब सेटअप को समाप्त करने पर विचार करेंगे।

5. CircleCI कॉन्फ़िगर करें

एक उचित सवाल चल रहा है - पासवर्ड के साथ क्या करना है? विश्वसनीय रूप से हमारे पासवर्ड और अन्य संवेदनशील डेटा को बचाने से हमें हमारे निर्माण-मशीन के पर्यावरण चर के तंत्र में मदद मिलेगी। CircleCI परियोजना की सेटिंग में, पर्यावरण चर का चयन करें


और निम्नलिखित चर शुरू करें:

• कुंजी: GOOGLE_APPLICATION_CREDENTIALS
  मान: gcloud सेवा खाता कुंजी फ़ाइल json
• कुंजी: MATCH_PASSWORD
  मूल्य: प्रमाणपत्रों के साथ जीथब रिपॉजिटरी को डिक्रिप्ट करने के लिए पासवर्ड
• कुंजी: FASTLANE_PASSWORD
  मूल्य: Apple डेवलपर पोर्टल इन्फ्रास्ट्रक्चर अकाउंट पासवर्ड

हम परिवर्तनों को सहेजते हैं, एक पीआर बनाते हैं और इसे हमारी टीम लीड के लिए समीक्षा के लिए भेजते हैं।

परिणाम

इन सरल जोड़तोड़ों को करने के परिणामस्वरूप, हमें परीक्षण के समय डिवाइस की स्क्रीन पर वीडियो रिकॉर्ड करने की क्षमता के साथ एक अच्छा, स्थिर कामकाजी स्टैंड मिला। एक परीक्षण के मामले में, मैंने एक iPhone X डिवाइस मॉडल निर्दिष्ट किया, लेकिन फ़ार्म iOS के विभिन्न मॉडलों और संस्करणों के संयोजन का एक विस्तृत चयन प्रदान करता है।

दूसरा भाग एंड्रॉइड प्रोजेक्ट के लिए फायरबेस टेस्ट लैब के चरण-दर-चरण कॉन्फ़िगरेशन के लिए समर्पित होगा।