আমরা ফায়ারবেস টেস্ট ল্যাবে ইন্সট্রুমেন্টাল পরীক্ষা চালাই। পার্ট 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 -> File -> New -> Target -> iOS Testing Bundle] সহ একটি নতুন টার্গেট তৈরি করি, এটিকে স্ব-ব্যাখ্যামূলক নাম AmazingAppUITests।

তৈরি করা টার্গেটের বিল্ড ফেজ বিভাগে যান এবং কম্পাইল সোর্স - AmazingAppUITests.swift-এ লক্ষ্য নির্ভরতা - AmazingApp-এর উপস্থিতি পরীক্ষা করুন৷

একটি ভাল অভ্যাস হল বিভিন্ন বিল্ড অপশনকে আলাদা স্কিমে আলাদা করা। আমরা আমাদের UI পরীক্ষার জন্য একটি স্কিম তৈরি করি [XCode -> পণ্য -> স্কিম -> নতুন স্কিম] এবং এটিকে একই নাম দিই: AmazingAppUITests।

তৈরি করা স্কিমের বিল্ডে অবশ্যই মূল অ্যাপ্লিকেশনের টার্গেট অন্তর্ভুক্ত থাকতে হবে - AmazingApp এবং Target UI পরীক্ষা - AmazingAppUITests - স্ক্রিনশট দেখুন

এর পরে, আমরা UI পরীক্ষার জন্য একটি নতুন বিল্ড কনফিগারেশন তৈরি করি। XCode-এ, প্রজেক্ট ফাইলে ক্লিক করুন এবং Info বিভাগে যান। "+" এ ক্লিক করুন এবং একটি নতুন কনফিগারেশন তৈরি করুন, উদাহরণস্বরূপ XCtest। কোড সাইনিংয়ের ক্ষেত্রে খঞ্জনি দিয়ে নাচ এড়াতে ভবিষ্যতে আমাদের এটির প্রয়োজন হবে।

আপনার প্রকল্পে কমপক্ষে তিনটি লক্ষ্য রয়েছে: মূল অ্যাপ্লিকেশন, ইউনিট পরীক্ষা (সব পরে, তারা বিদ্যমান, তাই না?) এবং লক্ষ্য UI পরীক্ষাগুলি যা আমরা তৈরি করেছি৷

Target AmazingApp, বিল্ড সেটিংস ট্যাব, কোড সাইনিং আইডেন্টিটি বিভাগে যান। XCtest কনফিগারেশনের জন্য, iOS বিকাশকারী নির্বাচন করুন। কোড সাইনিং স্টাইল বিভাগে, ম্যানুয়াল নির্বাচন করুন। আমরা এখনও একটি প্রভিশনিং প্রোফাইল তৈরি করিনি, তবে আমরা অবশ্যই একটু পরে এটিতে ফিরে যাব।

Target AmazingAppUITests-এর জন্য আমরা একই কাজ করি, কিন্তু প্রোডাক্ট বান্ডেল আইডেন্টিফায়ার কলামে আমরা com.company.amazingappuitest লিখি।

2. অ্যাপল ডেভেলপার প্রোগ্রামে একটি প্রকল্প সেট আপ করা

অ্যাপল ডেভেলপার প্রোগ্রাম পৃষ্ঠায় যান, সার্টিফিকেট, শনাক্তকারী এবং প্রোফাইল বিভাগে যান এবং তারপর আইডেন্টিফায়ার আইটেমের অ্যাপ আইডি কলামে যান। AmazingAppUITests এবং bundleID com.company.amazingappuitest নামে একটি নতুন অ্যাপ আইডি তৈরি করুন৷

এখন আমাদের কাছে একটি পৃথক শংসাপত্রের সাথে আমাদের পরীক্ষাগুলিতে স্বাক্ষর করার সুযোগ রয়েছে, কিন্তু... পরীক্ষার জন্য একটি বিল্ড একত্রিত করার পদ্ধতিতে অ্যাপ্লিকেশনটি নিজেই একত্রিত করা এবং পরীক্ষা রানারকে একত্রিত করা জড়িত৷ তদনুসারে, আমরা একটি প্রভিশনিং প্রোফাইলের সাথে দুটি বান্ডিল আইডি স্বাক্ষর করার সমস্যার সম্মুখীন হচ্ছি। সৌভাগ্যবশত, একটি সহজ এবং মার্জিত সমাধান আছে - ওয়াইল্ডকার্ড অ্যাপ আইডি। আমরা একটি নতুন অ্যাপ আইডি তৈরি করার পদ্ধতিটি পুনরাবৃত্তি করি, কিন্তু স্পষ্ট অ্যাপ আইডির পরিবর্তে, স্ক্রিনশটের মতো ওয়াইল্ডকার্ড অ্যাপ আইডি নির্বাচন করুন।

