आम्ही फायरबेस टेस्ट लॅबमध्ये इंस्ट्रुमेंटल चाचण्या चालवतो. भाग 1: iOS प्रकल्प

माझे नाव दिमित्री आहे, मी कंपनीत परीक्षक म्हणून काम करतो एमईएल विज्ञान. अगदी अलीकडे मी कडून तुलनेने अलीकडील वैशिष्ट्य हाताळणे पूर्ण केले फायरबेस चाचणी प्रयोगशाळा — म्हणजे, मूळ चाचणी फ्रेमवर्क XCUITest वापरून iOS ऍप्लिकेशन्सच्या वाद्य चाचणीसह.

याआधी, मी अँड्रॉइडसाठी फायरबेस टेस्ट लॅब वापरून पाहिली होती आणि मला सर्व काही आवडले, म्हणून मी प्रोजेक्टची iOS चाचणी इन्फ्रास्ट्रक्चर त्याच पायावर ठेवण्याचा प्रयत्न करण्याचा निर्णय घेतला. मला खूप Google करावे लागले आणि सर्व काही प्रथमच कार्यान्वित झाले नाही, म्हणून मी अजूनही संघर्ष करत असलेल्यांसाठी एक ट्यूटोरियल लेख लिहिण्याचे ठरवले.

त्यामुळे, जर तुमच्याकडे iOS प्रोजेक्टवर UI चाचण्या असतील, तर तुम्ही त्या आजच खर्‍या उपकरणांवर चालवण्याचा प्रयत्न करू शकता, कृपया गुड कॉर्पोरेशनने प्रदान केले आहे. स्वारस्य असलेल्यांसाठी, मांजरीमध्ये आपले स्वागत आहे.

कथेमध्ये, मी काही प्रारंभिक डेटावर तयार करण्याचा निर्णय घेतला - GitHub आणि CircleCI बिल्ड सिस्टमवरील खाजगी भांडार. अर्जाचे नाव AmazingApp आहे, bundleID आहे com.company.amazingapp. त्यानंतरचा गोंधळ कमी करण्यासाठी मी हा डेटा त्वरित सादर करतो.

तुम्ही तुमच्या प्रोजेक्टमध्ये काही उपाय वेगळ्या पद्धतीने अंमलात आणल्यास, तुमचा अनुभव टिप्पण्यांमध्ये शेअर करा.

1. चाचण्या स्वतः

UI चाचण्यांसाठी नवीन प्रकल्प शाखा तयार करा:

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

चला XCode मध्ये प्रकल्प उघडू आणि UI चाचण्यांसह एक नवीन लक्ष्य तयार करू [XCode -> फाइल -> नवीन -> लक्ष्य -> ​​iOS चाचणी बंडल], त्याला AmazingAppUITests हे स्वयं-स्पष्टीकरणात्मक नाव देऊन.

तयार केलेल्या टार्गेटच्या बिल्ड फेज विभागात जा आणि टार्गेट डिपेंडेन्सीज - AmazingApp, कंपाइल सोर्सेस - AmazingAppUITests.swift मध्ये तपासा.

एक चांगला सराव म्हणजे विविध बिल्ड पर्यायांना वेगळ्या योजनांमध्ये वेगळे करणे. आम्ही आमच्या UI चाचण्यांसाठी एक योजना तयार करतो [XCode -> उत्पादन -> योजना -> नवीन योजना] आणि तिला तेच नाव देतो: AmazingAppUITests.

तयार केलेल्या योजनेच्या बिल्डमध्ये मुख्य अनुप्रयोगाचे लक्ष्य समाविष्ट असणे आवश्यक आहे - AmazingApp आणि Target UI चाचण्या - AmazingAppUITests - स्क्रीनशॉट पहा

