અમે ફાયરબેઝ ટેસ્ટ લેબમાં ઇન્સ્ટ્રુમેન્ટલ ટેસ્ટ ચલાવીએ છીએ. ભાગ 1: iOS પ્રોજેક્ટ

મારું નામ દિમિત્રી છે, હું કંપનીમાં ટેસ્ટર તરીકે કામ કરું છું એમ.ઈ.એલ. વિજ્ .ાન. તદ્દન તાજેતરમાં મેં માંથી પ્રમાણમાં તાજેતરની સુવિધા સાથે કામ કરવાનું સમાપ્ત કર્યું ફાયરબેઝ ટેસ્ટ લેબ — એટલે કે, મૂળ પરીક્ષણ ફ્રેમવર્ક XCUITest નો ઉપયોગ કરીને iOS એપ્લીકેશનના ઇન્સ્ટ્રુમેન્ટલ પરીક્ષણ સાથે.

આ પહેલા, મેં એન્ડ્રોઇડ માટે ફાયરબેઝ ટેસ્ટ લેબ અજમાવી ચુકી છે અને ખરેખર બધું ગમ્યું, તેથી મેં પ્રોજેક્ટના iOS ટેસ્ટ ઇન્ફ્રાસ્ટ્રક્ચરને સમાન ધોરણે મૂકવાનો પ્રયાસ કરવાનું નક્કી કર્યું. મારે ઘણું ગૂગલ કરવું પડ્યું હતું અને બધું પહેલીવાર કામ કરતું ન હતું, તેથી મેં તે લોકો માટે ટ્યુટોરીયલ લેખ લખવાનું નક્કી કર્યું જેઓ હજી પણ સંઘર્ષ કરી રહ્યા છે.

તેથી, જો તમારી પાસે 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 નામ આપો.

બનાવેલ ટાર્ગેટના બિલ્ડ ફેઝ સેક્શન પર જાઓ અને કમ્પાઈલ સોર્સીસ - AmazingAppUITests.swift માં ટાર્ગેટ ડિપેન્ડન્સીઝ - AmazingApp ની હાજરી તપાસો.

એક સારી પ્રથા એ છે કે વિવિધ બિલ્ડ વિકલ્પોને અલગ-અલગ સ્કીમમાં અલગ કરો. અમે અમારા UI પરીક્ષણો [XCode -> પ્રોડક્ટ -> સ્કીમ -> નવી સ્કીમ] માટે એક સ્કીમ બનાવીએ છીએ અને તેને એ જ નામ આપીએ છીએ: AmazingAppUITests.

બનાવેલ સ્કીમના નિર્માણમાં મુખ્ય એપ્લિકેશનનું લક્ષ્ય શામેલ હોવું આવશ્યક છે - AmazingApp અને Target UI પરીક્ષણો - AmazingAppUITests - સ્ક્રીનશોટ જુઓ

આગળ, અમે UI પરીક્ષણો માટે એક નવું બિલ્ડ રૂપરેખાંકન બનાવીએ છીએ. XCode માં, પ્રોજેક્ટ ફાઇલ પર ક્લિક કરો અને માહિતી વિભાગ પર જાઓ. “+” પર ક્લિક કરો અને નવું રૂપરેખાંકન બનાવો, ઉદાહરણ તરીકે XCtest. જ્યારે કોડ સાઇનિંગની વાત આવે ત્યારે ટેમ્બોરિન સાથે નૃત્ય કરવાનું ટાળવા માટે અમને ભવિષ્યમાં આની જરૂર પડશે.

તમારા પ્રોજેક્ટમાં ઓછામાં ઓછા ત્રણ લક્ષ્યો છે: મુખ્ય એપ્લિકેશન, એકમ પરીક્ષણો (છેવટે, તેઓ અસ્તિત્વમાં છે, ખરું ને?) અને અમે બનાવેલા લક્ષ્યાંક UI પરીક્ષણો.