এই মুহুর্তে, আমরা developer.apple.com এর সাথে কাজ শেষ করেছি, কিন্তু আমরা ব্রাউজার উইন্ডোটি ছোট করব না। চল যাই ফাস্টলেন ডকুমেন্টেশন সাইট এবং কভার থেকে কভার পর্যন্ত ম্যাচ ইউটিলিটি সম্পর্কে পড়ুন।

একজন মনোযোগী পাঠক লক্ষ্য করেছেন যে এই ইউটিলিটিটি ব্যবহার করার জন্য আমাদের একটি ব্যক্তিগত সংগ্রহস্থল এবং অ্যাপল বিকাশকারী প্রোগ্রাম এবং গিথুব উভয়ের অ্যাক্সেস সহ একটি অ্যাকাউন্টের প্রয়োজন হবে। আমরা ফর্মের একটি অ্যাকাউন্ট তৈরি করি (যদি হঠাৎ এমন কিছু না থাকে) [ইমেল সুরক্ষিত], একটি শক্তিশালী পাসওয়ার্ড নিয়ে আসুন, এটি 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

আমরা যদি ভবিষ্যতে ক্র্যাশলিটিক্স এবং/অথবা অ্যাপস্টোরে প্রদর্শনের জন্য বিল্ডে স্বাক্ষর করতে, অর্থাৎ আপনার অ্যাপ্লিকেশনের বান্ডেল আইডিতে স্বাক্ষর করতে ম্যাচ ব্যবহার করতে চাই তবে আমরা ঠিক এইভাবে এটি পূরণ করি।

কিন্তু, আমাদের মনে আছে, আমরা পরীক্ষা বিল্ডে স্বাক্ষর করার জন্য একটি বিশেষ ওয়াইল্ডকার্ড আইডি তৈরি করেছি। অতএব, ফাস্টফাইল খুলুন এবং একটি নতুন লেন লিখুন:

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 ফর্মের প্রয়োজনীয় প্রভিশনিং প্রোফাইল আছে।

এটা পরীক্ষা একত্রিত করার জন্য লেন যোগ অবশেষ. চল যাই ভান্ডার ফাস্টলেনের জন্য একটি প্লাগইন প্রকল্প যা ফায়ারবেস টেস্ট ল্যাবে এক্সপোর্ট সেট আপ করা এবং নির্দেশাবলী অনুসরণ করা সহজ করে তোলে।

আসল উদাহরণ থেকে কপি-পেস্ট করা যাক যাতে আমাদের লেন টেস্টিং_বিল্ড_ফর_ফায়ারবেসটি এভাবে দেখায়:

 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 নামে একটি নতুন প্রকল্প তৈরি করুন৷

এটি বর্তমানে এমন গুরুত্বপূর্ণ: ফাস্টফাইল ইন লেনে ফায়ারবেস_টেস্ট_ল্যাব_আইওস_xctest এর আগের ধাপে gcp_project প্যারামিটারটি প্রকল্পের নামের সাথে মিলতে হবে।

ডিফল্ট সেটিংস আমাদের বেশ ভাল স্যুট.

ট্যাব বন্ধ করবেন না, একই অ্যাকাউন্টের অধীনে নিবন্ধন করুন জিক্লাউড - এটি একটি প্রয়োজনীয় পরিমাপ, যেহেতু ফায়ারবেসের সাথে যোগাযোগ gcloud কনসোল ইন্টারফেস ব্যবহার করে ঘটে।

