GtkSharp/README.md
2019-08-16 19:07:07 +02:00

3.1 KiB

GtkSharp

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 completly separatly from that project.

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)

Build status

Building from source

Pre requirements for building from source are that you have .Net Core and msbuild installed on the system.

To build the repository, first clone it:

git clone https://github.com/GtkSharp/GtkSharp.git
cd GtkSharp

and then simply run either .\build.ps1 or ./build.sh depending your operating system.

If you wish to generate the nuget packages simply add the --BuildTarget=PackageNuGet as an argument when calling the build script.

A breakdown on how the source is structured:

  • Tools that are needed to generate wrapper code are found in Tools folder
  • The actual wrappers code is found in Libs folder
  • Templates are located in Templates folder
  • Build script is separated between build.cake and CakeScripts folder

Using the library

On all systems, the library assumes that you have Gtk installed on your system.

See Installing Gtk on Windows wiki page for more details on how to do it on Windows.

See Installing Gtk on Mac wiki page for more details on how to do it on macOS.

Available NuGet packages:

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

GtkSharp and its related components are licensed under LGPL v2.0 license, while Samples are licenced under The Unlicense.