हम फायरबेस टेस्ट लैब में वाद्य परीक्षण चलाते हैं। भाग 1: आईओएस प्रोजेक्ट

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

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

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

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

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

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

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

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

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

बनाए गए लक्ष्य के बिल्ड चरण अनुभाग पर जाएं और संकलन स्रोतों - अमेजिंगएपयूआईटेस्ट्स.स्विफ्ट में लक्ष्य निर्भरता - अमेजिंगऐप की उपस्थिति की जांच करें।

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

बनाई गई योजना के निर्माण में मुख्य एप्लिकेशन का लक्ष्य शामिल होना चाहिए - अमेजिंगऐप और टारगेट यूआई परीक्षण - अमेजिंगऐपयूआईटेस्ट - स्क्रीनशॉट देखें

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

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

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

टारगेट अमेज़िंगऐपयूआईटेस्ट के लिए हम ऐसा ही करते हैं, लेकिन उत्पाद बंडल पहचानकर्ता कॉलम में हम com.company.amazingappuitests दर्ज करते हैं।

2. Apple डेवलपर प्रोग्राम में एक प्रोजेक्ट सेट करना

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

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

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

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

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

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

$ fastlane init

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

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

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

app_identifier "com.company.amazingapp"       # Bundle ID
apple_dev_portal_id "[email protected]"  # Созданный инфраструктурный аккаунт, имеющий право на редактирование 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("[email protected]") # Your Infrastructure account Apple Developer Portal username

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

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

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

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

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

असेंबलिंग परीक्षणों के लिए लेन जोड़ना बाकी है। के लिए चलते हैं कोष फास्टलेन के लिए एक प्लगइन प्रोजेक्ट जो फायरबेस टेस्ट लैब में निर्यात स्थापित करना और निर्देशों का पालन करना आसान बनाता है।

आइए मूल उदाहरण से कॉपी-पेस्ट करें ताकि हमारी लेन टेस्टिंग_बिल्ड_फॉर_फायरबेस इस तरह दिखे:

 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

सर्कलसीआई में फास्टलेन स्थापित करने के बारे में पूरी जानकारी के लिए, मैं आधिकारिक दस्तावेज पढ़ने की सलाह देता हूं समय два.

हमारे 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

4. हमारी टेस्ट बेंच के बारे में क्या? फायरबेस की स्थापना.

आइए जानें कि लेख किस लिए लिखा गया था।

शायद आपका ऐप मुफ़्त योजना पर फ़ायरबेस का उपयोग करता है, या शायद बिल्कुल भी नहीं। इसमें बिल्कुल कोई बुनियादी अंतर नहीं है, क्योंकि परीक्षण आवश्यकताओं के लिए हम एक वर्ष के निःशुल्क उपयोग के साथ एक अलग परियोजना बना सकते हैं (अच्छा, ठीक है?)

हम अपने इन्फ्रास्ट्रक्चर खाते (या किसी अन्य, इससे कोई फर्क नहीं पड़ता) में लॉग इन करते हैं, और जाते हैं फायरबेस कंसोल पेज. अमेज़िंगऐपयूआईटेस्ट्स नाम से एक नया प्रोजेक्ट बनाएं।

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

डिफ़ॉल्ट सेटिंग्स हमारे लिए काफी उपयुक्त हैं।

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

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

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

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

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

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

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

5. सर्किलसीआई की स्थापना

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

और निम्नलिखित वेरिएबल सेट करें:

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

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

परिणाम

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

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

स्रोत: www.habr.com