Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Rozpocznij testowanie z systemami ciągłej integracji (CI)

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Możesz użyć Firebase Test Lab podczas tworzenia aplikacji przy użyciu dowolnego systemu ciągłej integracji (CI). Systemy ciągłej integracji umożliwiają automatyczne tworzenie i testowanie aplikacji za każdym razem, gdy wprowadzasz aktualizacje kodu źródłowego aplikacji.

Korzystanie z laboratorium Firebase Test Lab z Jenkins CI

W tej sekcji opisano, jak korzystać z laboratorium testowego z Jenkins CI .

Wymagania

Zanim zaczniesz korzystać z Firebase Test Lab z Jenkinsem, musisz wykonać następujące czynności:

  1. Skonfiguruj gcloud. Postępuj zgodnie z instrukcjami z sekcji Korzystanie z laboratorium Firebase Test Lab z wiersza poleceń gcloud, aby utworzyć projekt Firebase i skonfigurować lokalne środowisko Google Cloud SDK.

  2. Utwórz i autoryzuj konto usługi. Konta usług nie podlegają kontroli spamu ani monitom captcha, które w przeciwnym razie mogłyby zablokować kompilacje CI. Utwórz konto usługi z rolą edytującego w Google Cloud Console , a następnie je aktywuj (zobacz dokumentację gcloud auth Activate-Service-Account, aby dowiedzieć się, jak to zrobić).

  3. Włącz wymagane interfejsy API. Po zalogowaniu się przy użyciu konta usługi: Na stronie Google Developers Console API Library włącz Google Cloud Testing API i Cloud Tool Results API . Aby włączyć te interfejsy API, wpisz te nazwy interfejsów API w polu wyszukiwania u góry konsoli, a następnie kliknij opcję Włącz interfejs API na stronie przeglądu tego interfejsu API.

Zainstaluj i skonfiguruj Jenkins

Możesz zainstalować i skonfigurować Jenkins CI w systemie Linux lub Windows. Niektóre szczegóły tego przewodnika dotyczą instalacji i uruchamiania Jenkins CI w systemie Linux, w tym użycia ukośników ( / ) w ścieżkach plików.

Aby pobrać i zainstalować Jenkins na komputerze z systemem Linux lub Windows, postępuj zgodnie z instrukcjami dotyczącymi instalacji Jenkins . Po zainstalowaniu Jenkins postępuj zgodnie z instrukcjami dotyczącymi uruchamiania i uzyskiwania dostępu do Jenkins , aby zakończyć konfigurację i uzyskać dostęp do pulpitu nawigacyjnego Jenkins.

Skonfiguruj globalne ustawienia bezpieczeństwa

Jenkins nie ma skonfigurowanego uwierzytelniania użytkownika i kontroli dostępu podczas pierwszej instalacji. Przed użyciem Jenkins z Firebase Test Lab skonfiguruj globalne ustawienia zabezpieczeń, aby wymusić kontrolę dostępu i uwierzytelnić użytkowników.

Aby skonfigurować globalne ustawienia bezpieczeństwa

  1. Przejdź do pulpitu nawigacyjnego Jenkins na swoim serwerze. Aby to zrobić, przejdź do http://<servername>:8080 , gdzie <servername> to nazwa komputera, na którym zainstalowałeś Jenkins.
  2. Na pulpicie nawigacyjnym Jenkins kliknij Zarządzaj Jenkins , a następnie kliknij Konfiguruj zabezpieczenia globalne .
  3. Na stronie Konfiguruj zabezpieczenia globalne kliknij Włącz zabezpieczenia , a następnie kliknij Zapisz .

Aby uzyskać więcej informacji na temat konfigurowania ustawień zabezpieczeń dla Jenkins, zobacz Szybkie i proste zabezpieczenia , Standardowa konfiguracja zabezpieczeń i Zabezpieczanie Jenkins .

Utwórz projekt Jenkins

Następnie utwórz projekt do przeprowadzania ciągłych testów integracyjnych swojej aplikacji za pomocą Firebase Test Lab.

