GtkSharp/README.md

60 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

# GtkSharp
2021-03-19 17:18:08 +00:00
GtkSharp is a C# wrapper for Gtk and its related components. The component list includes the following libraries: glib, gio, cairo, pango, atk, gdk. This is a fork of https://github.com/mono/gtk-sharp and is maintained completely separately from that project.
2018-07-30 19:39:01 +00:00
Differences can be seen with the following table:
| | Target framework | Target Gtk Version | Extra notes |
|:--------------|:-------------------|:---------------------------------------------------|:------------------------------|
| GtkSharp | .NET Standard 2.0 | Gtk 3.22 | Does not need glue libraries. |
| mono/gtksharp | .NET Framework 4.5 | Gtk 2 (also Gtk 3.0 but never officially released) | |
* [Building from source](#building-from-source)
* [Using the library](#using-the-library)
* [License](#license)
## Building from source
2022-01-26 17:50:22 +00:00
Pre requirements for building from source are that you have .Net 6 installed on the system.
2022-01-26 17:50:22 +00:00
To build the repository, simply do:
```sh
2017-10-30 19:43:08 +00:00
git clone https://github.com/GtkSharp/GtkSharp.git
cd GtkSharp
2022-01-26 17:50:22 +00:00
dotnet tool restore
dotnet cake build.cake
```
A breakdown on how the source is structured:
* Tools that are needed to generate wrapper code are found in [Tools](Source/Tools) folder
* The actual wrappers code is found in [Libs](Source/Libs) folder
* Templates are located in [Templates](Source/Templates) folder
* Build script is separated between [build.cake](build.cake) and [CakeScripts](CakeScripts) folder
## Using the library
2019-11-10 19:00:57 +00:00
On macOS, you'll need to manually install Gtk, see [Installing Gtk on Mac](https://github.com/GtkSharp/GtkSharp/wiki/Installing-Gtk-on-Mac) wiki page for more details on how to do it.
2017-10-30 13:44:32 +00:00
Available NuGet packages:
* [GtkSharp](https://www.nuget.org/packages/GtkSharp/)
* [GdkSharp](https://www.nuget.org/packages/GdkSharp/)
* [GioSharp](https://www.nuget.org/packages/GioSharp/)
* [GLibSharp](https://www.nuget.org/packages/GLibSharp/)
* [AtkSharp](https://www.nuget.org/packages/AtkSharp/)
* [PangoSharp](https://www.nuget.org/packages/PangoSharp/)
* [CairoSharp](https://www.nuget.org/packages/CairoSharp/)
2020-08-03 19:41:02 +00:00
* [GtkSourceSharp](https://www.nuget.org/packages/GtkSourceSharp/)
2017-10-30 13:44:32 +00:00
To create a new gtk app project, simply use `dotnet new` templating engine:
* install: `dotnet new --install GtkSharp.Template.CSharp`
* uninstall: `dotnet new --uninstall GtkSharp.Template.CSharp`
* generate project: `dotnet new gtkapp`
## License
2018-01-25 23:13:36 +00:00
GtkSharp and its related components are licensed under [LGPL v2.0 license](LICENSE), while [Samples](Source/Samples) are licenced under [The Unlicense](Source/Samples/LICENSE).