/wayland-java-bindings

The Wayland [protocol] Java [language] Bindings

Primary LanguageJavaApache License 2.0Apache-2.0

wayland-java-bindings

Build Status The Wayland protocol Java-language Binding

Javadoc

Here

Using

Bindings are available in the maven central repository:

 <dependency>
  <groupId>org.freedesktop</groupId>
  <artifactId>wayland</artifactId>
  <version>1.4.0</version>
 </dependency>

Building

Run mvn install in the root of the project and add the following maven dependency to start using the bindings:

 <dependency>
  <groupId>org.freedesktop</groupId>
  <artifactId>wayland</artifactId>
  <version>1.4.1-SNAPSHOT</version>
 </dependency>

Private protocol

The project allows you to generate your own private wayland protocol bindings. Add

 <dependency>
  <groupId>org.freedesktop</groupId>
  <artifactId>generator</artifactId>
  <version>1.4.0</version>
  <scope>provided</scope>
 </dependency>

to your build path, no need to put it on your classpath as it will only be used during compilation.

Add

 <dependency>
  <groupId>org.freedesktop</groupId>
  <artifactId>stubs</artifactId>
  <version>1.4.0</version>
 </dependency>

to your classpath.

Add a @Protocols annotation to your own private package-info.java file and set it to use your own private protocol xml file. Here's an example.

Build your project with maven (or gradle). The generated bindings should automatically appear in the same package as your package-info.java file.

State

  • Usable.
  • Pure Java (Jaccall)

Known Issues

  • See issues board.

TODO

  • Unit tests.
  • Debug logging.

License

Copyright 2015 Erik De Rijcke

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.