Google এক বছরের জন্য $300 দিচ্ছে, যা অটোটেস্ট করার পরিপ্রেক্ষিতে পরিষেবাটির বিনামূল্যে ব্যবহারের এক বছরের সমান। আমরা আপনার অর্থপ্রদানের তথ্য লিখি, $1 টেস্ট ডেবিটের জন্য অপেক্ষা করি এবং আপনার অ্যাকাউন্টে $300 গ্রহণ করি। এক বছর পরে, প্রকল্পটি স্বয়ংক্রিয়ভাবে একটি বিনামূল্যের ট্যারিফ প্ল্যানে স্থানান্তরিত হবে, তাই অর্থের সম্ভাব্য ক্ষতির বিষয়ে চিন্তা করার দরকার নেই।

ফায়ারবেস প্রকল্পের সাথে ট্যাবে ফিরে আসুন এবং এটিকে ব্লেজ ট্যারিফ প্ল্যানে স্থানান্তর করি - এখন সীমা অতিক্রম করলে আমাদের কিছু দিতে হবে।

gcloud ইন্টারফেসে, আমাদের Firebase প্রকল্প নির্বাচন করুন, "ডিরেক্টরি" প্রধান মেনু আইটেমটি নির্বাচন করুন এবং ক্লাউড টেস্টিং API এবং ক্লাউড টুলস ফলাফল API যোগ করুন।

তারপর মেনু আইটেম "IAM এবং প্রশাসন" যান -> পরিষেবা অ্যাকাউন্ট -> পরিষেবা অ্যাকাউন্ট তৈরি করুন। আমরা প্রকল্পটি সম্পাদনা করার অধিকার প্রদান করি।

JSON ফর্ম্যাটে একটি API কী তৈরি করুন

আমাদের একটু পরে ডাউনলোড করা JSON প্রয়োজন হবে, কিন্তু আপাতত আমরা টেস্ট ল্যাব সেটআপ সম্পূর্ণ বিবেচনা করব।

5. সার্কেলসিআই স্থাপন করা

একটি যুক্তিসঙ্গত প্রশ্ন উঠছে - পাসওয়ার্ড দিয়ে কি করতে হবে? আমাদের বিল্ড মেশিনের পরিবেশ পরিবর্তনশীল প্রক্রিয়া আমাদের পাসওয়ার্ড এবং অন্যান্য সংবেদনশীল ডেটা নিরাপদে সংরক্ষণ করতে সাহায্য করবে। CircleCI প্রকল্প সেটিংসে, পরিবেশের ভেরিয়েবল নির্বাচন করুন

এবং নিম্নলিখিত ভেরিয়েবল সেট আপ করুন:

• কী: GOOGLE_APPLICATION_CREDENTIALS৷
  মান: gcloud পরিষেবা অ্যাকাউন্ট কী-এর json ফাইলের বিষয়বস্তু
• কী: MATCH_PASSWORD
  মান: সার্টিফিকেট সহ গিথুব সংগ্রহস্থল ডিক্রিপ্ট করার জন্য পাসওয়ার্ড
• কী: FASTLANE_PASSWORD
  মান: অ্যাপল ডেভেলপার পোর্টাল অবকাঠামো অ্যাকাউন্ট পাসওয়ার্ড

আমরা পরিবর্তনগুলি সংরক্ষণ করি, একটি PR তৈরি করি এবং পর্যালোচনার জন্য আমাদের দলের নেতৃত্বের কাছে পাঠাই।

ফলাফল

এই সাধারণ ম্যানিপুলেশনগুলির ফলস্বরূপ, আমরা পরীক্ষার সময় ডিভাইসের স্ক্রিনে ভিডিও রেকর্ড করার ক্ষমতা সহ একটি ভাল, স্থিতিশীল কাজের স্ট্যান্ড পেয়েছি। পরীক্ষার উদাহরণে, আমি iPhone X ডিভাইসের মডেলটি নির্দিষ্ট করেছি, কিন্তু ফার্মটি বিভিন্ন মডেল এবং iOS সংস্করণের সংমিশ্রণ থেকে একটি সমৃদ্ধ নির্বাচন প্রদান করে।

দ্বিতীয় অংশটি একটি অ্যান্ড্রয়েড প্রকল্পের জন্য ফায়ারবেস টেস্ট ল্যাবের ধাপে ধাপে সেটআপে নিবেদিত হবে।

উত্স: www.habr.com