ჩვენ ვაწარმოებთ ინსტრუმენტულ ტესტებს Firebase Test Lab-ში. ნაწილი 1: iOS პროექტი

მე მქვია დიმიტრი, ვმუშაობ ტესტერად კომპანიაში MEL მეცნიერება. სულ ახლახან დავასრულე შედარებით ბოლო მახასიათებლთან ურთიერთობა Firebase ტესტის ლაბორატორია — კერძოდ, iOS აპლიკაციების ინსტრუმენტული ტესტირებით, მშობლიური ტესტირების ჩარჩოს XCUITest-ის გამოყენებით.

მანამდე მე უკვე გამოვცადე Firebase Test Lab Android-ისთვის და ძალიან მომეწონა ყველაფერი, ამიტომ გადავწყვიტე პროექტის iOS სატესტო ინფრასტრუქტურა იმავე დონეზე დამეყენებინა. ბევრი მომიწია გუგლში შემოსვლა და პირველად ყველაფერი არ გამომივიდა, ამიტომ გადავწყვიტე დამეწერა სამეურვეო სტატია მათთვის, ვისაც ჯერ კიდევ უჭირს.

ასე რომ, თუ თქვენ გაქვთ UI ტესტები iOS პროექტზე, შეგიძლიათ უკვე სცადოთ მათი გაშვება რეალურ მოწყობილობებზე დღეს, კეთილსინდისიერად მოწოდებული Good Corporation-ის მიერ. დაინტერესებულთათვის მოგესალმებით კატაში.

სიუჟეტში მე გადავწყვიტე დამეფუძნებინა რამდენიმე საწყისი მონაცემები - კერძო საცავი GitHub-ზე და CircleCI build სისტემაზე. აპლიკაციის სახელია AmazingApp, bundleID არის com.company.amazingapp. მე წარმოგიდგენთ ამ მონაცემებს დაუყოვნებლივ, რათა შემცირდეს შემდგომი დაბნეულობა.

თუ თქვენს პროექტში გარკვეული გადაწყვეტილებები განსხვავებულად დანერგეთ, გაგვიზიარეთ თქვენი გამოცდილება კომენტარებში.

1. თავად ტესტები

შექმენით ახალი პროექტის ფილიალი UI ტესტებისთვის:

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

მოდით გავხსნათ პროექტი XCode-ში და შევქმნათ ახალი Target ინტერფეისის ტესტებით [XCode -> File -> New -> Target -> iOS Testing Bundle] და მივცეთ მას ახსნა-განმარტების სახელი AmazingAppUITests.

გადადით შექმნილი Target-ის Build Phases განყოფილებაში და შეამოწმეთ Target Dependencies - AmazingApp, კომპილ წყაროებში - AmazingAppUITests.swift.

კარგი პრაქტიკაა აშენების სხვადასხვა ვარიანტების ცალკე სქემებად გამოყოფა. ჩვენ ვქმნით სქემას ჩვენი UI ტესტებისთვის [XCode -> Product -> Scheme -> New Scheme] და ვაძლევთ მას იგივე სახელს: AmazingAppUITests.

შექმნილი სქემის სტრუქტურა უნდა შეიცავდეს ძირითადი აპლიკაციის სამიზნეს - AmazingApp და Target UI ტესტებს - AmazingAppUITests - იხილეთ ეკრანის სურათი

შემდეგი, ჩვენ ვქმნით ახალ build კონფიგურაციას UI ტესტებისთვის. XCode-ში დააწკაპუნეთ პროექტის ფაილზე და გადადით ინფორმაციის განყოფილებაში. დააჭირეთ "+" და შექმენით ახალი კონფიგურაცია, მაგალითად XCtest. ეს დაგვჭირდება მომავალში, რათა თავიდან ავიცილოთ ტამბურით ცეკვა, როდესაც საქმე ეხება კოდის ხელმოწერას.

თქვენს პროექტში არის მინიმუმ სამი სამიზნე: მთავარი აპლიკაცია, ერთეული ტესტები (ბოლოს და ბოლოს, ისინი არსებობენ, არა?) და Target UI ტესტები, რომლებიც ჩვენ შევქმენით.

გადადით Target AmazingApp, Build Settings ჩანართზე, Code Signing Identity განყოფილებაში. XCtest კონფიგურაციისთვის აირჩიეთ iOS Developer. კოდის ხელმოწერის სტილის განყოფილებაში აირჩიეთ Manual. ჩვენ ჯერ არ შეგვიქმნია უზრუნველყოფის პროფილი, მაგრამ მას აუცილებლად დავუბრუნდებით ცოტა მოგვიანებით.

Target AmazingAppUITests-ისთვისაც იგივეს ვაკეთებთ, მაგრამ Product Bundle Identifier სვეტში შევდივართ com.company.amazingappuitests.

2. Apple Developer Program-ში პროექტის დაყენება

