Accessibility/Getting Started: Difference between revisions
m (add formatting) |
|||
| Line 1: | Line 1: | ||
== Prerequisits == | == Prerequisits == | ||
* Working at-spi 2 (D-Bus at-spi) | |||
* Either build Qt 4.8 yourself (see below) or find distribution packages. | |||
== Packages == | == Packages == | ||
For | |||
For openSUSE there is a [https://build.opensuse.org/package/show?package=qt-at-spi&project=KDE%3AQt package]. | |||
Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4. | Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4. | ||
== Getting the Latest Code == | == Getting the Latest Code == | ||
=== Building Qt in your home directory === | === Building Qt in your home directory === | ||
Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet. | Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet. | ||
If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section. | If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section. | ||
git clone git://gitorious.org/qt/qt.git ~/qt4 | git clone git://gitorious.org/qt/qt.git ~/qt4 | ||
cd ~/qt4 | cd ~/qt4 | ||
| Line 20: | Line 26: | ||
You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon. | You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon. | ||
After building Qt, you need to export a few variables so that it will be found by applications. | After building Qt, you need to export a few variables so that it will be found by applications. | ||
| Line 28: | Line 35: | ||
=== Bridge plugin === | === Bridge plugin === | ||
This is the plugin that makes Qt communicate with AT-SPI via | |||
This is the plugin that makes Qt communicate with AT-SPI via D-Bus. | |||
Once you have Qt 4.8, building this plugin is easy. | Once you have Qt 4.8, building this plugin is easy. | ||
| Line 37: | Line 46: | ||
make install | make install | ||
You might need to use qmake-qt4 or | You might need to use <code>qmake-qt4</code> or <code>qmake4</code> if you have qmake default to the Qt 3 version. When building with system Qt, you'll have to use <code>sudo</code> to make install. | ||
When building with system Qt, you'll have to use sudo to make install. | |||
=== Running KDE/Qt applications === | === Running KDE/Qt applications === | ||
Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set: | Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set: | ||
| Line 48: | Line 57: | ||
== Status == | == Status == | ||
Please report problems you encounter on the [[email protected]]. | |||
Please report problems you encounter on the [mailto:[email protected] [email protected]]. | |||
=== Qt 4.8.0 === | === Qt 4.8.0 === | ||
* The basics should work, Orca reads focused widgets | * The basics should work, Orca reads focused widgets | ||
* Many text editing widgets do not updated properly when editing or selecting text | * Many text editing widgets do not updated properly when editing or selecting text | ||
=== Qt 4.8.1 === | === Qt 4.8.1 === | ||
You can grab the 4.8 branch from gitorious. | You can grab the 4.8 branch from gitorious. | ||
* Better support in text editing widgets | * Better support in text editing widgets | ||
| Line 62: | Line 76: | ||
== For More Information == | == For More Information == | ||
* [http://labs.qt.nokia.com/category/labs/accessibility/ Qt labs accessibility blog posts] | * [http://labs.qt.nokia.com/category/labs/accessibility/ Qt labs accessibility blog posts] | ||
* [https://mail.kde.org/mailman/listinfo/kde-accessibility KDE Accessibility mailing list] | * [https://mail.kde.org/mailman/listinfo/kde-accessibility KDE Accessibility mailing list] | ||
* [http://userbase.kde.org/Accessibility Accessibility information for KDE users] | * [http://userbase.kde.org/Accessibility Accessibility information for KDE users] | ||
* [http://userbase.kde.org/Accessibility/Application_Overview Accessibility status of KDE applications] | * [http://userbase.kde.org/Accessibility/Application_Overview Accessibility status of KDE applications] | ||
[[Category:Accessibility]] | |||
Revision as of 16:48, 21 January 2012
Prerequisits
- Working at-spi 2 (D-Bus at-spi)
- Either build Qt 4.8 yourself (see below) or find distribution packages.
Packages
For openSUSE there is a package.
Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4.
Getting the Latest Code
Building Qt in your home directory
Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet.
If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section.
git clone git://gitorious.org/qt/qt.git ~/qt4 cd ~/qt4 git checkout 4.8 ./configure -confirm-license -opensource -no-phonon -debug -no-webkit -fast make -j2
You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon.
After building Qt, you need to export a few variables so that it will be found by applications.
export QTDIR="~/qt4" export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH export PATH=$QTDIR/bin:$PATH export QT_ACCESSIBILITY=1
Bridge plugin
This is the plugin that makes Qt communicate with AT-SPI via D-Bus.
Once you have Qt 4.8, building this plugin is easy.
git clone git://gitorious.org/qt-at-spi/qt-at-spi.git cd qt-at-spi qmake make make install
You might need to use qmake-qt4 or qmake4 if you have qmake default to the Qt 3 version. When building with system Qt, you'll have to use sudo to make install.
Running KDE/Qt applications
Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set:
export QT_ACCESSIBILITY=1
Then start the application in the same terminal.
Status
Please report problems you encounter on the [email protected].
Qt 4.8.0
* The basics should work, Orca reads focused widgets
* Many text editing widgets do not updated properly when editing or selecting text
Qt 4.8.1
You can grab the 4.8 branch from gitorious.
* Better support in text editing widgets