Aby stworzyć projekt Jenkins

  1. Przejdź do pulpitu nawigacyjnego Jenkins na swoim serwerze. Aby to zrobić, przejdź do http://<servername>:8080 , gdzie <servername> to nazwa komputera, na którym zainstalowałeś Jenkins.
  2. Na pulpicie nawigacyjnym Jenkins kliknij opcję Nowy element .
  3. Wpisz nazwę swojego projektu w polu Nazwa elementu :
    • Wybierz projekt Freestyle, aby utworzyć projekt, który używa pojedynczej konfiguracji kompilacji.
    • Wybierz pozycję Kompiluj projekt z wieloma konfiguracjami, aby utworzyć projekt działający w wielu różnych konfiguracjach kompilacji. Jeśli planujesz skompilować aplikację z różnymi konfiguracjami kompilacji (wiele ustawień regionalnych, wiele poziomów interfejsu API systemu Android itp.), najlepszym wyborem jest projekt z wieloma konfiguracjami.
  4. Kliknij Zapisz .

Po utworzeniu projektu w przeglądarce internetowej wyświetlana jest strona główna projektu.

Dodaj kontrolę wersji i kroki budowania Gradle

W tej sekcji opisano, jak zintegrować Jenkins z systemami kontroli wersji, takimi jak GitHub, oraz jak dodać kroki kompilacji Gradle, aby kompilować pakiety APK z kodu źródłowego.

Integracja z GitHub i innymi systemami kontroli wersji

Jeśli używasz usługi GitHub lub innego systemu kontroli wersji do zarządzania kodem źródłowym aplikacji, możesz skonfigurować Jenkins do uruchamiania automatycznych kompilacji i uruchamiania testów za każdym razem, gdy aktualizacje aplikacji są zaewidencjonowane. Możesz również skonfigurować Jenkins do okresowego uruchamiania kompilacji.

Aby dowiedzieć się więcej o konfigurowaniu kompilacji w Jenkins, zobacz Konfigurowanie automatycznych kompilacji .

Dodawanie kroków kompilacji Gradle do odbudowy pakietów APK

Jeśli używasz systemu kontroli wersji do zarządzania kodem źródłowym swojej aplikacji, musisz uwzględnić krok kompilacji Gradle, aby tworzyć nowe pliki binarne APK za każdym razem, gdy Jenkins pobiera kod źródłowy z systemu kontroli wersji.

  1. Dodaj krok kompilacji, aby uruchomić następujące polecenia w głównym katalogu aplikacji:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Dodaj krok kompilacji, aby użyć pakietów APK utworzonych przez Gradle podczas testowania w Test Lab. Możesz użyć tej ścieżki jako <local_server_path> w poniższym przykładzie skryptu powłoki, gdzie <AppFolder> to folder projektu Android Studio dla Twojej aplikacji:

    <AppFolder>/app/build/outputs/apk
    

Dodaj kroki kompilacji Test Lab do Jenkins

Teraz możesz dodać krok kompilacji do Jenkins, aby uruchomić laboratorium testowe za pomocą wiersza poleceń gcloud.

Aby dodać etap kompilacji gcloud

  1. Na stronie głównej projektu kliknij opcję Konfiguruj .
  2. Na stronie konfiguracji projektu przewiń w dół do sekcji Kompilacja , a następnie wybierz polecenie Wykonaj powłokę z menu Dodaj krok kompilacji .

  3. W oknie poleceń powłoki Jenkins Execute wprowadź następujące polecenie, zastępując <local_server_path> ścieżkę do przykładowej aplikacji na serwerze, <app_apk> za pakiet APK aplikacji i <app_test_apk> za testowy pakiet APK aplikacji:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

Analizuj wyniki testu

Gdy Test Lab zakończy testowanie Twojej aplikacji, możesz przejrzeć wyniki testów w konsoli Firebase lub w zasobniku Google Cloud Storage w swoim projekcie. Możesz także dodać polecenie gsutil do polecenia powłoki pokazanego powyżej, aby skopiować dane wyników testu na komputer lokalny. Aby dowiedzieć się więcej, zobacz Analizowanie wyników laboratorium Firebase Test Lab .

Ciągła integracja z innymi systemami IK

Aby dowiedzieć się, jak używać Firebase Test Lab z innymi systemami CI, zapoznaj się z ich dokumentami: