GTest parametrizado para pruebas de HAL

En el caso de una interfaz HAL, puede haber varias implementaciones. Para probar cada instancia de una implementación de HAL, la forma estándar es escribir una GTest con parámetros de valor.

Configuración básica de las pruebas

La GTest debe heredar la clase base testing::TestWithParam, cuyo parámetro es el nombre de cada instancia. En el método SetUp, el servicio se puede crear una instancia según el nombre de la instancia, como se muestra en el siguiente fragmento de código.

// 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);
...
 }

Para cada método de prueba, usa la macro TEST_P como se muestra en el siguiente ejemplo:

TEST_P(UsbHidlTest, setCallback) {
...
}

Crea una instancia del conjunto con la macro INSTANTIATE_TEST_SUITE_P, como se muestra en el siguiente ejemplo:

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

Los argumentos son:

  1. InstantiationName, que puede ser cualquier elemento que coincida con tu prueba. PerInstance es un nombre común.

  2. El nombre de la clase de prueba.

  3. Una colección de nombres de instancias, que se pueden recuperar del método integrado, por ejemplo, getAllHalInstanceNames.

  4. El método para imprimir el nombre del método de prueba. PrintInstanceNameToString es un nombre integrado que puedes usar para compilar un nombre de prueba basado en el nombre de la instancia y el nombre del método de prueba.

Prueba con varias entradas

GTest admite tuplas para pruebas con parámetros de valor. Cuando una prueba de HAL requiere pruebas con varias entradas (por ejemplo, una prueba con varias interfaces), puedes escribir una GTest con tuple como parámetro de prueba. El código completo se puede encontrar en VtsHalGraphicsMapperV2_1TargetTest.

En comparación con la GTest con un solo parámetro de prueba, esta prueba debe usar tuple como parámetro de prueba, como se muestra en el siguiente ejemplo:

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())));
…
}

Si se necesitan parámetros más complicados, se recomienda usar una estructura y funciones ToString de GTest personalizadas.

Para crear una instancia del paquete de pruebas, también se usa la macro INSTANTIATE\_TEST\_CASE\_P, con dos diferencias:

  • El tercer argumento es una colección de tuplas (en lugar de una colección de cadenas en el caso básico).
  • El método para compilar un nombre de prueba debe admitir tuple. Puedes usar el método integrado PrintInstanceTupleNameToString, que puede controlar tuplas de cadenas, como se muestra en el siguiente ejemplo:
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<>);