Запуск сканирования

Запуск сканирования может быть произведен в ручном или в автоматическом режиме. Для запуска сканирования выберите пункт основного меню Сканы и нажмите кнопку Добавить сканирование в правом верхнем углу.

Выберите или перетащите на появившуюся страницу Добавить сканирование apk-файл, aab-файл (в формате Android App Bundle), ipa-файл или zip-файл, содержащий split apk сканируемого приложения.

Примечание

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

После выбора файла на странице Добавить сканирование будут представлены необходимые для запуска анализа приложения поля:

Информация о файле тестируемого приложения: имя пакета, название/код версии, Target SDK, Min SDK, имя/размер/хеш файла и тип архитектуры.
Проект — проект, в рамках которого будет проводиться сканирование. По умолчанию в этом поле предлагается опция Создать проект автоматически. Если приложение сканируется в системе впервые, можно предварительно не создавать для него проект и профиль, а использовать данную опцию. В этом случае будут автоматически созданы проект и профиль с именем сканируемого пакета, указанном в поле Имя пакета.

Примечание

Если проект был уже однажды создан автоматически, а при повторной загрузке приложения была вновь выбрана опция Создать проект автоматически, система не будет создавать новый проект, а использует ранее автоматически созданный проект.

Чтобы указать существующий проект, нажмите на поле Проект и выберите необходимое значение из выпадающего списка.

Примечание

Для выбора доступны либо проекты с незаполненным при создании полем Имя пакета (см. раздел «Проекты»), либо те, для которых в данном поле указан пакет, выбранный в предыдущем шаге. Таким образом, не исключена ситуация, когда в данном поле будут отсутствовать доступные для выбора элементы. В этом случае следует создать новый проект с пустым полем Имя пакета или, указав в нем соответствующий пакет.
Профиль — профиль сканирования, для которого будет проводиться сканирование. По умолчанию в этом поле предлагается опция Создать профиль автоматически. Данная опция в поле Профиль работает аналогично приведенному выше ее описанию для поля Проект.

Чтобы указать существующий профиль, нажмите на поле Профиль и выберите необходимое значение из выпадающего списка.
Режим — ручное или автоматическое сканирование.
Тест-кейс — эта опция появляется в случае выбора автоматического режима и позволяет выбрать тест-кейса, который будет воспроизведен.

Примечание

Отображаются только тест-кейсы выбранного проекта.
Архитектура — архитектура устройства, на котором будет запущено приложение.

Примечание

При отсутствии доступных для выполнения сканирования агентов в поле Архитектура отображается сообщение Отсутствуют запущенные устройства для данной архитектуры.

Автоматическое сканирование

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

Выбрать и загрузить файл мобильного приложения с расширением *.apk, *.aab (в формате Android App Bundle), *.ipa или *.zip, содержащий split apk, для которого будет проводиться сканирование.

Примечание

Если пакет с выбранным именем и хеш-суммой уже загружен, в целях экономии ресурсов его повторная загрузка не производится, а используется файл, уже имеющийся на сервере.
Выбрать проект из выпадающего списка существующих в системе проектов.

Примечание

Для выбора доступны либо проекты с незаполненным при создании полем Имя пакета (см. раздел «Проекты»), либо те, для которых в данном поле указан пакет, выбранный в предыдущем шаге. Таким образом, не исключена ситуация, когда в данном поле будут отсутствовать доступные для выбора элементы. В этом случае следует создать новый проект с пустым полем Имя пакета или, указав в нем соответствующий пакет.
Выбрать профиль сканирования из выпадающего списка.
Выбрать архитектуру, на которой будет проводиться сканирование. Отметим, что в данном поле будет доступна для выбора только та архитектура, на которой был записан тест-кейс и которая активна в системе.
В поле Режим выбрать Автоматическое сканирование из выпадающего списка.
Во вновь появившемся внизу поле выбрать имя уже существующего в системе тест-кейса для запуска сканирования в автоматическом режиме.

По нажатию кнопки Запустить происходит запуск сканирования и переход на страницу Сканирование. Будет отображена страница с экраном устройства без возможности взаимодействия с ним. Передача изображения с экрана устройства необходима для анализа работы тест-кейса. В ходе сканирования на экране устройства отображаются следующие статусы:

