gtk
Rust bindings and wrappers for GTK 3, part of gtk3-rs.
Minimum supported Rust version
Currently, the minimum supported Rust version is 1.51.0
.
Building
gtk expects GTK, GLib and Cairo development files to be installed on your system. See the GTK installation page.
Using
We recommend using crates from crates.io, as demonstrated here.
If you want to track the bleeding edge, use the git dependency instead:
[]
= { = "https://github.com/gtk-rs/gtk3-rs.git" }
Avoid mixing versioned and git crates like this:
# This will not compile
[]
= "0.13"
= { = "https://github.com/gtk-rs/gtk3-rs.git" }
Documentation
Generate the docs:
> cargo doc --features dox
(if the installed GTK+ version is lower than 3.16, adjust the feature name accordingly).
Contribute
Contributor you're welcome!
See the general bindings documentation.
Most of the bindings (src/auto
) are generated by gir using this configuration file. After editing Gir.toml
the sources can be regenerated with
> make gir
When opening a PR please put the changes to the src/auto
directory in a separate commit.
You may also wish to run cargo clippy -- -D warnings
and check that you're clean because
otherwise you may be surprised when CI fails.
See Also
License
gtk is available under the MIT License, please refer to it.