Target AmazingApp, બિલ્ડ સેટિંગ્સ ટેબ, Code Signing Identity વિભાગ પર જાઓ. XCtest રૂપરેખાંકન માટે, iOS ડેવલપર પસંદ કરો. કોડ હસ્તાક્ષર શૈલી વિભાગમાં, મેન્યુઅલ પસંદ કરો. અમે હજી સુધી પ્રોવિઝનિંગ પ્રોફાઇલ જનરેટ કરી નથી, પરંતુ અમે ચોક્કસપણે તેના પર થોડા સમય પછી પાછા આવીશું.

Target AmazingAppUITests માટે અમે તે જ કરીએ છીએ, પરંતુ પ્રોડક્ટ બંડલ ઓળખકર્તા કૉલમમાં અમે com.company.amazingappuitest દાખલ કરીએ છીએ.

2. એપલ ડેવલપર પ્રોગ્રામમાં પ્રોજેક્ટ સેટ કરવો

Apple ડેવલપર પ્રોગ્રામ પૃષ્ઠ પર જાઓ, પ્રમાણપત્રો, ઓળખકર્તાઓ અને પ્રોફાઇલ્સ વિભાગ પર જાઓ અને પછી ઓળખકર્તા આઇટમની એપ્લિકેશન IDs કૉલમ પર જાઓ. AmazingAppUITests અને bundleID com.company.amazingappuitest નામનું એક નવું એપ ID બનાવો.

હવે અમારી પાસે એક અલગ પ્રમાણપત્ર સાથે અમારા પરીક્ષણો પર સહી કરવાની તક છે, પરંતુ... પરીક્ષણ માટે બિલ્ડ એસેમ્બલ કરવાની પ્રક્રિયામાં એપ્લિકેશનને જ એસેમ્બલ કરવી અને ટેસ્ટ રનરને એસેમ્બલ કરવાનો સમાવેશ થાય છે. તદનુસાર, અમને એક પ્રોવિઝનિંગ પ્રોફાઇલ સાથે બે બંડલ ID પર સહી કરવાની સમસ્યાનો સામનો કરવો પડી રહ્યો છે. સદનસીબે, ત્યાં એક સરળ અને ભવ્ય ઉકેલ છે - વાઇલ્ડકાર્ડ એપ્લિકેશન ID. અમે નવી એપ આઈડી બનાવવા માટેની પ્રક્રિયાને પુનરાવર્તિત કરીએ છીએ, પરંતુ સ્પષ્ટ એપ આઈડીને બદલે, સ્ક્રીનશોટની જેમ વાઈલ્ડકાર્ડ એપ આઈડી પસંદ કરો.

આ બિંદુએ, અમે developer.apple.com સાથે કામ પૂર્ણ કરી લીધું છે, પરંતુ અમે બ્રાઉઝર વિન્ડોને નાની નહીં કરીએ. ચાલો જઈએ ફાસ્ટલેન દસ્તાવેજીકરણ સાઇટ અને મેચ યુટિલિટી વિશે કવરથી કવર સુધી વાંચો.

એક સચેત વાચકે નોંધ્યું છે કે આ ઉપયોગિતાનો ઉપયોગ કરવા માટે અમને એક ખાનગી રીપોઝીટરી અને એપલ ડેવલપર પ્રોગ્રામ અને ગીથબ બંનેની ઍક્સેસ સાથે એકાઉન્ટની જરૂર પડશે. અમે ફોર્મનું એકાઉન્ટ બનાવીએ છીએ (જો અચાનક આવી કોઈ વસ્તુ ન હોય તો) [ઇમેઇલ સુરક્ષિત], મજબૂત પાસવર્ડ સાથે આવો, તેને developer.apple.com સાથે રજીસ્ટર કરો અને તેને પ્રોજેક્ટ એડમિનિસ્ટ્રેટર તરીકે નિયુક્ત કરો. આગળ, અમે એકાઉન્ટને તમારી કંપનીના ગીથબ રિપોઝીટરીની ઍક્સેસ આપીએ છીએ અને અમેઝિંગ એપમેચ જેવા નામ સાથે એક નવું ખાનગી ભંડાર બનાવીએ છીએ.

3. ફાસ્ટલેન અને મેચ યુટિલિટી સેટ કરવી

ટર્મિનલ ખોલો, પ્રોજેક્ટ સાથે ફોલ્ડર પર જાઓ અને દર્શાવેલ પ્રમાણે ફાસ્ટલેન શરૂ કરો સત્તાવાર માર્ગદર્શિકા. આદેશ દાખલ કર્યા પછી

