Catch up on everthing we announced at this year's Firebase Summit. Learn more

Начать тестирование с системами CI

Вы можете использовать Firebase Test Lab при разработке приложения с использованием любой системы непрерывной интеграции (CI). Системы непрерывной интеграции позволяют автоматически создавать и тестировать приложение каждый раз, когда вы регистрируете обновления исходного кода приложения.

Использование Firebase Test Lab с Jenkins CI

В этом разделе описано , как использовать Lab Test с Jenkins CI .

Требования

Прежде чем вы сможете использовать Firebase Test Lab с Jenkins, вам необходимо выполнить следующие шаги:

  1. Настроить gcloud. Следуйте инструкции , используя Lab Test Firebase из gcloud командной строки для создания проекта Firebase и настроить локальную среду Google Cloud SDK.

  2. Создайте и авторизуйте сервисный аккаунт. Учетные записи служб не подлежат проверкам на спам или запросам ввода кода, которые в противном случае могли бы заблокировать ваши сборки CI. Создание учетной записи службы с ролью редактора в Google Cloud Console , а затем включите его (см документации Activate-сервис-счет gcloud аутентификации , чтобы узнать , как).

  3. Включите необходимые API. После входа в систему с помощью учетной записи службы: В странице Google Developers Console API библиотеки , позволяют API Google Cloud Testing и Cloud Tool Результаты API. Чтобы включить эту API - интерфейсы, введите эти имена API в окно поиска в верхней части консоли, а затем нажмите кнопку Включить API на странице обзора для этого API.

Установите и настройте Jenkins

Вы можете установить и настроить Jenkins CI в Linux или Windows. Некоторые детали данного руководства являются специфическими для установки и запуска Jenkins CI на Linux, в том числе использование косой черты ( / ) в пути к файлам.

Для того, чтобы загрузить и установить Дженкинс на компьютере под управлением Linux или Windows, следуйте инструкциям по установке Дженкинс . После установки Дженкинс, следуйте инструкциям на Запуск и Доступ к Jenkins для полной настройки и получить доступ к панели Дженкинс.

Настроить глобальные параметры безопасности

При первой установке Jenkins не настраивает аутентификацию пользователей и контроль доступа. Перед использованием Jenkins с Firebase Test Lab настройте глобальные параметры безопасности, чтобы обеспечить контроль доступа и аутентификацию пользователей.

Чтобы настроить глобальные параметры безопасности

  1. Перейдите на панель управления Jenkins на своем сервере. Чтобы сделать это, перейдите к HTTP: // <имя_сервера>: 8080, где <имя_сервера> имя компьютера , на котором вы установили Дженкинс.
  2. На приборной панели Дженкинс, нажмите кнопку Управление Дженкинс, а затем нажмите кнопку Настройка глобальной безопасности.
  3. На странице Настройка глобальной безопасности, нажмите Включить защиту, а затем нажмите кнопку Сохранить.

Дополнительные сведения о настройке параметров безопасности для Jenkins, см Быстрая и простая безопасность , настройка стандарт безопасности , а также Обеспечение безопасности Дженкинс .

Создать проект Jenkins

Затем создайте проект для непрерывного интеграционного тестирования вашего приложения с помощью Firebase Test Lab.

Чтобы создать проект Jenkins

  1. Перейдите на панель управления Jenkins на своем сервере. Чтобы сделать это, перейдите к HTTP: // <имя_сервера>: 8080, где <имя_сервера> имя компьютера , на котором вы установили Дженкинс.
  2. На приборной панели Дженкинс, нажмите кнопку Новый элемент.
  3. Введите имя для проекта в поле Имя товара:
    • Выберите Freestyle проект по созданию проекта , который использует одну конфигурацию сборки.
    • Выберите проект мульти-конфигурации сборки , чтобы создать проект , который работает на нескольких различных конфигурациях сборки. Если вы планируете создавать свое приложение с различными конфигурациями сборки (несколько языков, несколько уровней Android API и т. Д.), То лучшим выбором будет проект с несколькими конфигурациями.
  4. Нажмите кнопку Сохранить.

После того, как ваш проект будет создан, ваш веб-браузер отобразит главную страницу вашего проекта.

Добавить контроль версий и шаги сборки Gradle

В этом разделе описывается, как интегрировать Jenkins с системами контроля версий, такими как GitHub, и как добавить шаги сборки Gradle для сборки пакетов APK из исходного кода.

Интеграция с GitHub и другими системами контроля версий

Если вы используете GitHub или другую систему контроля версий для управления исходным кодом вашего приложения, вы можете настроить Jenkins для запуска автоматических сборок и запускать тесты каждый раз, когда обновления вашего приложения регистрируются. Вы также можете настроить Jenkins для периодического запуска сборок.

Чтобы узнать о настройке сборки в Дженкинс см Настройка автоматической сборки .

Добавление шагов сборки Gradle для пересборки пакетов APK

Если вы используете систему контроля версий для управления исходным кодом вашего приложения, вам необходимо включить этап сборки Gradle для создания новых двоичных файлов APK каждый раз, когда Jenkins загружает исходный код из вашей системы контроля версий.

  1. Добавьте шаг сборки для выполнения следующих команд в главном каталоге для приложения:

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

  2. Добавьте этап сборки, чтобы использовать пакеты APK, созданные Gradle, при тестировании с помощью Test Lab. Вы можете использовать этот путь , как <local_server_path> в примере сценария оболочки , представленной ниже, где <AppFolder> является папка проекта Android - студия для вашего приложения:

    <AppFolder>/app/build/outputs/apk
    

Добавить шаги сборки Test Lab в Jenkins

Теперь вы готовы добавить в Jenkins этап сборки для запуска Test Lab с помощью командной строки gcloud.

Чтобы добавить шаг сборки gcloud

  1. На главной странице вашего проекта, нажмите кнопку Настроить.
  2. На странице конфигурации проекта, прокрутите вниз до раздела сборки, а затем выберите Выполнить оболочку из меню Add шага сборки.

  3. В Дженкинс Execute оболочки окно командной строки, введите следующее, замещающий <local_server_path> для пути примера приложения на сервере, <app_apk> для APK вашего приложения, и <app_test_apk> для испытания APK вашего приложения:

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

Анализировать результаты тестирования

После Lab Test завершает тестирование вашего приложения, вы можете просмотреть результаты тестирования в Firebase консоли или в виде Google Cloud Storage ведра в вашем проекте. Вы можете также добавить gsutil команды оболочки команды , показанной выше , чтобы скопировать данные результатов тестирования на локальный компьютер. Чтобы узнать больше, см Анализ результатов Firebase Lab Test .

Непрерывная интеграция с другими системами CI

Чтобы узнать, как использовать Firebase Test Lab с другими системами CI, ознакомьтесь с их документами: