Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bailuk/java-gtk
GTK bindings for Java
https://github.com/bailuk/java-gtk
gtk-java gtk4 java library
Last synced: 2 months ago
JSON representation
GTK bindings for Java
- Host: GitHub
- URL: https://github.com/bailuk/java-gtk
- Owner: bailuk
- License: mit
- Created: 2021-09-08T19:45:28.000Z (over 3 years ago)
- Default Branch: stage
- Last Pushed: 2024-02-15T20:51:11.000Z (11 months ago)
- Last Synced: 2024-10-25T09:13:45.781Z (2 months ago)
- Topics: gtk-java, gtk4, java, library
- Language: Kotlin
- Homepage:
- Size: 9.29 MB
- Stars: 108
- Watchers: 4
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/bailuk/java-gtk/actions/workflows/build-on-debian.yml)
[](https://github.com/bailuk/java-gtk/actions/workflows/build-on-fedora.yml)
[](https://github.com/bailuk/java-gtk/actions/workflows/build-on-ubuntu.yml)
[](https://github.com/bailuk/java-gtk/actions/workflows/build-on-windows.yml)
[](https://jitpack.io/#bailuk/java-gtk)
# Java-GTK
GTK 4 bindings for Java.
It uses [Java Native Access (JNA)](https://github.com/java-native-access/jna) to access GTK libraries.
[](examples/src/main/java/examples/ImageBridge.java)
## Example
```java
package examples;
import ch.bailu.gtk.gio.ApplicationFlags;
import ch.bailu.gtk.gtk.Application;
import ch.bailu.gtk.gtk.ApplicationWindow;
import ch.bailu.gtk.gtk.Button;
import ch.bailu.gtk.type.Strs;
public class HelloWorld {
public static void main(String[] args) {
var app = new Application("com.example.hello",
ApplicationFlags.FLAGS_NONE);
app.onActivate(() -> {
// Create a new window
var window = new ApplicationWindow(app);
// Create a new button
var button = new Button();
// Set button label
button.setLabel("Hello, World!");
// When the button is clicked, close the window
button.onClicked(window::close);
window.setChild(button);
window.show();
});
// Start application main loop
var result = app.run(args.length, new Strs(args));
// Terminate with exit code
System.exit(result);
}
}
```
## Build and run
`./gradlew generate` or `make gen`
Compiles and runs the code generator. This will generate Java code from [GIR](https://gi.readthedocs.io/en/latest/) files.
- Input: `generator/src/resources/gir/*`
- Output Java: `java-gtk/build/generated/src/main/java/[...]/*.java`
- Configuration: [generator/src/main/kotlin/ch/bailu/gtk/Configuration.kt](generator/src/main/kotlin/ch/bailu/gtk/Configuration.kt)
`./gradlew build` or `make`
Creates library, javadoc and run tests
- Output: jar, javadoc.jar and sources.jar in `libray/build/libs/`
`./gradlew run` or `make run`
Run the default demo application.
There are more demo applications in [examples/src/main/java/examples](examples/src/main/java/examples) including GeoClue2 and Adwaita samples.
- To run on Windows see [doc/windows.md](doc/windows.md)
- To run on MacOS see [doc/macos.md](doc/macos.md)
`make install`
Compile Java library, generate JAR archive and copy JAR archive as artifact to local Maven repository (`~/.m2/repository`).
## Integration
Library and [Javadoc](https://javadoc.jitpack.io/com/github/bailuk/java-gtk/0.5.0/javadoc/) is available via [JitPack](https://jitpack.io).
```kotlin
// build.gradle.kts
plugins {
application
}
repositories {
maven { url = uri("https://jitpack.io") }
}
dependencies {
implementation("com.github.bailuk:java-gtk:0.5.0")
}
application {
mainClass.set("examples.HelloWorld")
}
```
## Modules
- `generator/`: Kotlin application that generates Java code from GIR files (xml parser -> model builder -> writer). GIR files are taken from Debian dev packages.
- `java-gtk/` : java-gtk library depends on generated Java code.
- `examples/` : Some examples to test the bindings. Mostly ported from [https://gitlab.gnome.org/GNOME/gtk/-/tree/main/demos/gtk-demo](https://gitlab.gnome.org/GNOME/gtk/-/tree/main/demos/gtk-demo).
## License
- Files in [generator/src/main/resources/gir/](generator/src/main/resources/gir) are comming from the [GTK project](https://gitlab.gnome.org/GNOME/gtk) and are therefore licensed under the GNU Library General Public License.
- Examples in [examples/src/main/java/examples/gtk4_demo](examples/src/main/java/examples/gtk4_demo) are ported from the [GTK project](https://gitlab.gnome.org/GNOME/gtk/-/tree/main/demos/gtk-demo) and are therefore licensed under the GNU Library General Public License.
- Everything else licensed under the [MIT License](https://en.wikipedia.org/wiki/MIT_License)