Przeprowadź XCTest

Z tego przewodnika dowiesz się, jak przygotować test XCTest do testowania w Firebase Test Lab.

Krok 1. Skonfiguruj lokalizację danych pochodnych projektu

Xcode umieszcza skompilowane artefakty iOS, w tym wszystkie utworzone testy, w katalogu DerivedData. Możesz zachować domyślną lokalizację tego katalogu, ale często warto wybrać łatwiej dostępną lokalizację plików, zwłaszcza jeśli zamierzasz często przeprowadzać testy z użyciem Test Lab:

  1. Otwórz projekt w Xcode.
  2. Na pasku menu macOS kliknij Plik > Ustawienia projektu…
  3. W menu Dane pochodne zmień opcję z Lokalizacja domyślna na Lokalizacja niestandardowa.
  4. W polu pod menu wybierz lokalizację, w której Xcode ma zapisywać wyniki testów. (To Twój FOLDER_WITH_TEST_OUTPUT)

Krok 2. Utwórz ogólny plik testowy

Test Lab uruchamia testy jednostkowe i testy interfejsu za pomocą platformy XCTest. Aby uruchomić testy XCTest aplikacji na urządzeniach Test Lab, skompiluj ją do testowania na ogólnym urządzeniu z iOS:

  1. W menu urządzenia u góry okna obszaru roboczego Xcode wybierz Generic iOS Device (Ogólne urządzenie z iOS).
  2. Na pasku menu macOS kliknij Produkt > Kompilacja dla > Testowanie.

Możesz też utworzyć XCTest z poziomu wiersza poleceń. W terminalu użyj tego polecenia:

projekt

xcodebuild -project PATH/TO/YOUR_WORKSPACE/YOUR_PROJECT.xcodeproj \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

obszar roboczy

xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

Krok 3. Podpisz test i zweryfikuj go

  1. Upewnij się, że wszystkie artefakty w aplikacji i teście są podpisane. Możesz to zrobić na przykład w Xcode, określając ustawienia podpisywania, takie jak profil administracyjny i tożsamość. Więcej informacji znajdziesz w artykule Podpisywanie kodu Apple.

  2. Sprawdź podpis aplikacji, uruchamiając polecenie codesign --verify --deep --verbose /path/to/MyApp.app, gdzie „MyApp” to nazwa aplikacji w rozpakowanym folderze. Zależy to od projektu. Oczekiwane dane wyjściowe to MyApp.app: valid on disk.

  3. Jeśli uruchamiasz test XCUITest, musisz zweryfikować test i uruchamiacz, wpisując codesign --verify --deep --verbose /path/to/MyTest-Runner.app, gdzie „MyTest” to nazwa uruchamiacza w rozpakowanym folderze. Zależy to od projektu. Oczekiwane dane wyjściowe to MyTest-Runner.app: valid on disk.

Krok 4. Spakuj aplikację i przetestuj ją pod kątem przesyłania

  1. Po pomyślnym utworzeniu testu spakuj go w formacie ZIP, aby przesłać go na platformę Test Lab:

    cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

Możesz też spakować test, ręcznie kompresując pliki testowe:

  1. Otwórz Findera i przejdź do folderu FOLDER_WITH_TEST_OUTPUT.

  2. Otwórz folder, którego nazwa zaczyna się od nazwy projektu, a potem przejdź do folderu Build/Products.

  3. Wybierz foldery Debug-iphoneos i YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun, a następnie je skompresuj.

Krok 5. (Opcjonalnie) Uruchom test lokalnie

Zanim przeprowadzisz test za pomocą Test Lab, możesz go uruchomić lokalnie na urządzeniu podłączonym przez USB, aby sprawdzić jego działanie:

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YOUR_SCHEME.xctestrun" \
    -destination id=your-phone-id

Dalsze kroki

Prześlij i uruchom test w Firebasekonsoli lub gcloud CLI.