HAL testi için parametreli GTest

HAL arayüzü için birden fazla uygulama olabilir. HAL uygulamasının her örneğini test etmek için standart yöntem, değer parametreli bir GTest yazmaktır.

Temel test kurulumu

GTest, testing::TestWithParam temel sınıfını devralmalıdır. Bu sınıfta parametre, her örneğin adıdır. SetUp yönteminde, hizmet aşağıdaki kod snippet'inde gösterildiği gibi örnek adına göre örneklendirilebilir.

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

Her test yöntemi için aşağıdaki örnekte gösterildiği gibi TEST_P makrosunu kullanın:

TEST_P(UsbHidlTest, setCallback) {
...
}

Aşağıdaki örnekte gösterildiği gibi paketi INSTANTIATE_TEST_SUITE_P makrosuyla örneklendirin:

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

Bağımsız değişkenler şunlardır:

  1. InstantiationName, testinizle eşleşen herhangi bir şey olabilir. PerInstance yaygın bir addır.

  2. Test sınıfının adı.

  3. Yerleşik yöntemden alınabilen örnek adları koleksiyonu (ör. getAllHalInstanceNames).

  4. Test yöntemi adını yazdırma yöntemi. PrintInstanceNameToString, örnek adına ve test yöntemi adına göre bir test adı derlemek için kullanabileceğiniz yerleşik bir addır.

Birden fazla girişle test etme

GTest, değer parametreli testler için tuple'leri destekler. Bir HAL testinin birden fazla girişle test edilmesi gerektiğinde (ör. birden fazla arayüz içeren bir test), test parametresi olarak tuple içeren bir GTest yazabilirsiniz. Kodun tamamını VtsHalGraphicsMapperV2_1TargetTest adresinde bulabilirsiniz.

Tek bir test parametresi içeren GTest'e kıyasla bu testin, aşağıdaki örnekte gösterildiği gibi test parametresi olarak tuple kullanması gerekir:

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

Daha karmaşık parametrelere ihtiyaç duyuluyorsa yapı ve özel GTest ToString işlevleri kullanmanız önerilir.

Test paketini örneklemek için INSTANTIATE\_TEST\_CASE\_P makrosu da kullanılır. Bu makroda iki fark vardır:

  • Üçüncü bağımsız değişken, temel durumdaki dize koleksiyonunun aksine bir tuple koleksiyonudur.
  • Test adını derleme yönteminin tuple'ü desteklemesi gerekir. Aşağıdaki örnekte gösterildiği gibi, dize tuple'lerini işleyebilecek yerleşik PrintInstanceTupleNameToString yöntemini kullanabilirsiniz:
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<>);