XDevice

• Введение
• Структура директорий
• Ограничения
• Использование
• Задействованные репозитории

Введение

XDevice — это основной модуль тестовой среды OpenHarmony, который предоставляет услуги, на которых зависят тестовые случаи.

XDevice состоит из следующих подмодулей:

• command: позволяет взаимодействовать между пользователями и тестовой платформой на основе команд. Парсит и обрабатывает команды пользователей.
• config: устанавливает конфигурации тестовой среды и предоставляет различные варианты конфигураций для подключения через последовательный порт и USB.
• driver: выполняет тестовые случаи, определяет основные шаги тестирования, такие как распределение тестовых случаев, их выполнение и сбор результатов.
• report: парсит результаты тестирования и генерирует отчеты о тестировании.
• scheduler: планирует различные исполнители тестовых случаев в тестовой среде.
• environment: настраивает среду тестирования, обеспечивая обнаружение устройств и управление ими.
• testkit: предоставляет тестовые инструменты для реализации парсинга JSON, монтирования сетевых файлов и т.д.
• resource: предоставляет файл конфигурации подключения устройства и определения шаблонов отчетов.## Структура директорий

xdevice
├── config                            # Конфигурация XDevice
│     ├── user_config.xml             # Конфигурация окружения XDevice
├── src                               # Исходный код
│     ├── xdevice
├── plugins                           # Плагины XDevice
│     ├── ohos                        # Плагины OpenHarmony
|          ├── src                    # Исходный код плагинов OpenHarmony
│          └── setup.py               # Скрипт установки плагинов

• Установка XDevice

  1. Перейдите в директорию установки XDevice.

  2. Откройте консольное окно и выполните следующую команду:

     python setup.py install

• Установка расширения

  1. Перейдите в директорию установки расширения XDevice.

  2. Откройте консоль и выполните следующую команду:

     python setup.py install

• Изменение файла user_config.xml

  Настройте информацию о вашем окружении в файле user_config.xml.

  1. Настройка окружения.

  • Для устройств, поддерживающих подключение hdc, обратитесь к следующей заметке для настройки окружения. > ЗАМЕЧАНИЕ:

    ip/port: IP-адрес и порт удаленного устройства. По умолчанию параметр остается пустым, что указывает на использование локального устройства (IP-адрес: 127.0.0.1; порт: порт, используемый для старта hdc). sn: SN тестового устройства, указанного для выполнения команд. Если этот параметр установлен на SN1, только устройство SN1 может выполнять последующие команды run. В этом случае другие устройства считаются Ignored и не участвуют в выполнении команд. Вы можете выполнить команду list devices и проверить значение Allocation, чтобы просмотреть значения sn. Вы можете задать несколько SN и разделить их точкой с запятой (;). - Для устройств, поддерживающих подключение через последовательный порт, обратитесь к следующей заметке для настройки окружения. > ЗАМЕЧАНИЕ: type: режим подключения устройства. Режим com указывает на подключение устройства через последовательный порт. label: тип устройства, например, wifiiot serial: последовательный порт

    • serial/com: последовательный порт для локального подключения, например, COM20
    • serial/type: тип последовательного порта. Значение может быть cmd (последовательный порт для выполнения тест-кейсов) или deploy (последовательный порт для обновления системы). Для открытого проекта последовательные порты cmd и deploy совпадают, и их значения com также совпадают. serial/baud_rate, data_bits, stop_bits и timeout: параметры последовательного порта. Вы можете использовать значения по умолчанию. 2. Установите директорию тестового случая.

  dir: директория тестового случая

  3. Монтируйте NFS.

  ЗАМЕЧАНИЕ: server: конфигурация монтирования NFS. Установите значение на NfsServer. server/ip: IP-адрес среды монтирования server/port: номер порта среды монтирования server/username: имя пользователя для входа на сервер server/password: пароль для входа на сервер server/dir: внешний путь монтирования server/remote: указывает, развернуты ли сервер NFS и исполнитель XDevice на разных устройствах. Если да, установите этот параметр на true. В противном случае, установите его на false.- Укажите тип задачи.

• Запустите тестовую среду.

