From 3426dcfec2b4d5c755024c355f323ecc9f656e4a Mon Sep 17 00:00:00 2001 From: Colomban Wendling Date: Wed, 5 Apr 2023 15:39:25 +0200 Subject: vcl gtk3: Introduce AT-SPI2 tests for the GTK3 accessibility layer Add tests for the GTK3 accessibility platform layer. These tests compare the internal LO representation with what is visible to the platform, and thus the user's accessibility tools. In most cases the tests are fairly trivial as LO's internals are not far off AT-SPI2's expectations. There are however notable exceptions like for example the text attributes, that have a wildly different representation and require more complex checks matching what LO's platform layer does, the other way around. These tests use libatspi2 directly, but as the C API is awful to work with regarding resource management, there are wrappers to handle the complexity using RAII. The resulting API is fairly trivial to use. As these tests require using the GTK3 VCL plugin and for the a11y tree to be visible to AT-SPI2, they are run under XVFB using a separate dbus session through dbus-launch. Working on this has already lead to reporting and/or solving some issues: * https://gerrit.libreoffice.org/c/core/+/151303 * https://gerrit.libreoffice.org/c/core/+/151650 * https://gerrit.libreoffice.org/c/core/+/152456 * https://gerrit.libreoffice.org/c/core/+/152457 * https://bugs.documentfoundation.org/show_bug.cgi?id=155625 * https://bugs.documentfoundation.org/show_bug.cgi?id=155705 * https://gerrit.libreoffice.org/c/core/+/152748 Only a subset of the a11y APIs are covered for the moment, but the current state should make it easy to extend upon. Change-Id: I1a047864ce8dc1f1bc3056ad00159f7fd5e5b7d3 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/153069 Tested-by: Jenkins Reviewed-by: Michael Weghorn --- vcl/CppunitTest_vcl_gtk3_a11y.mk | 61 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 vcl/CppunitTest_vcl_gtk3_a11y.mk (limited to 'vcl/CppunitTest_vcl_gtk3_a11y.mk') diff --git a/vcl/CppunitTest_vcl_gtk3_a11y.mk b/vcl/CppunitTest_vcl_gtk3_a11y.mk new file mode 100644 index 000000000000..0981a21857d2 --- /dev/null +++ b/vcl/CppunitTest_vcl_gtk3_a11y.mk @@ -0,0 +1,61 @@ +# -*- Mode: makefile-gmake; tab-width: 4; indent-tabs-mode: t -*- +# +# This file is part of the LibreOffice project. +# +# This Source Code Form is subject to the terms of the Mozilla Public +# License, v. 2.0. If a copy of the MPL was not distributed with this +# file, You can obtain one at http://mozilla.org/MPL/2.0/. +# + +# hack plugging into the CppunitTest machinery yet using a xvfb-wrapper GTK3 run +$(call gb_CppunitTest_get_target,vcl_gtk3_a11y) : gb_TEST_ENV_VARS += SAL_USE_VCLPLUGIN=gtk3 +ifeq (,$(VCL_GTK3_TESTS_NO_XVFB)) +$(call gb_CppunitTest_get_target,vcl_gtk3_a11y) : \ + ICECREAM_RUN += $(XVFB_RUN) $(DBUS_LAUNCH) --exit-with-session +endif + +$(eval $(call gb_CppunitTest_CppunitTest,vcl_gtk3_a11y)) + +$(eval $(call gb_CppunitTest_add_exception_objects,vcl_gtk3_a11y, \ + vcl/qa/cppunit/a11y/atspi2/atspiwrapper \ + vcl/qa/cppunit/a11y/atspi2/atspi2 \ + vcl/qa/cppunit/a11y/atspi2/atspi2text \ +)) + +$(eval $(call gb_CppunitTest_set_include,vcl_gtk3_a11y,\ + $$(INCLUDE) \ + $$(ATSPI2_CFLAGS) \ +)) + +$(eval $(call gb_CppunitTest_add_libs,vcl_gtk3_a11y,\ + $$(ATSPI2_LIBS) \ +)) + +$(eval $(call gb_CppunitTest_use_libraries,vcl_gtk3_a11y, \ + sal \ + cppu \ + subsequenttest \ + test \ + i18nlangtag \ + unotest \ + vcl \ +)) + +$(eval $(call gb_CppunitTest_use_externals,vcl_gtk3_a11y,\ + boost_headers \ +)) + +$(eval $(call gb_CppunitTest_use_api,vcl_gtk3_a11y,\ + offapi \ + udkapi \ +)) + +$(eval $(call gb_CppunitTest_use_sdk_api,vcl_gtk3_a11y)) +$(eval $(call gb_CppunitTest_use_rdb,vcl_gtk3_a11y,services)) +$(eval $(call gb_CppunitTest_use_ure,vcl_gtk3_a11y)) +$(eval $(call gb_CppunitTest_use_vcl,vcl_gtk3_a11y)) + +$(eval $(call gb_CppunitTest_use_instdir_configuration,vcl_gtk3_a11y)) +$(eval $(call gb_CppunitTest_use_common_configuration,vcl_gtk3_a11y)) + +# vim: set noet sw=4 ts=4: -- cgit