हामी Firebase Test Lab मा इन्स्ट्रुमेन्टल परीक्षणहरू चलाउँछौं। भाग 1: iOS परियोजना

मेरो नाम दिमित्री हो, म कम्पनीमा परीक्षकको रूपमा काम गर्छु एमईएल विज्ञान। भर्खरै मैले अपेक्षाकृत भर्खरको सुविधाको साथ काम गर्न समाप्त गरें फायरबेस परीक्षण प्रयोगशाला — अर्थात्, नेटिभ परीक्षण फ्रेमवर्क XCUITest प्रयोग गरेर 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 ट्याब, Code Signing Identity खण्डमा जानुहोस्। XCtest कन्फिगरेसनको लागि, iOS विकासकर्ता चयन गर्नुहोस्। कोड हस्ताक्षर शैली खण्डमा, म्यानुअल चयन गर्नुहोस्। हामीले अहिलेसम्म प्रावधान प्रोफाइल उत्पन्न गरेका छैनौं, तर हामी निश्चित रूपमा केहि पछि फिर्ता गर्नेछौं।

Target AmazingAppUITests को लागि हामी त्यस्तै गर्छौं, तर Product Bundle Identifier स्तम्भमा हामी com.company.amazingappuitest प्रविष्ट गर्छौं।

2. एप्पल विकासकर्ता कार्यक्रम मा एक परियोजना सेटअप

एप्पल विकासकर्ता कार्यक्रम पृष्ठमा जानुहोस्, प्रमाणपत्रहरू, पहिचानकर्ताहरू र प्रोफाइलहरू खण्डमा जानुहोस् र त्यसपछि आइडेन्टिफायर वस्तुको एप आईडी स्तम्भमा जानुहोस्। AmazingAppUITests र bundleID com.company.amazingappuitest भनिने नयाँ एप ID सिर्जना गर्नुहोस्।

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

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

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

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

अर्को, अनुरोध गरिएको डाटा प्रविष्ट गर्नुहोस् - भण्डार, खाता, पासवर्ड, आदि।

यो महत्त्वपूर्ण छ: जब तपाइँ पहिले मिलान उपयोगिता सुरु गर्नुहुन्छ, तपाइँलाई भण्डार डिक्रिप्ट गर्न पासवर्ड प्रविष्ट गर्न सोधिनेछ। यो पासवर्ड बचत गर्न धेरै महत्त्वपूर्ण छ; 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

यदि हामी भविष्यमा क्र्याशलाइटिक्स र/वा एपस्टोरमा पोस्ट गर्नका लागि बिल्डहरू साइन गर्नको लागि म्याच प्रयोग गर्न चाहन्छौं भने, अर्थात्, तपाईंको एप्लिकेसनको बन्डल ID मा हस्ताक्षर गर्न हामी यसलाई ठ्याक्कै यसरी भर्छौं।

तर, हामीलाई सम्झना अनुसार, हामीले परीक्षण निर्माणमा हस्ताक्षर गर्न विशेष वाइल्डकार्ड आईडी सिर्जना गर्यौं। त्यसकारण, फास्टफाइल खोल्नुहोस् र नयाँ लेन प्रविष्ट गर्नुहोस्:

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 लक्ष्यहरूको लागि प्रावधान प्रोफाइल सेक्सनमा निर्दिष्ट हुनुपर्छ।

एसेम्बलिङ टेस्टका लागि लेन थप्न बाँकी छ। जाऔं भण्डार फास्टलेनको लागि एउटा प्लगइन परियोजना जसले यसलाई Firebase परीक्षण प्रयोगशालामा निर्यात सेटअप गर्न र निर्देशनहरू पालना गर्न सजिलो बनाउँछ।

हाम्रो लेन 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

सर्कलसीआईमा फास्टलेन सेटअप गर्ने बारे पूर्ण जानकारीको लागि, म आधिकारिक कागजातहरू पढ्न सिफारिस गर्दछु पटक, два.

हाम्रो 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. हाम्रो परीक्षण बेन्चको बारेमा के हो? फायरबेस सेटअप गर्दै।

