113 lines
2.9 KiB
Markdown
113 lines
2.9 KiB
Markdown
|
# Generating Sources
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
This is a quick overview of some of the commands to run when updating the sources for a new gtk version
|
||
|
|
|
||
|
|
### Linux
|
||
|
|
|
||
|
|
You may need to install the following package for generating the source under Linux
|
||
|
|
```
|
||
|
|
sudo apt-get install libxml-libxml-perl
|
||
|
|
```
|
||
|
|
|
||
|
|
### Windows
|
||
|
|
|
||
|
|
So far I've only managed to get this working in ubuntu, not Windows due to the way the .net app launches the perl script via libc
|
||
|
|
i.e. [DllImport ("libc")]
|
||
|
|
|
||
|
|
It looks like we need to use the 32bit version of MinGW if we do try it this way.
|
||
|
|
The following path statements are needed in the console at the very least
|
||
|
|
```
|
||
|
|
PATH=$PATH:/c/Program\ Files\ \(x86\)/Microsoft\ SDKs/Windows/v10.0A/bin/NETFX\ 4.6\ Tools/
|
||
|
|
PATH=$PATH:/c/Windows/Microsoft.NET/Framework/v4.0.30319/
|
||
|
|
```
|
||
|
|
|
||
|
|
Also the parser can be rebuilt via
|
||
|
|
```
|
||
|
|
./autogen.sh --prefix=/tmp/install
|
||
|
|
cd parser
|
||
|
|
make clean
|
||
|
|
make
|
||
|
|
```
|
||
|
|
|
||
|
|
Also it's important to make sure MSYS2 is uptodate with
|
||
|
|
```
|
||
|
|
pacman -Syuu
|
||
|
|
```
|
||
|
|
|
||
|
|
To search for a package that's been install (to see what version it is for example)
|
||
|
|
```
|
||
|
|
pacman -Ss gtk3
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Editing Files for Downloaded Source
|
||
|
|
|
||
|
|
### Configure.ac version number
|
||
|
|
|
||
|
|
First change the version number in configure.ac to match that of the gtk version we're moving to
|
||
|
|
```
|
||
|
|
AC_INIT(gtk-sharp, 3.22.1)
|
||
|
|
```
|
||
|
|
|
||
|
|
### Sources/Makefile.am
|
||
|
|
|
||
|
|
Next change the version number in sources/Makefile.am to match
|
||
|
|
```
|
||
|
|
TARGET_GTK_VERSION=3.22.1
|
||
|
|
TARGET_GTK_API=3.22
|
||
|
|
```
|
||
|
|
|
||
|
|
Next update the orher url's in Makefile.am, the version numbers should match those in use on the system (such as MSYS2)
|
||
|
|
```
|
||
|
|
GTK_DOWNLOADS = \
|
||
|
|
http://ftp.gnome.org/pub/GNOME/sources/glib/2.50/glib-2.50.0.tar.xz \
|
||
|
|
http://ftp.gnome.org/pub/GNOME/sources/pango/1.40/pango-1.40.3.tar.xz \
|
||
|
|
http://ftp.gnome.org/pub/GNOME/sources/atk/2.22/atk-2.22.0.tar.xz \
|
||
|
|
http://ftp.gnome.org/pub/GNOME/sources/gdk-pixbuf/2.36/gdk-pixbuf-2.36.0.tar.xz \
|
||
|
|
http://ftp.gnome.org/pub/GNOME/sources/gtk+/$(TARGET_GTK_API)/gtk+-$(TARGET_GTK_VERSION).tar.xz
|
||
|
|
```
|
||
|
|
|
||
|
|
### Patches
|
||
|
|
|
||
|
|
As part of the source code download, some of the files will be patched
|
||
|
|
so you need to look at and check that all the patches apply correctly to the downloaded source when running make get-source-code
|
||
|
|
|
||
|
|
|
||
|
|
## Download the sources
|
||
|
|
|
||
|
|
Next we're going to download the source
|
||
|
|
```
|
||
|
|
./autogen.sh --prefix=/tmp/install
|
||
|
|
cd sources
|
||
|
|
make get-source-code
|
||
|
|
```
|
||
|
|
|
||
|
|
At this stage the sources should now be extracted within the sources sub directory
|
||
|
|
|
||
|
|
### Update sources.xml
|
||
|
|
|
||
|
|
One last file to update is the sources/sources.xml file
|
||
|
|
all directories in this file need to match the extracted directories
|
||
|
|
|
||
|
|
## Generate the API Code
|
||
|
|
|
||
|
|
### Generate the XML Files
|
||
|
|
|
||
|
|
Next to generate the xml files needed for the generation of code
|
||
|
|
```
|
||
|
|
make api
|
||
|
|
```
|
||
|
|
|
||
|
|
This should result in the following files
|
||
|
|
|
||
|
|
* gdk/gdk-api.raw
|
||
|
|
* gio/gio-api.raw
|
||
|
|
* gtk/gtk-api.raw
|
||
|
|
* pango/pango-api.raw
|
||
|
|
|
||
|
|
### Generate the API Code from the XML Files
|
||
|
|
|
||
|
|
TODO we need to use generator/gapi_codegen.exe on each of the xml files to generate the .cs code within the generated sub directories
|