| 1 |
D-Bus Java README |
| 2 |
----------------- |
| 3 |
|
| 4 |
Compilation and installation is described in the INSTALL file. |
| 5 |
|
| 6 |
This will install two jar files, three binaries and some documentation in the |
| 7 |
form of an HTML/PDF guide to writing D-Bus Java programs, JavaDoc API for the |
| 8 |
library and man pages for the supplied programs. Read the documentation, it's |
| 9 |
there for a reason. |
| 10 |
|
| 11 |
The installed programs are documented in their respective man pages. |
| 12 |
|
| 13 |
CreateInterface is a tool for creating interface stubs for D-Bus programs. It |
| 14 |
will connect to services running on the bus and introspect on them to find |
| 15 |
their API. This will then be written as Java interface definitions suitable for |
| 16 |
importing into your program. A file containing the introspection data can be |
| 17 |
used instead. |
| 18 |
|
| 19 |
ListDBus lists the names currently connected to a bus. |
| 20 |
|
| 21 |
DBusViewer is a graphical tool which combines the two tools. It will list the |
| 22 |
names on a bus and allow you to introspect on them and save the result as Java |
| 23 |
interface files. This currently only introspects on the root object, however. |
| 24 |
|
| 25 |
To run a Java program using D-Bus you need to have the libdbus-java, |
| 26 |
libunix-java and libdebug jar files in your classpath and the libunix-java |
| 27 |
shared library in your library path. With the default install paths you may |
| 28 |
have to do something like: |
| 29 |
|
| 30 |
java -cp /usr/local/share/java/dbus.jar:/usr/local/share/java/unix.jar:/usr/local/share/java/debug-disable.jar -Djava.library.path=/usr/local/lib/jni |
| 31 |
|
| 32 |
|