Поиск свободного устройства — осуществляется поиск свободного сканирующего агента.
Запуск приложения — выполняется запуск приложения.

Во время проведения автоматического сканирования также идет запись видео, которое при завершении доступно на вкладке Запись сканирования на странице с детальными результатами сканирования для данного теста.

При нажатии на кнопку К результатам сканирований будет осуществлен переход к странице со списком всех сканирований. При переходе на страницу Список сканирований можно увидеть новую строку, отображающую текущий результат автоматического сканирования. При нажатии на ID тест-кейса, когда соответствующее сканирование имеет состояние Создан, Запускается или Запущен, происходит возврат на страницу с экраном устройства. После завершения сканирования приложения его состояние примет значение Анализ на время обработки полученных результатов. Затем состояние сканирования поменяется на Успешно или Неуспешно в зависимости от результата. Если нажать на ID тест-кейса, когда сканирование имеет состояние Анализ, Успешно или Неуспешно, произойдет переход на страницу с детальными результатами сканирования, см. раздел «Результаты сканирований».

Ручное сканирование

Для запуска ручного сканирования выберите пункт основного меню Сканы и нажмите кнопку Добавить сканирование в правом верхнем углу. Выберите или перетащите на появившуюся страницу Добавить сканирование apk-файл, aab-файл (в формате Android App Bundle), ipa-файл или zip-файл, содержащий split apk сканируемого приложения. При загрузке файла система определит его архитектуру и отфильтрует все возможные подходящие значения в полях на появившейся странице:

Примечание

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

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

Выбрать проект из выпадающего списка существующих в системе проектов.

Примечание

Для выбора доступны либо проекты с незаполненным при создании полем Имя пакета (см. раздел «Проекты»), либо те, для которых в данном поле указан пакет, выбранный в предыдущем шаге. Таким образом, не исключена ситуация, когда в данном поле будут отсутствовать доступные для выбора элементы. В этом случае следует создать новый проект с пустым полем Имя пакета или, указав в нем соответствующий пакет.
Выбрать профиль сканирования из выпадающего списка.
Выбрать архитектуру, на которой будет проводиться сканирование.
В поле Режим выбрать Ручное сканирование из выпадающего списка.

По нажатию кнопки Запустить происходит запуск сканирования и переход на страницу Сканирование. Будет отображена страница с экраном устройства и с запущенным приложением. Ручное сканирование выглядит, как обычная работа пользователя с приложением. Все действия пользователя записываются в виде последовательности шагов тест-кейса.

После того, как все необходимые действия по сканированию приложения были сделаны, нажмите кнопку Остановить. После нажатия сканирование будет остановлено, система перейдет в режим анализа данных. При нажатии на кнопку К результатам сканирований будет осуществлен переход к странице со списком всех сканирований. Идентифицировать полученные результаты ручного сканирования можно по данным в столбце Изменен.

Следует отметить, что для обработки только что полученных результатов ручного сканирования требуется некоторое время, поэтому для детального просмотра и анализа результатов необходимо дождаться окончания их обработки. Статус сканирования в столбце Состояние может принимать нескольких значений:

Создан — сканирование создано и помещено в очередь сканирования.
Запускается — сканирование уже в обработке и перед запуском проходит необходимая техническая предварительная работа (установка приложения, его запуск и т. д.).
Запущен — происходит процесс сканирования и взаимодействие с приложением, в зависимости от типа сканирования, вручную или через тест-кейсы.
Анализ — взаимодействие с приложением закончено, идет процесс анализа собранных данных.
Неуспешно — сканирование завершилось с ошибкой.
Успешно — сканирование завершено успешно.
Отменен — сканирование отменено с использованием расположенного справа раскрывающегося меню.
Ожидание повторного анализа — был запущен и еще не завершился повторный анализ результатов сканирования.

Запуск сканирования из командной строки

Сканирование приложения можно запустить не только из пользовательского интерфейса системы, но также из командной строки. Процесс формирования командной строки и запуска сканирования подробно описан в разделе «Интеграции».

Запуск сканирования из систем сборки

Для запуска сканирования приложений из систем сборки созданы средства инструментальной поддержки, позволяющие значительно упростить этот процесс.

Запуск сканирования из систем сборки подробно описан в разделе «Интеграции».