Параметризованный GTest для тестирования HAL

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

Базовая настройка теста

Класс GTest должен наследовать базовый класс testing::TestWithParam , параметром которого является имя каждого экземпляра. В методе SetUp можно создать экземпляр сервиса на основе имени экземпляра, как показано в следующем фрагменте кода.

// The main test class for the USB hidl HAL
class UsbHidlTest : public testing::TestWithParam<std::string> {

 virtual void SetUp() override {
   usb = IUsb::getService(GetParam());
   ASSERT_NE(usb, nullptr);
...
 }

Для каждого метода тестирования используйте макрос TEST_P , как показано в следующем примере:

TEST_P(UsbHidlTest, setCallback) {
...
}

Создайте экземпляр набора тестов с помощью макроса INSTANTIATE_TEST_SUITE_P , как показано в следующем примере:

INSTANTIATE_TEST_SUITE_P(
       PerInstance, UsbHidlTest,
       testing::ValuesIn(android::hardware::getAllHalInstanceNames(IUsb::descriptor)),
       android::hardware::PrintInstanceNameToString);

Аргументы таковы:

  1. InstantiationName может быть любым значением, соответствующим вашему тесту. PerInstance — это распространённое имя.

  2. Название тестового класса.

  3. Коллекция имен экземпляров, которые можно получить, например, с помощью встроенного метода getAllHalInstanceNames .

  4. Метод для вывода имени тестового метода. PrintInstanceNameToString — это встроенное имя, которое можно использовать для формирования имени теста на основе имени экземпляра и имени тестового метода.

Тестирование с несколькими входными данными

GTest поддерживает кортежи для тестов с параметризацией значений. Когда тест HAL требует проверки с несколькими входными данными (например, тест с несколькими интерфейсами), вы можете написать GTest, используя tuple в качестве параметра теста. Полный код можно найти в VtsHalGraphicsMapperV2_1TargetTest .

В отличие от теста GTest с одним параметром, в этом тесте в качестве параметра используется tuple , как показано в следующем примере:

class GraphicsMapperHidlTest
   : public ::testing::TestWithParam<std::tuple<std::string, std::string>> {
 protected:
   void SetUp() override {
       ASSERT_NO_FATAL_FAILURE(mGralloc = std::make_unique<Gralloc>(std::get<0>(GetParam()),
                                                                    std::get<1>(GetParam())));
…
}

Если требуются более сложные параметры, рекомендуется использовать структуру и пользовательские функции GTest ToString .

Для создания экземпляра набора тестов также используется макрос INSTANTIATE\_TEST\_CASE\_P , с двумя отличиями:

  • Третий аргумент представляет собой набор кортежей (в отличие от набора строк в базовом случае).
  • Метод для компиляции имени теста должен поддерживать tuple . Вы можете использовать встроенный метод PrintInstanceTupleNameToString , который может обрабатывать кортежи строк, как показано в следующем примере: 
INSTANTIATE_TEST_CASE_P(
       PerInstance, GraphicsMapperHidlTest,
       testing::Combine(
               testing::ValuesIn(
                       android::hardware::getAllHalInstanceNames(IAllocator::descriptor)),
           testing::ValuesIn(android::hardware::getAllHalInstanceNames(IMapper::descriptor))),
       android::hardware::PrintInstanceTupleNameToString<>);