diff options
| -rw-r--r-- | NEWS | 6 | ||||
| -rw-r--r-- | README | 128 | ||||
| -rw-r--r-- | README.md | 51 | ||||
| -rw-r--r-- | atk-adaptor/bridge.c | 2 | ||||
| -rw-r--r-- | meson.build | 2 | ||||
| -rw-r--r-- | tests/atk_test_util.c | 17 |
6 files changed, 72 insertions, 134 deletions
@@ -1,3 +1,9 @@ +What's new in at-spi2-atk 2.37.90: + +* Add support for the new mark and suggestion roles (!21). + +* Meson: add tests option (!22). + What's new in at-spi2-atk 2.34.2: * Meson: don't hard-code shared_library (!19). @@ -1,128 +0,0 @@ -D-Bus AT-SPI ------------- - -This version of at-spi is a major break from version 1.x. -It has been completely rewritten to use D-Bus rather than -ORBIT / CORBA for its transport protocol. - -A page including instructions for testing, project status and -TODO items is kept up to date at: - - http://www.linuxfoundation.org/en/AT-SPI_on_D-Bus - -The mailing list used for general questions is: - - accessibility-atspi@lists.linux-foundation.org - -For bug reports, feature requests, patches or enhancements please use -the AT-SPI project on bugzilla.gnome.org. Use the at-spi2-atk component for -bugs specific to this module. - - http://bugzilla.gnome.org - -A git repository with the latest development code is available at: - - https://git.gnome.org/browse/at-spi2-atk - -Code in this repository depends on at-spi2-core resources. The -at-spi2-core repository can be found at: - - https://git.gnome.org/browse/at-spi2-core - -More information ----------------- - -The project was started with a D-Bus performance review -the results of which are available on the GNOME wiki. Keep in -mind that the D-Bus AT-SPI design documents on this page -have not been kept up to date. - - https://wiki.gnome.org/Accessibility/Documentation/GNOME2/ATSPI2-Investigation - -Other sources of relevant information about AT-SPI and Accessibility -include: - - https://wiki.gnome.org/Accessibility - https://accessibility.kde.org/developer/atk.php - https://people.gnome.org/~billh/at-spi-idl/html/ - - - -Contents of this package ------------------------- - -This package includes libatk-bridge, a library that bridges ATK to the new -D-Bus based AT-SPI, as well as a corresponding module for gtk+ 2.x. Gtk+ 3.x -now links against libatk-bridge directly rather than requiring it to be loaded -as a module. - -These libraries depend on the at-spi2-core code that contains the daemon for -registering applications, D-Bus helper libraries and the AT-SPI D-Bus specifications. - -Building this package ---------------------- - -In order to build at-spi2-atk you will need: - - - Python 3.5 - - Meson - - Ninja - -Additionally, you will need the development files for: - - - libdbus - - GLib - - GTK+ 3.x - - ATK - - AT-SPI - -To build and install this package, you will typically need to run `meson` to -configure the build process, and Ninja to run the compilation and installation -instructions: - - # Configure the build and initialize the build directory - meson _build . - - # Enter the build directory - cd _build - - # Build the project - ninja - - # Install the project - sudo ninja install - -Tests ------ - -To run the test suite, use `meson test` from the build directory. - -Directory structure -------------------- - -The directories within this package are arranged as follows: - - droute - - Contains a framework for registering objects - with a D-Bus connection and for routing messages to - the implementing object. - - Used by the ATK adaptor. - - atk-adaptor - - This directory contains code that bridges - the at-spi to the GTK+ toolkit, and which is - loaded at runtime by GTK+-based Gnome applications. - The 'bridge' automatically registers GTK+-2.0 - applications with the accessibility registry, - and relays UI events from application to registry. - It is also responsible for servicing requests from - the registry to register handlers for specific event - types. - - tests - - Contains tests for atspi. - More details in tests/README diff --git a/README.md b/README.md new file mode 100644 index 0000000..e8c2215 --- /dev/null +++ b/README.md @@ -0,0 +1,51 @@ +# AT-SPI2-ATK - implementation of the ATK interfaces in terms of the libatspi2 API + +What is at-spi2-atk? First let's introduce two of its related modules: + +[ATK] is the Accessibility Toolkit, a set of GObject interfaces that can +be implemented to communicate with assistive technologies (ATs). + +[at-spi2-core] is the Assistive Technology Service Provider Interface, which +provides two things: a set of DBus interfaces for accessibility, and a +C language binding to use those interfaces. + +Applications that provide accessibility through the ATK interfaces +need a way to translate those interfaces to AT-SPI2 DBus calls. This +module, **at-spi2-atk**, provides that translation bridge. Several +things use at-spi2-atk: + +* GTK3 calls ATK directly and assumes that at-spi2-atk is backing it. + +* GTK2 loads a module at runtime to do the same (`atk-adaptor/gtk-2.0` in this module). + +* Chromium. + +* Gnome-shell. + +* Any applications that use ATK directly, like Mozilla Firefox, will + need at-spi2-atk backing them. + +The version control repository and bug tracker are at https://gitlab.gnome.org/GNOME/at-spi2-atk + +## Summary of this repository's contents + +* `atk-adaptor` - Bridges at-spi and the ATK APIs. GTK3 and earlier, +and applications that use ATK like gnome-shell and Chromium, do not +use the at-spi DBus interfaces directly, so they go through ATK, then +libatk-bridge (contained here), libatspi, and then finally DBus to the +accessibility registry daemon. Yes, this is too much layering! In contrast, +GTK4 talks the at-spi DBus interface directly to the registry. + +* `tests` - End-to-end tests between a mock user of ATK and a mock +assistive technology (AT). The tests simulate communication between a +real ATK-enabled application and an AT like a screen reader, via the +registry daemon. + + +* `droute` - Utilities for registering objects with a D-Bus connection +and for routing messages to the implementing object. + + +[ATK]: https://gitlab.gnome.org/GNOME/atk/ +[at-spi2-core]: https://gitlab.gnome.org/GNOME/at-spi2-core/ + diff --git a/atk-adaptor/bridge.c b/atk-adaptor/bridge.c index 8579185..bdb4c70 100644 --- a/atk-adaptor/bridge.c +++ b/atk-adaptor/bridge.c @@ -1055,7 +1055,7 @@ atk_bridge_adaptor_init (gint * argc, gchar ** argv[]) if (dbus_bus_request_name (spi_global_app_data->bus, atspi_dbus_name, 0, &error)) { - g_print ("AT-SPI Recieved D-Bus name - %s\n", atspi_dbus_name); + g_print ("AT-SPI Received D-Bus name - %s\n", atspi_dbus_name); } else { diff --git a/meson.build b/meson.build index 10a2f5b..5edcb9a 100644 --- a/meson.build +++ b/meson.build @@ -1,5 +1,5 @@ project('at-spi2-atk', 'c', - version: '2.34.2', + version: '2.38.0', license: 'LGPLv2.1+', default_options: [ 'buildtype=debugoptimized', diff --git a/tests/atk_test_util.c b/tests/atk_test_util.c index 3e3c08a..366725c 100644 --- a/tests/atk_test_util.c +++ b/tests/atk_test_util.c @@ -52,6 +52,7 @@ run_app (const char *file_name) static AtspiAccessible *try_get_root_obj (AtspiAccessible *obj) { + gchar *name; int i; gint child_count = atspi_accessible_get_child_count (obj, NULL); @@ -59,10 +60,18 @@ static AtspiAccessible *try_get_root_obj (AtspiAccessible *obj) return NULL; } - for (i=0; i<child_count; i++) { - AtspiAccessible *child = atspi_accessible_get_child_at_index (obj,i, NULL); - if (child && !strcmp (atspi_accessible_get_name (child, NULL), "root_object")) - return child; + for (i = 0; i < child_count; i++) { + AtspiAccessible *child = atspi_accessible_get_child_at_index (obj, i, NULL); + if (!child) + continue; + if ((name = atspi_accessible_get_name (child, NULL)) != NULL) { + if (!strcmp (name, "root_object")) { + g_free(name); + return child; + } + g_free(name); + } + g_object_unref (child); } return NULL; |