पुढे, आम्ही UI चाचण्यांसाठी नवीन बिल्ड कॉन्फिगरेशन तयार करतो. XCode मध्ये, प्रोजेक्ट फाइलवर क्लिक करा आणि माहिती विभागात जा. “+” वर क्लिक करा आणि नवीन कॉन्फिगरेशन तयार करा, उदाहरणार्थ XCtest. जेव्हा कोड साइनिंगचा प्रश्न येतो तेव्हा डफ वाजवून नाचू नये म्हणून आम्हाला भविष्यात याची आवश्यकता असेल.

तुमच्या प्रकल्पामध्ये किमान तीन लक्ष्ये आहेत: मुख्य अनुप्रयोग, युनिट चाचण्या (शेवटी, त्या अस्तित्वात आहेत, बरोबर?) आणि आम्ही तयार केलेल्या लक्ष्य UI चाचण्या.

Target AmazingApp, Build Settings tab, Code Signing Identity विभागात जा. XCtest कॉन्फिगरेशनसाठी, iOS विकसक निवडा. कोड साइनिंग शैली विभागात, मॅन्युअल निवडा. आम्ही अजून प्रोव्हिजनिंग प्रोफाईल व्युत्पन्न केलेले नाही, परंतु आम्ही निश्चितपणे त्यावर थोड्या वेळाने परत येऊ.

Target AmazingAppUITests साठी आम्ही तेच करतो, परंतु उत्पादन बंडल आयडेंटिफायर कॉलममध्ये आम्ही com.company.amazingappuitest प्रविष्ट करतो.

2. ऍपल डेव्हलपर प्रोग्राममध्ये प्रोजेक्ट सेट करणे

ऍपल डेव्हलपर प्रोग्राम पृष्ठावर जा, प्रमाणपत्रे, आयडेंटिफायर्स आणि प्रोफाइल विभागात जा आणि नंतर आयडेंटिफायर्स आयटमच्या अॅप आयडी कॉलमवर जा. AmazingAppUITests आणि bundleID com.company.amazingappuitest नावाचा नवीन अॅप आयडी तयार करा.

आता आमच्याकडे वेगळ्या प्रमाणपत्रासह आमच्या चाचण्यांवर स्वाक्षरी करण्याची संधी आहे, परंतु... चाचणीसाठी बिल्ड असेंबल करण्याच्या प्रक्रियेमध्ये अॅप्लिकेशन स्वतः एकत्र करणे आणि चाचणी रनर असेंबल करणे समाविष्ट आहे. त्यानुसार, एका प्रोव्हिजनिंग प्रोफाईलसह दोन बंडल आयडीवर स्वाक्षरी करण्याची समस्या आम्हाला भेडसावत आहे. सुदैवाने, एक सोपा आणि मोहक उपाय आहे - वाइल्डकार्ड अॅप आयडी. आम्ही नवीन अॅप आयडी तयार करण्याच्या प्रक्रियेची पुनरावृत्ती करतो, परंतु स्पष्ट अॅप आयडीऐवजी, स्क्रीनशॉटप्रमाणे वाइल्डकार्ड अॅप आयडी निवडा.

या टप्प्यावर, आम्ही developer.apple.com सह कार्य पूर्ण केले आहे, परंतु आम्ही ब्राउझर विंडो कमी करणार नाही. चल जाऊया फास्टलेन दस्तऐवजीकरण साइट आणि कव्हरपासून कव्हरपर्यंत मॅच युटिलिटीबद्दल वाचा.

एका सजग वाचकाच्या लक्षात आले की ही उपयुक्तता वापरण्यासाठी आम्हाला ऍपल डेव्हलपर प्रोग्राम आणि गिथब या दोन्हीमध्ये प्रवेश असलेले खाजगी भांडार आणि खाते आवश्यक आहे. आम्ही फॉर्मचे खाते (अचानक असे काही नसल्यास) तयार करतो [ईमेल संरक्षित], मजबूत पासवर्डसह या, developer.apple.com वर नोंदणी करा आणि प्रकल्प प्रशासक म्हणून नियुक्त करा. पुढे, आम्ही खात्याला तुमच्या कंपनीच्या गिथब भांडारात प्रवेश देतो आणि AmazingAppMatch सारख्या नावाने नवीन खाजगी भांडार तयार करतो.