लेख केका लागि लेखिएको हो भन्ने कुरामा जाऔं।

सायद तपाईंको एपले नि:शुल्क योजनामा ​​Firebase प्रयोग गर्छ, वा हुनसक्छ। त्यहाँ बिल्कुल कुनै आधारभूत भिन्नता छैन, किनभने परीक्षण आवश्यकताहरूको लागि हामी निःशुल्क प्रयोगको एक वर्षको साथ छुट्टै परियोजना सिर्जना गर्न सक्छौं (ठूलो, सही?)

हामी हाम्रो पूर्वाधार खातामा लग इन गर्छौं (वा कुनै अन्य, यसले फरक पार्दैन), र जान्छौं फायरबेस कन्सोल पृष्ठ। AmazingAppUITests नामको नयाँ परियोजना सिर्जना गर्नुहोस्।

यो महत्त्वपूर्ण छ: Fastfile in lane firebase_test_lab_ios_xctest मा अघिल्लो चरणमा gcp_project प्यारामिटर परियोजना नामसँग मेल खानुपर्छ।

पूर्वनिर्धारित सेटिङहरू हामीलाई राम्रोसँग मिल्छ।

ट्याब बन्द नगर्नुहोस्, उही खाता अन्तर्गत दर्ता गर्नुहोस् GCloud - यो आवश्यक उपाय हो, किनकि फायरबेससँग सञ्चार gcloud कन्सोल इन्टरफेस प्रयोग गरेर हुन्छ।

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

Firebase परियोजनाको साथ ट्याबमा फर्कौं र यसलाई Blaze ट्यारिफ योजनामा ​​स्थानान्तरण गरौं - अब हामीसँग सीमा नाघेको खण्डमा तिर्नु पर्ने कुरा छ।

gcloud इन्टरफेसमा, हाम्रो Firebase परियोजना चयन गर्नुहोस्, "निर्देशिका" मुख्य मेनु वस्तु चयन गर्नुहोस् र Cloud Testing API र Cloud Tools Result API थप्नुहोस्।

त्यसपछि मेनु वस्तुमा जानुहोस् "IAM र प्रशासन" -> सेवा खाताहरू -> सेवा खाता सिर्जना गर्नुहोस्। हामी परियोजना सम्पादन गर्ने अधिकार दिन्छौं।

JSON ढाँचामा API कुञ्जी सिर्जना गर्नुहोस्

हामीलाई डाउनलोड गरिएको JSON अलि पछि चाहिन्छ, तर अहिलेको लागि हामी परीक्षण ल्याब सेटअप पूरा भएको विचार गर्नेछौं।

5. सर्कलसीआई स्थापना गर्दै

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

र निम्न चरहरू सेट अप गर्नुहोस्:

• कुञ्जी: GOOGLE_APPLICATION_CREDENTIALS
  मान: gcloud सेवा खाता कुञ्जीको json फाइलको सामग्री
• कुञ्जी: MATCH_PASSWORD
  मान: प्रमाणपत्रहरूको साथ github भण्डार डिक्रिप्ट गर्नको लागि पासवर्ड
• कुञ्जी: FASTLANE_PASSWORD
  मान: एप्पल विकासकर्ता पोर्टल पूर्वाधार खाता पासवर्ड

हामी परिवर्तनहरू बचत गर्छौं, PR सिर्जना गर्छौं र समीक्षाको लागि हाम्रो टोली नेतृत्वलाई पठाउँछौं।

परिणामहरू

यी सरल हेरफेरहरूको परिणामको रूपमा, हामीले परीक्षणको समयमा यन्त्र स्क्रिनमा भिडियो रेकर्ड गर्ने क्षमताको साथ राम्रो, स्थिर काम गर्ने स्ट्यान्ड प्राप्त गर्यौं। परीक्षण उदाहरणमा, मैले iPhone X यन्त्र मोडेल निर्दिष्ट गरें, तर फार्मले विभिन्न मोडेलहरू र iOS संस्करणहरूको संयोजनबाट समृद्ध चयन प्रदान गर्दछ।

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

स्रोत: www.habr.com