$ fastlane init

તમને ઉપલબ્ધ ઉપયોગ રૂપરેખાંકનો પસંદ કરવા માટે સંકેત આપવામાં આવશે. ચોથો વિકલ્પ પસંદ કરો - મેન્યુઅલ પ્રોજેક્ટ સેટઅપ.

પ્રોજેક્ટમાં નવી ડિરેક્ટરી ફાસ્ટલેન છે, જેમાં બે ફાઈલો છે - એપફાઈલ અને ફાસ્ટફાઈલ. ટૂંકમાં, અમે એપફાઈલમાં સર્વિસ ડેટા સ્ટોર કરીએ છીએ, અને ફાસ્ટફાઈલમાં નોકરીઓ લખીએ છીએ, જેને ફાસ્ટલેન પરિભાષામાં લેન કહેવાય છે. હું સત્તાવાર દસ્તાવેજો વાંચવાની ભલામણ કરું છું: વખત, два.

તમારા મનપસંદ ટેક્સ્ટ એડિટરમાં 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

જો અમે ભવિષ્યમાં Crashlytics અને/અથવા AppStore માં પોસ્ટ કરવા માટે, એટલે કે તમારી એપ્લિકેશનના બંડલ ID પર હસ્તાક્ષર કરવા માટે બિલ્ડ્સ પર હસ્તાક્ષર કરવા માટે મેચનો ઉપયોગ કરવા માંગતા હોવ તો અમે તેને બરાબર આ રીતે ભરીએ છીએ.

પરંતુ, જેમ અમને યાદ છે, અમે ટેસ્ટ બિલ્ડ પર હસ્તાક્ષર કરવા માટે એક વિશિષ્ટ વાઇલ્ડકાર્ડ 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 ખોલો. હવે અમારી પાસે Match Development 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. અમારી ટેસ્ટ બેન્ચ વિશે શું? Firebase સેટ કરી રહ્યાં છીએ.

ચાલો નીચે મેળવીએ કે લેખ શેના માટે લખવામાં આવ્યો હતો.

કદાચ તમારી એપ્લિકેશન ફ્રી પ્લાન પર Firebase નો ઉપયોગ કરે છે અથવા કદાચ બિલકુલ નહીં. ત્યાં કોઈ મૂળભૂત તફાવત નથી, કારણ કે પરીક્ષણ જરૂરિયાતો માટે અમે એક વર્ષનો મફત ઉપયોગ સાથે એક અલગ પ્રોજેક્ટ બનાવી શકીએ છીએ (કૂલ, બરાબર?)

અમે અમારા ઇન્ફ્રાસ્ટ્રક્ચર એકાઉન્ટમાં લૉગ ઇન કરીએ છીએ (અથવા અન્ય કોઈ, તેનાથી કોઈ ફરક પડતો નથી), અને જઈએ છીએ ફાયરબેઝ કન્સોલ પેજ. AmazingAppUITests નામનો નવો પ્રોજેક્ટ બનાવો.

તે મહત્વપૂર્ણ છે: લેન firebase_test_lab_ios_xctest માં Fastfile માં અગાઉના પગલામાં gcp_project પરિમાણ પ્રોજેક્ટના નામ સાથે મેળ ખાતું હોવું જોઈએ.

ડિફૉલ્ટ સેટિંગ્સ અમને ખૂબ સારી રીતે અનુકૂળ છે.

ટેબ બંધ કરશો નહીં, માં સમાન ખાતા હેઠળ નોંધણી કરો જીક્લાઉડ - આ એક જરૂરી માપ છે, કારણ કે ફાયરબેઝ સાથે વાતચીત gcloud કન્સોલ ઇન્ટરફેસનો ઉપયોગ કરીને થાય છે.

Google એક વર્ષ માટે $300 આપી રહ્યું છે, જે ઑટોટેસ્ટ કરવાના સંદર્ભમાં સેવાના મફત ઉપયોગના એક વર્ષ સમકક્ષ છે. અમે તમારી ચુકવણી માહિતી દાખલ કરીએ છીએ, $1 ના ટેસ્ટ ડેબિટની રાહ જુઓ અને તમારા એકાઉન્ટમાં $300 પ્રાપ્ત કરો. એક વર્ષ પછી, પ્રોજેક્ટ આપમેળે મફત ટેરિફ પ્લાનમાં સ્થાનાંતરિત થઈ જશે, તેથી નાણાંની સંભવિત ખોટ વિશે ચિંતા કરવાની જરૂર નથી.