• Выполните тестовые команды.

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

  help

  Запрашивает справочную информацию о командах тестовой среды.

  help:
       Используйте help для получения информации.  
  usage:
       run:  Отображает список поддерживаемых команд run.
       list: Отображает список поддерживаемых устройств и записей задач.  
  Примеры:
       help run
       help list

  ЗАМЕЧАНИЕ: help run: отображает описание команд run. help list: отображает описание команд list.

  list

  Отображает информацию о устройствах и связанных с ними записях задач.

  list:
       Эта команда используется для отображения списка устройств и записей задач.  
  usage:
        list
        list history
        list <id>  
  Введение:
       list:         отображает список устройств
       list history: отображает историческую запись последовательности задач
       list <id>:    отображает историческую запись задач, содержащих конкретный идентификатор  
  Примеры:
       list
       list history
       list 6e****90
  ```    >![](figures/icon-note.gif) **ЗАМЕЧАНИЕ:** 
  >**list**: отображает информацию о устройствах.
  >**list history**: отображает историческую информацию о задачах.
  >**list <id\>**: отображает историческую информацию о задачах с указанными идентификаторами.    **запуск**  
  

В данном тексте нет необходимости в переводе, так как все слова и фразы уже переведены на русский язык. Выполняет тестовые задачи. run: Этот командный файл используется для выполнения выбранных тестовых случаев. Он включает в себя серию процессов, таких как компиляция сценариев использования, выполнение и сбор результатов. usage: run [-l TESTLIST [TESTLIST . . . ] | -tf TESTFILE [TESTFILE . . . ]] [-tc TESTCASE] [-c CONFIG] [-sn DEVICE_SN] [-rp REPORT_PATH [REPORT_PATH . . . ]] [-respath RESOURCE_PATH [RESOURCE_PATH . . . ]] [-tcpath TESTCASES_PATH [TESTCASES_PATH . . . ]] [-ta TESTARGS [TESTARGS . . . ]] [-pt] [-env TEST_ENVIRONMENT [TEST_ENVIRONMENT . . . ]] [-e EXECTYPE] [-t [TESTTYPE [TESTTYPE . . . ]]] [-td TESTDRIVER] [-tl TESTLEVEL] [-bv BUILD_VARIANT] [-cov COVERAGE] [--retry RETRY] [--session SESSION] [--dryrun] [--reboot-per-module] [--check-device] [--repeat REPEAT] action task Укажите тесты для выполнения. позиционные аргументы: action Укажите действие task Укажите имя задачи, например "ssts", "acts", "hits" >! Примечание: >Структура базовой команды run следующая: > >run [task name] -l module1;module2 > >task name: тип задачи. Этот параметр является необязательным. Обычно значение равно ssts, acts или hits. >-l: тестовые случаи для выполнения. Используйте точки с запятой (;) для разделения каждого тестового случая. >module: модуль для тестирования. Обычно в директории testcases находится файл .json этого модуля. >Кроме того, к этой команде могут быть добавлены другие параметры в качестве ограничений. Общие параметры следующие: >-sn: указывает устройства для выполнения тестовых случаев. Если этот параметр установлен на SN1, только устройство SN1 выполнит тестовые случаи. >-c: указывает новый файл user_config.xml. >-rp: указывает путь, где будет сгенерирован отчет. По умолчанию это директория xxx/xdevice/reports. Приоритет указанного пути выше по сравнению с умолчанием. >-tcpath: указывает среду тестирования, которая по умолчанию равна xxx/xdevice/testcases. Приоритет указанного пути выше по сравнению с умолчанием. >-respath: указывает директорию тестового набора, которая по умолчанию равна xxx/xdevice/resource. Приоритет указанного пути выше по сравнению с умолчанием. >--reboot-per-module: перезапускает устройство перед выполнением тестовых случаев. - Просмотрите результат выполнения. После выполнения команд run тестовый фреймворк отображает соответствующие логи на консоли и генерирует отчет о выполнении в директорию, указанную параметром -rp. Если параметр не установлен, отчет будет сгенерирован в директории по умолчанию.

```
Структура директории отчета (по умолчанию или указанной)
     ├── result # Результаты выполнения тестовых случаев модуля
     │     ├── module name.xml
     │     ├── ... ...
     │      
     ├── log # Логи выполнения устройств и задач
     │     ├── device 1.log
     │     ├── ... ...
     │     ├── task.log
     ├── summary_report.html # Визуальный отчет
     ├── statistics_report.html # Статистический отчет
     └── ... ...
```

Вовлеченные репозитории

testing subsystem

test_xdevice

test_developertest