გადადით Apple Developer Program-ის გვერდზე, გადადით სექციაში სერთიფიკატები, იდენტიფიკატორები და პროფილები და შემდეგ იდენტიფიკატორების პუნქტის App IDs სვეტში. შექმენით ახალი აპლიკაციის ID სახელწოდებით AmazingAppUITests და bundleID com.company.amazingappuitests.

ახლა გვაქვს შესაძლებლობა ცალკე სერტიფიკატით მოვაწეროთ ჩვენი ტესტები, მაგრამ... ტესტირებისთვის აწყობის პროცედურა გულისხმობს თავად აპლიკაციის აწყობას და საცდელი რბენის აწყობას. შესაბამისად, ჩვენ წინაშე ვდგავართ ორი პაკეტის პირადობის მოწმობის ხელმოწერის პრობლემას ერთი უზრუნველყოფის პროფილით. საბედნიეროდ, არსებობს მარტივი და ელეგანტური გადაწყვეტა - Wildcard App ID. ჩვენ ვიმეორებთ აპის ახალი ID-ის შექმნის პროცედურას, მაგრამ Explicit App ID-ის ნაცვლად, აირჩიეთ Wildcard App ID, როგორც ეკრანის სურათზე.

ამ ეტაპზე ჩვენ დავასრულეთ developer.apple.com-თან მუშაობა, მაგრამ ბრაუზერის ფანჯარას არ დავამცირებთ. Წავიდეთ Fastlane დოკუმენტაციის საიტი და წაიკითხეთ Match უტილიტის შესახებ თავიდან ბოლომდე.

ყურადღებიანმა მკითხველმა შენიშნა, რომ ამ პროგრამის გამოსაყენებლად დაგვჭირდება პირადი საცავი და ანგარიში Apple Developer Program-ზე და Github-ზე წვდომით. ჩვენ ვქმნით (თუ მოულოდნელად ასეთი რამ არ არსებობს) ფორმის ანგარიშს [ელ.ფოსტით დაცულია], შექმენით ძლიერი პაროლი, დაარეგისტრირეთ developer.apple.com-ზე და დანიშნეთ იგი პროექტის ადმინისტრატორად. შემდეგი, ჩვენ ვაძლევთ ანგარიშს წვდომას თქვენი კომპანიის github საცავზე და ვქმნით ახალ კერძო საცავს სახელით, როგორიცაა AmazingAppMatch.

3. Fastlane-ის და მატჩის პროგრამის დაყენება

გახსენით ტერმინალი, გადადით პროექტის საქაღალდეში და დააინსტალირეთ fastlane, როგორც ეს მითითებულია ოფიციალური სახელმძღვანელო. ბრძანების შეყვანის შემდეგ

$ fastlane init

თქვენ მოგეთხოვებათ აირჩიოთ გამოყენების ხელმისაწვდომი კონფიგურაციები. აირჩიეთ მეოთხე ვარიანტი - ხელით პროექტის დაყენება.

პროექტს აქვს ახალი დირექტორია fastlane, რომელიც შეიცავს ორ ფაილს - Appfile და Fastfile. მოკლედ, ჩვენ ვინახავთ სერვისის მონაცემებს 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 სერვერის დაყენებისას!

ახალი ფაილი გამოჩნდა fastlane საქაღალდეში - Matchfile. გახსენით ის თქვენს საყვარელ ტექსტურ რედაქტორში და აჩვენეთ ასე:

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

ჩვენ ზუსტად ამ გზით ვავსებთ მას, თუ გვსურს მომავალში გამოვიყენოთ მატჩი Crashlytics-ში ან/და AppStore-ში ჩვენებისთვის build-ების გასაფორმებლად, ანუ თქვენი აპლიკაციის პაკეტის ID-ზე ხელმოწერისთვის.

მაგრამ, როგორც გვახსოვს, ჩვენ შევქმენით სპეციალური Wildcard ID, რათა ხელი მოაწეროთ სატესტო build-ს. ამიტომ, გახსენით 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

და ჩვენ ვხედავთ, თუ როგორ შექმნა fastlane-მა ახალი სერთიფიკატი და ჩადო საცავში. დიდი!

გახსენით XCode. ახლა ჩვენ გვაქვს Match Development com.company.* ფორმის აუცილებელი უზრუნველყოფის პროფილი, რომელიც უნდა იყოს მითითებული Provisioning პროფილის განყოფილებაში AmazingApp და AmazingAppUITests სამიზნეებისთვის.

რჩება ტესტების შეკრების ზოლის დამატება. Წავიდეთ საცავი მოდულის პროექტი fastlane-ისთვის, რომელიც აადვილებს ექსპორტის დაყენებას Firebase Test Lab-ში და მიჰყვება ინსტრუქციებს.

მოდით დავაკოპიროთ-პასტი ორიგინალური მაგალითიდან ისე, რომ ჩვენი ზოლის 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

სრული ინფორმაციისთვის fastlane-ის 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. რაც შეეხება ჩვენს საცდელ სკამს? Firebase-ის დაყენება.

მოდით გადავიდეთ იმაზე, თუ რისთვის დაიწერა სტატია.

შესაძლოა, თქვენი აპი იყენებს Firebase-ს უფასო გეგმაზე, ან შესაძლოა საერთოდ არ იყენებს. აბსოლუტურად არანაირი ფუნდამენტური განსხვავება არ არის, რადგან ტესტირების საჭიროებებისთვის ჩვენ შეგვიძლია შევქმნათ ცალკე პროექტი ერთი წლის უფასო გამოყენებით (მაგარია, არა?)

ჩვენ შევდივართ ჩვენს ინფრასტრუქტურის ანგარიშში (ან სხვა, არ აქვს მნიშვნელობა) და მივდივართ Firebase კონსოლის გვერდი. შექმენით ახალი პროექტი სახელად AmazingAppUITests.

მნიშვნელოვანია: წინა საფეხურზე Fastfile in lane firebase_test_lab_ios_xctest-ში gcp_project პარამეტრი უნდა შეესაბამებოდეს პროექტის სახელს.

ნაგულისხმევი პარამეტრები საკმაოდ კარგად გვერგება.

არ დახუროთ ჩანართი, დარეგისტრირდით იმავე ანგარიშზე Gcloud - ეს აუცილებელი ღონისძიებაა, რადგან Firebase-თან კომუნიკაცია ხდება gcloud კონსოლის ინტერფეისის გამოყენებით.

გუგლი წელიწადში 300 დოლარს გასცემს, რაც ავტოტესტების ჩატარების კონტექსტში სერვისით უფასო სარგებლობის ერთი წლის ტოლფასია. ჩვენ შევიყვანთ თქვენი გადახდის ინფორმაციას, ველოდებით სატესტო დებეტს $1 და ვიღებთ $300 თქვენს ანგარიშზე. ერთი წლის შემდეგ პროექტი ავტომატურად გადაინაცვლებს უფასო სატარიფო გეგმაზე, ასე რომ არ არის საჭირო ფულის შესაძლო დაკარგვაზე ფიქრი.

დავუბრუნდეთ ჩანართს Firebase პროექტით და გადავიტანოთ Blaze-ის სატარიფო გეგმაში - ახლა ჩვენ გვაქვს გადასახდელი, თუ ლიმიტი გადააჭარბებს.

gcloud ინტერფეისში აირჩიეთ ჩვენი Firebase პროექტი, აირჩიეთ მენიუს მთავარი ელემენტი "Directory" და დაამატეთ Cloud Testing API და Cloud Tools Result API.

შემდეგ გადადით მენიუს პუნქტში "IAM და ადმინისტრაცია" -> სერვისის ანგარიშები -> სერვისის ანგარიშის შექმნა. ჩვენ ვაძლევთ უფლებებს პროექტის რედაქტირების შესახებ.

შექმენით API გასაღები JSON ფორმატში

გადმოწერილი JSON ცოტა მოგვიანებით დაგვჭირდება, მაგრამ ახლა სატესტო ლაბორატორიის დაყენება დასრულებულად მიგვაჩნია.

5. CircleCI-ის დაყენება

ჩნდება გონივრული კითხვა - რა უნდა გავაკეთოთ პაროლებთან? ჩვენი კონსტრუქციული აპარატის გარემოს ცვლადი მექანიზმი დაგვეხმარება უსაფრთხოდ შევინახოთ ჩვენი პაროლები და სხვა მგრძნობიარე მონაცემები. CircleCI პროექტის პარამეტრებში აირჩიეთ Environment Variables

და დააყენეთ შემდეგი ცვლადები:

• გასაღები: GOOGLE_APPLICATION_CREDENTIALS
  მნიშვნელობა: gcloud სერვისის ანგარიშის გასაღების json ფაილის შიგთავსი
• გასაღები: MATCH_PASSWORD
  მნიშვნელობა: პაროლი სერთიფიკატებით github საცავის გაშიფვრისთვის
• გასაღები: FASTLANE_PASSWORD
  ღირებულება: Apple Developer Portal ინფრასტრუქტურის ანგარიშის პაროლი

ჩვენ ვინახავთ ცვლილებებს, ვქმნით PR-ს და ვუგზავნით მას ჩვენი გუნდის ლიდერს განსახილველად.

შედეგები

ამ მარტივი მანიპულაციების შედეგად მივიღეთ კარგი, სტაბილური სამუშაო სტენდი ტესტირების დროს მოწყობილობის ეკრანზე ვიდეოს ჩაწერის შესაძლებლობით. ტესტის მაგალითში მე დავაზუსტე iPhone X მოწყობილობის მოდელი, მაგრამ ფერმა გთავაზობთ მდიდარ არჩევანს სხვადასხვა მოდელებისა და iOS ვერსიების კომბინაციიდან.

მეორე ნაწილი დაეთმობა Firebase ტესტის ლაბორატორიის ეტაპობრივ დაყენებას Android პროექტისთვის.

წყარო: www.habr.com