Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Rozpocznij testowanie z systemami CI

Możesz skorzystać z 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 sprawdzasz aktualizacje kodu źródłowego aplikacji.

Korzystanie z Firebase Test Lab z Jenkins CI

W tej sekcji opisano, jak używać Test Lab z Jenkins CI .

Wymagania

Zanim zaczniesz używać Firebase Test Lab z Jenkins, musisz wykonać następujące czynności:

  1. Skonfiguruj gcloud. Postępuj zgodnie z instrukcjami z Korzystanie z laboratorium Firebase z wiersza poleceń gcloud, aby utworzyć projekt Firebase i skonfigurować lokalne środowisko Google Cloud SDK.
  2. Utwórz konto usługi. Konta usług nie podlegają sprawdzaniu spamu ani monitom captcha, które w przeciwnym razie mogłyby blokować kompilacje CI. Utwórz konto usługi z rolą edytującego w konsoli Google Cloud Platform .
  3. Włącz wymagane interfejsy API. Po zalogowaniu się przy użyciu konta usługi: Na stronie Biblioteka API konsoli Google Developers Console włącz interfejsy Google Cloud Testing API i Cloud Tool Results API . Aby włączyć te interfejsy API, wpisz te nazwy 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ą instalowania i uruchamiania Jenkins CI w systemie Linux, w tym używania 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 instalowania Jenkinsa . 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 Jenkins.

Skonfiguruj globalne ustawienia zabezpieczeń

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

Aby skonfigurować globalne ustawienia zabezpieczeń

  1. Przejdź do pulpitu nawigacyjnego Jenkins na swoim serwerze. Aby to zrobić, przejdź do adresu http: // <nazwa_serwera>: 8080 , gdzie <nazwa_serwera> to nazwa komputera, na którym zainstalowałeś Jenkins.
  2. Na pulpicie nawigacyjnym Jenkins kliknij opcję Zarządzaj Jenkins , a następnie kliknij opcję Konfiguruj zabezpieczenia globalne .
  3. Na stronie Konfiguruj zabezpieczenia globalne kliknij opcję Włącz zabezpieczenia , a następnie kliknij przycisk 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 prowadzenia ciągłych testów integracyjnych aplikacji z Firebase Test Lab.

Aby utworzyć projekt Jenkins

  1. Przejdź do pulpitu nawigacyjnego Jenkins na swoim serwerze. Aby to zrobić, przejdź do adresu http: // <nazwa_serwera>: 8080 , gdzie <nazwa_serwera> to nazwa komputera, na którym zainstalowałeś Jenkins.
  2. Na pulpicie nawigacyjnym Jenkins kliknij opcję Nowy element .
  3. Wpisz nazwę projektu w polu Nazwa elementu :
    • Wybierz projekt w stylu dowolnym, aby utworzyć projekt korzystający z pojedynczej konfiguracji kompilacji.
    • Wybierz opcję Kompiluj projekt z wieloma konfiguracjami, aby utworzyć projekt działający w wielu różnych konfiguracjach kompilacji. Jeśli planujesz zbudować 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 przeglądarka internetowa wyświetla stronę główną projektu.

Dodaj kontrolę wersji i kroki kompilacji Gradle

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

Integracja z GitHub i innymi systemami kontroli wersji

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

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

Dodawanie kroków kompilacji Gradle w celu odbudowania pakietów APK

Jeśli używasz systemu kontroli wersji do zarządzania kodem źródłowym aplikacji, musisz uwzględnić krok kompilacji Gradle, aby utworzyć 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 katalogu głównym 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 przykładzie skryptu powłoki podanym poniżej, 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 Jenkinsa, aby uruchomić Test Lab za pomocą wiersza poleceń gcloud.

Aby dodać krok kompilacji gcloud

  1. Na stronie głównej projektu kliknij Konfiguruj .
  2. Na stronie konfiguracji projektu przewiń w dół do sekcji Build , a następnie wybierz polecenie Execute shell z menu Add build step .

  3. W Jenkins Wykonanie powłoki okno poleceń, należy wprowadzić następującą, zastępując <local_server_path> o podanie ścieżki do aplikacji próbki na serwerze <app_apk> dla Twojej aplikacji APK, a <app_test_apk> dla Twojej aplikacji testowej APK:

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

Przeanalizuj wyniki testów

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 również 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 testowego Firebase .

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 dokumentacją: