Firebase Test Lab에서 도구 테스트를 실행합니다. 파트 1: iOS 프로젝트

내 이름은 Dmitry이고 회사에서 테스터로 일하고 있습니다. MEL 과학. 가장 최근에 저는 Firebase 테스트 랩 - 즉, 기본 테스트 프레임워크인 XCUITest를 사용하여 iOS 애플리케이션을 도구로 테스트합니다.

그 전에는 이미 Android용 Firebase Test Lab을 사용해 보았고 모든 것이 정말 마음에 들었기 때문에 프로젝트의 iOS 테스트 인프라를 동일한 레일에 배치하기로 결정했습니다. 구글링을 많이 해야 했고 처음에는 모든 것이 잘 되지 않았기 때문에 여전히 해야 하는 사람들을 위해 튜토리얼 기사를 작성하기로 결정했습니다.

따라서 iOS 프로젝트에 대한 UI 테스트가 있는 경우 Good Corporation에서 제공하는 실제 장치에서 이미 테스트를 실행할 수 있습니다. 관심 있음 - 고양이 밑에서 환영합니다.

이야기에서 저는 일부 소스 데이터(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]로 새 Target을 만들고 이름을 AmazingAppUITests로 지정합니다.

생성된 Target의 Build Phases 섹션으로 이동하여 Compile Sources - AmazingAppUITests.swift에서 Target Dependencies - AmazingApp을 확인합니다.

다양한 빌드 옵션을 별도의 체계로 분리하는 것이 좋습니다. UI 테스트 [XCode -> Product -> Scheme -> New Scheme]에 대한 스키마를 생성하고 AmazingAppUITests라는 동일한 이름을 지정합니다.

생성된 체계의 빌드에는 기본 애플리케이션의 대상(AmazingApp) 및 대상 UI 테스트(AmazingAppUITests)가 포함되어야 합니다. 스크린샷 참조

다음으로 UI 테스트를 위한 새 빌드 구성을 만듭니다. Xcode에서 프로젝트 파일을 클릭하고 정보 섹션으로 이동합니다. "+"를 클릭하고 XCtest와 같은 새 구성을 만듭니다. 코드 서명과 관련하여 탬버린과 춤추는 것을 피하기 위해 앞으로 이것이 필요할 것입니다.

프로젝트에는 기본 애플리케이션, 단위 테스트(몇 가지가 있습니다. 맞죠?) 및 우리가 만든 테스트의 Target UI와 같이 최소한 세 가지 Target이 있습니다.

Target AmazingApp, Build Settings 탭, Code Signing Identity 섹션으로 이동합니다. XCtest 구성의 경우 iOS 개발자를 선택합니다. 코드 서명 스타일 섹션에서 수동을 선택합니다. 아직 프로비저닝 프로필을 생성하지 않았지만 나중에 확실히 다시 만들 것입니다.

Target AmazingAppUITests의 경우에도 동일한 작업을 수행하지만 Product Bundle Identifier 열에 com.company.amazingappuitests를 입력합니다.

2. Apple 개발자 프로그램에서 프로젝트 설정

Apple 개발자 프로그램 페이지로 이동하여 인증서, 식별자 및 프로필 섹션으로 이동한 다음 식별자 항목의 앱 ID 열로 이동합니다. AmazingAppUITests 및 bundleID com.company.amazingappuitests라는 새 앱 ID를 만듭니다.

이제 우리는 별도의 인증서로 테스트에 서명할 기회가 있지만 ... 테스트를 위한 빌드 절차에는 애플리케이션 자체를 빌드하고 테스트 러너를 빌드하는 것이 포함됩니다. 따라서 우리는 하나의 프로비저닝 프로파일로 두 개의 번들 ID를 서명하는 문제에 직면해 있습니다. 다행히도 간단하고 우아한 솔루션인 Wildcard App ID가 있습니다. 새로운 App ID를 생성하는 절차를 반복하되 Explicit App ID 대신 스크린샷과 같이 Wildcard App ID를 선택합니다.

이 시점에서 우리는 developer.apple.com에 대해 작업을 마쳤지만 브라우저 창을 최소화하지는 않을 것입니다. 가자 Fastlane에 대한 문서가 있는 사이트 Match 유틸리티에 대해 처음부터 끝까지 읽으십시오.

주의 깊은 독자는 이 유틸리티를 사용하려면 Apple 개발자 프로그램과 Github 모두에 액세스할 수 있는 개인 저장소와 계정이 필요하다는 것을 알아차렸습니다. 우리는 (갑자기 그런 것이 없다면) 다음 형식의 계정을 만듭니다. [이메일 보호], 강력한 암호를 제시하고 developer.apple.com에 등록한 다음 프로젝트 관리자로 지정합니다. 다음으로 회사의 github 리포지토리에 대한 계정 액세스 권한을 부여하고 AmazingAppMatch와 같은 이름으로 새 프라이빗 리포지토리를 만듭니다.

3. Fastlane 및 매치 유틸리티 설정

