bailuk / java-gtk Goto Github PK

View Code? Open in Web Editor NEW

97.0 5.0 7.0 9.51 MB

GTK bindings for Java

License: MIT License

Kotlin 55.05% Java 42.69% Shell 0.57% Makefile 0.97% Dockerfile 0.73%

gtk4 java library gtk-java

java-gtk's Introduction

Java-GTK

GTK 4 bindings for Java. It uses Java Native Access (JNA) to access GTK libraries.

Example

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 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

./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 including GeoClue2 and Adwaita samples.

To run on Windows see doc/windows.md
To run on MacOS see 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 is available via JitPack.

// 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.

License

Files in generator/src/main/resources/gir/ are comming from the GTK project and are therefore licensed under the GNU Library General Public License.
Examples in examples/src/main/java/examples/gtk4_demo are ported from the GTK project and are therefore licensed under the GNU Library General Public License.
Everything else licensed under the MIT License

java-gtk's People

Contributors

Stargazers

Watchers

Forkers

foxyfocus leinardi me6262 wangzhengbo githangar spheenik desiderantes

java-gtk's Issues

macos startup of example causes exception

On Macos 10, 12 and 13 using either java 17 or java 19 with homebrew gtk 4.10.4 on a paired down example from v0.4.0:

results.txt

2023-06-08 10:06:16.095 java[7961:51584] *** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'nextEventMatchingMask should only be called from the Main Thread!'
*** First throw call stack:
(
0 CoreFoundation 0x00007ff80ec2a773 __exceptionPreprocess + 242
1 libobjc.A.dylib 0x00007ff80e98abc3 objc_exception_throw + 48
2 AppKit 0x00007ff8115e72d1 -[NSApplication(NSEvent) _nextEventMatchingEventMask:untilDate:inMode:dequeue:] + 4633
3 libgtk-4.1.dylib 0x00000001094ceb43 poll_func + 179
4 libglib-2.0.0.dylib 0x0000000102b4901b g_main_context_iterate + 349
5 libglib-2.0.0.dylib 0x0000000102b490cc g_main_context_iteration + 55
6 libgio-2.0.0.dylib 0x0000000108d74ca3 g_application_run + 521
7 jna16203219141762940508.tmp 0x00000001029eb17a ffi_prep_go_closure + 1370
8 ??? 0x0000700001efc688 0x0 + 123145334802056
)
libc++abi: terminating with uncaught exception of type NSException

Runs fine on Fedora 38 with openjdk 17.

Invalid Memory Access on windows

whenever i use various Adw related classes in my main method, such as running App.run() just like the example, when running on windows, the program immediately crashes, citing an "Invalid memory access" error. the same thing happens when i use Adw.init().

i am on 0.5.0

the libraries were downloaded from msys2 and added to PATH

Not working, finished with non-zero exit value 139

The example or anything coded with this library isn't working.
I tested it with self compiling and with the jitpack version. Both not working.
the example with "make run" does also not work.

(Running on Garuda Linux, gtk 4 is installed and other gtk 4 application does work)

Question: could this be combined via graalvm in theory?

i am asking because graalvm is pretty cool, and others have managed to get SWING applications to run.

My use case would be more like taking an existing python or ruby code base, commandline stuff,
and add a simple GUI around it. I don't really want to write in C though (Java is ok but Swing is
ugly, and JavaFX does not seem to be supported via Graalvm; also the graalvm team focuses
not so much on GUIs)

Does this binding require that the native library be installed on system?

Hello, I want to know whether Gtk is required to be installed in order for this library to work. This is necessary for systems where Gtk might not be installed like Windows.

Broken button text in FileChooserDialog

This code sample:

public static void main(String[] args) {
    var app = new Application(new Str("example.javagtk.FileChooserDialog"), ApplicationFlags.FLAGS_NONE);
    app.onActivate(() -> {
        var appWin = new ApplicationWindow(app);
        var fcd = new FileChooserDialog(new Str("Open savefile"), appWin, FileChooserAction.OPEN, new Str("Open"));
        appWin.show();
        fcd.show();
    });
    System.exit(app.run(args.length, new Strs(args)));
}

Produces a GTK file chooser dialog with broken button text, seen below:

The broken text seems to be read from an incorrect place in memory by GTK. Pressing any of the buttons in my case also results in a segfault.
This happens on a Debian Unstable machine, using the GTK4 library from apt, and OpenJDK 17 installed through sdkman.

Offer a Gradle Plugin

I'm very interested in this library and I'd like to know if there's any interest in offering a Gradle plugin to ease the code generation aspect. Of course I'm also interested in helping with code if needed.

Support request: Help gtk-kt with GIR

Hello, I know that this is a weird request, so feel free to just say no, but I was wondering if you will be open to help the gtk-kt project ^^
The gtk-kt project is focused on Kotlin native, and not JNA so isn't exactly a direct competitor of your project.
Currently there is only one maintainer that started writing the bindings manually but now he's working on a GIR generator for the Kotlin native code. But it isn't an easy task to do without previous knowledge of GIR so I was wondering if you could help us.
If you are wondering who am I, I'm just an Android developer that would love to be able to write GTK application in Koltin native. I started contributing to the gtk-kt project, very recently and, since I do not have a lot of C interop knowledge, my contributions are mostly on Gradle and pure Kotlin code level. And maybe a little of PR ^^.

Can't build on clean machine due to jcenter redirect

Fix is to add pluginManagement to settings.gradle.kts

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
    }
}

See gradle/gradle#15406