3. फास्टलेन आणि मॅच युटिलिटी सेट करणे

टर्मिनल उघडा, प्रोजेक्टसह फोल्डरवर जा आणि दर्शविल्याप्रमाणे फास्टलेन सुरू करा अधिकृत मॅन्युअल. आदेश प्रविष्ट केल्यानंतर

$ fastlane init

तुम्हाला उपलब्ध वापर कॉन्फिगरेशन निवडण्यास सांगितले जाईल. चौथा पर्याय निवडा - मॅन्युअल प्रोजेक्ट सेटअप.

प्रोजेक्टमध्ये नवीन निर्देशिका फास्टलेन आहे, ज्यामध्ये दोन फायली आहेत - ऍपफाइल आणि फास्टफाइल. थोडक्यात, आम्ही Appfile मध्ये सेवा डेटा संग्रहित करतो आणि Fastfile मध्ये जॉब्स लिहितो, ज्याला Fastlane शब्दावलीत लेन म्हणतात. मी अधिकृत दस्तऐवज वाचण्याची शिफारस करतो: वेळा, два.

तुमच्या आवडत्या टेक्स्ट एडिटरमध्ये Appfile उघडा आणि खालील फॉर्मवर आणा:

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

पुढे, विनंती केलेला डेटा प्रविष्ट करा - रेपॉजिटरी, खाते, पासवर्ड इ.

हे महत्त्वाचे आहे: जेव्हा तुम्ही पहिल्यांदा मॅच युटिलिटी लाँच करता, तेव्हा तुम्हाला रेपॉजिटरी डिक्रिप्ट करण्यासाठी पासवर्ड एंटर करण्यास सांगितले जाईल. हा पासवर्ड जतन करणे खूप महत्वाचे आहे; CI सर्व्हर सेट करताना आम्हाला याची आवश्यकता असेल!

फास्टलेन फोल्डरमध्ये एक नवीन फाइल आली आहे - मॅचफाईल. ते तुमच्या आवडत्या मजकूर संपादकात उघडा आणि याप्रमाणे प्रदर्शित करा:

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

क्रॅशलाइटिक्स आणि/किंवा AppStore मध्ये प्रदर्शनासाठी बिल्डवर स्वाक्षरी करण्यासाठी, म्हणजेच तुमच्या अर्जाच्या बंडल आयडीवर स्वाक्षरी करण्यासाठी आम्हाला भविष्यात सामना वापरायचा असल्यास आम्ही ते अशा प्रकारे भरतो.

परंतु, आम्हाला आठवते की, आम्ही चाचणी बिल्डवर स्वाक्षरी करण्यासाठी एक विशेष वाइल्डकार्ड आयडी तयार केला आहे. म्हणून, फास्टफाइल उघडा आणि नवीन लेन प्रविष्ट करा:

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 लक्ष्यांसाठी प्रोव्हिजनिंग प्रोफाइल विभागात निर्दिष्ट केले जाणे आवश्यक आहे.

चाचण्या एकत्रित करण्यासाठी लेन जोडणे बाकी आहे. चल जाऊया भांडार फास्टलेनसाठी एक प्लगइन प्रकल्प जो फायरबेस चाचणी लॅबमध्ये निर्यात सेट करणे आणि सूचनांचे अनुसरण करणे सोपे करते.

मूळ उदाहरणावरून कॉपी-पेस्ट करू या जेणेकरून आमचे लेन testing_build_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

4. आमच्या चाचणी खंडपीठाचे काय? फायरबेस सेट करत आहे.

लेख कशासाठी लिहिला ते खाली उतरूया.

कदाचित तुमचा अ‍ॅप मोफत योजनेवर फायरबेस वापरत असेल किंवा अजिबात नाही. यात कोणताही मूलभूत फरक नाही, कारण चाचणी गरजांसाठी आम्ही एक वर्ष विनामूल्य वापरासह स्वतंत्र प्रकल्प तयार करू शकतो (छान, बरोबर?)