터미널을 열고 프로젝트가 있는 폴더로 이동한 다음 에 표시된 대로 fastlane을 초기화합니다. 공식 매뉴얼. 명령어 입력 후

$ fastlane init

사용 가능한 사용 구성을 선택하라는 메시지가 표시됩니다. 네 번째 항목인 프로젝트 수동 구성을 선택합니다.

Appfile과 Fastfile이라는 두 개의 파일이 있는 새로운 fastlane 디렉토리가 프로젝트에 나타났습니다. 간단히 말해서 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에 업로드하기 위해 빌드에 서명하기 위해(즉, 애플리케이션의 번들 ID에 서명하기 위해) match를 사용하려는 경우 이 방식으로 채웁니다.

그러나 우리가 기억하는 것처럼 테스트 빌드에 서명하기 위해 특별한 와일드카드 ID를 만들었습니다. 따라서 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를 엽니다. 이제 AmazingApp 및 AmazingAppUITests 대상에 대한 프로비저닝 프로필 섹션에 지정해야 하는 Match Development com.company.* 유형의 필수 프로비저닝 프로필이 있습니다.

테스트를 빌드하기 위해 레인을 추가해야 합니다. 가자 저장소 Firebase Test Lab으로 내보내기를 쉽게 설정하고 지침을 따를 수 있게 해주는 fastlane 플러그인 프로젝트입니다.

원래 예제에서 복사하여 붙여넣어 레인 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에서 fastlane 설정에 대한 전체 정보는 공식 문서를 읽는 것이 좋습니다. 시간, два.

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를 전혀 사용하지 않을 수 있습니다. 근본적인 차이는 전혀 없습니다. 테스트의 필요성에 따라 XNUMX년 동안 무료로 사용할 수 있는 별도의 프로젝트를 만들 수 있기 때문입니다(멋지죠?).

인프라 계정(또는 다른 계정, 상관 없음)에 로그인하고 다음으로 이동합니다. Firebase 콘솔 페이지. AmazingAppUITests라는 새 프로젝트를 만듭니다.

중요 : 이전 단계에서 레인 firebase_test_lab_ios_xctest의 Fastfile에서 gcp_project 매개변수는 프로젝트 이름과 일치해야 합니다.

기본 설정은 우리에게 적합합니다.

우리는 탭을 닫지 않고 동일한 계정으로 등록합니다 지클라우드 Firebase와의 통신은 gcloud 콘솔 인터페이스를 사용하여 이루어지므로 필요한 조치입니다.

Google은 300년 동안 1달러를 무료로 제공하며, 이는 자동 테스트를 수행하는 맥락에서 300년 동안 서비스를 무료로 사용하는 것과 같습니다. 결제 데이터를 입력하고 $XNUMX의 테스트 상각을 기다렸다가 계정에 $XNUMX를 받습니다. XNUMX년 후 프로젝트는 자동으로 무료 요금제로 이전되므로 손실 가능성에 대해 걱정할 필요가 없습니다.

Firebase 프로젝트가 있는 탭으로 돌아가 Blaze 요금제로 전환해 보겠습니다. 이제 한도를 초과하면 지불해야 할 것이 있습니다.

gcloud 인터페이스에서 Firebase 프로젝트를 선택하고 "Catalogue" 기본 메뉴 항목을 선택한 다음 Cloud Testing API 및 Cloud Tools Result API를 추가합니다.

그런 다음 메뉴 항목 "IAM 및 관리" -> 서비스 계정 -> 서비스 계정 만들기로 이동합니다. 프로젝트를 편집할 수 있는 권한을 부여합니다.

JSON 형식으로 API 키 생성

나중에 다운로드한 JSON이 필요하지만 지금은 Test Lab 설정이 완료된 것으로 간주합니다.

5. CircleCI 설정하기

합리적인 질문이 떠오르고 있습니다. 비밀번호로 무엇을 해야 할까요? 암호 및 기타 중요한 데이터를 안전하게 유지하려면 빌드 머신의 환경 변수 메커니즘이 도움이 될 것입니다. CircleCI 프로젝트 설정에서 환경 변수를 선택합니다.

그리고 다음 변수를 설정합니다.

• 키: GOOGLE_APPLICATION_CREDENTIALS
  값: gcloud 서비스 계정 키 json 파일의 내용
• 키: MATCH_PASSWORD
  값: 인증서로 github 저장소를 해독하기 위한 암호
• 키: FASTLANE_PASSWORD
  값: Apple 개발자 포털 인프라 계정 비밀번호

변경 사항을 저장하고 PR을 만든 다음 검토를 위해 팀장에게 보냅니다.

결과

이러한 간단한 조작의 결과 테스트 시 장치 화면에 비디오를 녹화할 수 있는 기능이 있는 안정적이고 안정적인 작업 스탠드를 얻었습니다. 테스트 사례에서는 iPhone X 장치 모델을 지정했지만 팜은 다양한 모델과 iOS 버전의 조합에서 풍부한 선택을 제공합니다.

두 번째 부분에서는 Android 프로젝트용 Firebase Test Lab을 단계별로 설정하는 방법을 다룹니다.

출처 : habr.com