ચાલો ફાયરબેઝ પ્રોજેક્ટ સાથે ટેબ પર પાછા આવીએ અને તેને બ્લેઝ ટેરિફ પ્લાનમાં સ્થાનાંતરિત કરીએ - હવે જો મર્યાદા ઓળંગાઈ જાય તો અમારી પાસે કંઈક ચૂકવવાનું છે.

gcloud ઇન્ટરફેસમાં, અમારો Firebase પ્રોજેક્ટ પસંદ કરો, "ડિરેક્ટરી" મુખ્ય મેનૂ આઇટમ પસંદ કરો અને Cloud Testing API અને Cloud Tools Result API ઉમેરો.

પછી મેનુ આઇટમ “IAM અને વહીવટ” -> સર્વિસ એકાઉન્ટ્સ -> સર્વિસ એકાઉન્ટ બનાવો પર જાઓ. અમે પ્રોજેક્ટને સંપાદિત કરવાના અધિકારો આપીએ છીએ.

JSON ફોર્મેટમાં API કી બનાવો

અમને થોડા સમય પછી ડાઉનલોડ કરેલ JSON ની જરૂર પડશે, પરંતુ હમણાં માટે અમે ટેસ્ટ લેબ સેટઅપને પૂર્ણ ગણીશું.

5. CircleCI ની સ્થાપના

વાજબી પ્રશ્ન ઊભો થાય છે - પાસવર્ડ્સ સાથે શું કરવું? અમારા બિલ્ડ મશીનની એન્વાયર્નમેન્ટ વેરીએબલ મિકેનિઝમ અમને અમારા પાસવર્ડ્સ અને અન્ય સંવેદનશીલ ડેટાને સુરક્ષિત રીતે સંગ્રહિત કરવામાં મદદ કરશે. CircleCI પ્રોજેક્ટ સેટિંગ્સમાં, Environment Variables પસંદ કરો

અને નીચેના ચલો સેટ કરો:

• કી: GOOGLE_APPLICATION_CREDENTIALS
  મૂલ્ય: gcloud સેવા એકાઉન્ટ કીની json ફાઇલની સામગ્રી
• કી: MATCH_PASSWORD
  મૂલ્ય: પ્રમાણપત્રો સાથે ગીથબ રીપોઝીટરીને ડિક્રિપ્ટ કરવા માટેનો પાસવર્ડ
• કી: FASTLANE_PASSWORD
  મૂલ્ય: એપલ ડેવલપર પોર્ટલ ઈન્ફ્રાસ્ટ્રક્ચર એકાઉન્ટ પાસવર્ડ

અમે ફેરફારો સાચવીએ છીએ, PR બનાવીએ છીએ અને તેને સમીક્ષા માટે અમારી ટીમ લીડને મોકલીએ છીએ.

પરિણામો

આ સરળ મેનિપ્યુલેશન્સના પરિણામે, અમને પરીક્ષણ સમયે ઉપકરણ સ્ક્રીન પર વિડિઓ રેકોર્ડ કરવાની ક્ષમતા સાથે એક સારું, સ્થિર કાર્યકારી સ્ટેન્ડ પ્રાપ્ત થયું. પરીક્ષણના ઉદાહરણમાં, મેં iPhone X ઉપકરણ મોડેલનો ઉલ્લેખ કર્યો છે, પરંતુ ફાર્મ વિવિધ મોડેલો અને iOS સંસ્કરણોના સંયોજનમાંથી સમૃદ્ધ પસંદગી પ્રદાન કરે છે.

બીજો ભાગ એન્ડ્રોઇડ પ્રોજેક્ટ માટે ફાયરબેઝ ટેસ્ટ લેબના સ્ટેપ-બાય-સ્ટેપ સેટઅપને સમર્પિત કરવામાં આવશે.

સોર્સ: www.habr.com