आम्ही आमच्या इन्फ्रास्ट्रक्चर खात्यात लॉग इन करतो (किंवा इतर कोणतेही, काही फरक पडत नाही), आणि वर जातो फायरबेस कन्सोल पृष्ठ. AmazingAppUITests नावाचा नवीन प्रकल्प तयार करा.

हे महत्त्वाचे आहे: फास्टफाईल इन लेन फायरबेस_टेस्ट_लॅब_आयओएस_एक्सक्टेस्ट मधील मागील चरणात gcp_project पॅरामीटर प्रकल्पाच्या नावाशी जुळले पाहिजे.

डीफॉल्ट सेटिंग्ज आमच्यासाठी योग्य आहेत.

टॅब बंद करू नका, त्याच खात्याखाली नोंदणी करा GCloud - हे एक आवश्यक उपाय आहे, कारण फायरबेसशी संवाद gcloud कन्सोल इंटरफेस वापरून होतो.

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

चला फायरबेस प्रकल्पासह टॅबवर परत येऊ आणि ते ब्लेझ टॅरिफ प्लॅनमध्ये हस्तांतरित करू - आता मर्यादा ओलांडल्यास आमच्याकडे पैसे भरायचे आहेत.

gcloud इंटरफेसमध्ये, आमचा फायरबेस प्रकल्प निवडा, "निर्देशिका" मुख्य मेनू आयटम निवडा आणि क्लाउड चाचणी API आणि क्लाउड टूल्स परिणाम API जोडा.

नंतर मेनू आयटमवर जा “IAM आणि प्रशासन” -> सेवा खाती -> सेवा खाते तयार करा. आम्ही प्रकल्प संपादित करण्याचे अधिकार देतो.

JSON फॉरमॅटमध्ये API की तयार करा

आम्हाला थोड्या वेळाने डाउनलोड केलेल्या JSON ची आवश्यकता असेल, परंतु आत्ता आम्ही चाचणी लॅब सेटअप पूर्ण करण्याचा विचार करू.

5. CircleCI ची स्थापना करणे

एक वाजवी प्रश्न उद्भवतो - पासवर्डचे काय करावे? आमच्या बिल्ड मशीनची पर्यावरण परिवर्तनीय यंत्रणा आम्हाला आमचे पासवर्ड आणि इतर संवेदनशील डेटा सुरक्षितपणे संग्रहित करण्यात मदत करेल. CircleCI प्रोजेक्ट सेटिंग्जमध्ये, Environment Variables निवडा

आणि खालील व्हेरिएबल्स सेट करा:

• की: GOOGLE_APPLICATION_CREDENTIALS
  मूल्य: gcloud सेवा खाते की च्या json फाइलची सामग्री
• की: MATCH_PASSWORD
  मूल्य: प्रमाणपत्रांसह गिथब रेपॉजिटरी डिक्रिप्ट करण्यासाठी पासवर्ड
• की: FASTLANE_PASSWORD
  मूल्य: ऍपल विकसक पोर्टल पायाभूत सुविधा खाते संकेतशब्द

आम्ही बदल सेव्ह करतो, PR तयार करतो आणि ते आमच्या टीम लीडकडे पुनरावलोकनासाठी पाठवतो.

परिणाम

या साध्या हाताळणीच्या परिणामी, आम्हाला चाचणीच्या वेळी डिव्हाइस स्क्रीनवर व्हिडिओ रेकॉर्ड करण्याच्या क्षमतेसह एक चांगला, स्थिर कार्य स्टँड प्राप्त झाला. चाचणी उदाहरणामध्ये, मी iPhone X डिव्हाइस मॉडेल निर्दिष्ट केले आहे, परंतु फार्म विविध मॉडेल्स आणि iOS आवृत्त्यांच्या संयोजनातून समृद्ध निवड प्रदान करते.

दुसरा भाग Android प्रकल्पासाठी फायरबेस टेस्ट लॅबच्या चरण-दर-चरण सेटअपसाठी समर्पित असेल.

स्त्रोत: www.habr.com