Difference between revisions of "Tracking Dependencies"

From Inkscape Wiki
Jump to navigation Jump to search
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Overview ==
We need help getting our basic lib dependencies listed out and kept up to date. Also we need to track which versions of which distros have the needed dependencies.
To get glib and GTK+ dependencies figured out, people can go through the API documentation and look for the 'since' entries saying when calls were added. Then look for those calls in our source. Voila! we'll have base minimum dependencies figured out.
== Compilers ==
== Compilers ==


Version 1.0 requires a C++11 compiler.
* Version 1.0 requires a C++11 compiler.
Version 1.1 requires a C++17 compiler.
* Version 1.1 requires a C++17 compiler.
* Version 1.4 requires a C++20 compiler.


See [[c++11]] and [[c++17]].
See [[c++11]], [[c++17]], and [[C++20]].


== Libs ==
== Libs ==
Line 23: Line 18:
! v 1.1
! v 1.1
! v 1.2
! v 1.2
! master
! v 1.3
! v 1.4
! master/gtk4
|-
|-
| Boehm-GC
| Boehm-GC
Line 29: Line 26:
| 7.2
| 7.2
| 7.2
| 7.2
|
|
|
|
|
|
Line 38: Line 37:
| 1.16
| 1.16
| 1.16
| 1.16
|
| 1.18* **
|-
|-
| double-conversion [https://github.com/google/double-conversion]<br/>''(lib2geom dependency)''
| double-conversion [https://github.com/google/double-conversion]<br/>''(lib2geom dependency)''
| ''(not required)''
| ''(not required)''
| any
| any
|
|
|
|
|
Line 52: Line 54:
| 2.9
| 2.9
| 2.9
| 2.9
|
|
|-
|-
| GDL
| GDL
| N/A<br />(3.4)
| N/A<br />(3.4)
| 3.4
| 3.4
| Not Used
| Not Used
| Not Used
| Not Used
| Not Used
| Not Used
Line 65: Line 71:
| 2.64
| 2.64
| 2.64
| 2.64
|
| 2.68**
|-
|-
| GTK+
| GTK+
Line 72: Line 80:
| 3.24
| 3.24
| 3.24
| 3.24
|
| 4.12<sup>+</sup>
|-
|-
| GNU Scientific Library
| GNU Scientific Library
| ?
| ?
| ?
| ?
|
|
|
|
|
|
Line 86: Line 98:
| 2.6
| 2.6
| 2.6
| 2.6
| 2.6.5*
| 7.0*
|-
|-
| libsigc++
| libsigc++
Line 92: Line 106:
| ''2.0.12*''
| ''2.0.12*''
|
|
|
|
| 3.0**
|-
|-
| libSoup
| libSoup
| ''(not required)''
| ''(not required)''
| (any)
| (any)
|
|
|
|
|
|
Line 103: Line 122:
| ''(not required)''
| ''(not required)''
| (any)
| (any)
|
|
|
|
|
|
Line 110: Line 131:
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
|
|
|
|
|
|
Line 117: Line 140:
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
|
|
|
|
|
|
Line 127: Line 152:
| 2.9*
| 2.9*
| 2.9*
| 2.9*
|
|
|-
|-
| Pango
| Pango
Line 134: Line 161:
| 1.44
| 1.44
| 1.44 (HarfBuzz shaping)
| 1.44 (HarfBuzz shaping)
|
| 2.48**
|-
|-
| Poppler
| Poppler
Line 141: Line 170:
| 0.29 (0.71*)
| 0.29 (0.71*)
| 0.71*
| 0.71*
|
|
|-
|-
| [https://formulae.brew.sh/formula/gtk-mac-integration gtk-mac-integration]<br>[https://www.macports.org/ports.php?by=library&substr=gtk-osx-application-gtk3 gtk-osx-application-gtk3]
| [https://formulae.brew.sh/formula/gtk-mac-integration gtk-mac-integration]<br>[https://www.macports.org/ports.php?by=library&substr=gtk-osx-application-gtk3 gtk-osx-application-gtk3]
| N/A
| N/A
| 2.0.8 ([[CompilingMacOsX|macOS only]])
| 2.0.8 ([[CompilingMacOsX|macOS only]])
|
|
|
|
|
|
Line 156: Line 189:
* Pango 1.45.1 requires Glib 2.60
* Pango 1.45.1 requires Glib 2.60
* Pango 1.48.4 has vertical upright marks fix.
* Pango 1.48.4 has vertical upright marks fix.
* Harfbuzz 4.1 changes glyph positioning for upright vertical text when font does not have vertical metrics (from glyph touching to of cell to being centered in cell).
* Cairo 1.18 supports various color font formats include export to PDF.
''** Gtkmm4 requires API changed Glibmm, Cairomm, and Pangomm. In particular, enums use child namespaces in newer libraries (Cairo::FORMAT_ARGB32 -> Cairo::Surface::Format::ARGB32).''
''<sup>+</sup> Decision at 5 Nov 2023 developer's meeting. Gtk4 4.10.1 has an important scrolling bug fix.''


== Distros ==
== Distros ==
Line 167: Line 206:


'''General rules:'''
'''General rules:'''
* Support last Debian Stable
* Support latest Debian Stable (as of feature freeze) [https://www.debian.org/distrib/packages Debian packages]
* Support last Ubuntu LTS [https://packages.ubuntu.com/ Ubuntu packages]
* Support latest Ubuntu LTS (as of feature freeze) [https://packages.ubuntu.com/ Ubuntu packages]
* Support last CentOS/Redhat (as best effort).
**e.g. Considering Inkscape 1.2, the latest Ubuntu LTS at '''feature freeze time''' (around February 2022) would have been Ubuntu 20.04. The latest LTS at release time (around May 2022), though, will be Ubuntu 22.04.  Therefore, according to the rule, we should support Ubuntu 20.04 LTS as the minimum version.
* Support last two Fedora releases.
 
* Support last two Fedora releases (as of feature freeze) [https://packages.fedoraproject.org/ Fedora packages]
* Don't break ''point'' releases.
* Don't break ''point'' releases.


Line 177: Line 217:
! Distro
! Distro
! Inkscape
! Inkscape
! gcc
! gcc<sup>#</sup>
! clang
! clang<sup>#</sup>
! cairo
! cairo
! cairomm
! cairomm
Line 216: Line 256:
| 2.72.0
| 2.72.0
|-
|-
| Debian 10 (Buster, <i>stable</i>) <small>EOL 2024-06</small>
| Debian 11 (Bullseye, oldstable) <small>EOL 2026</small>
| 0.92.4 (1.0.2)
| 8.3.0
| 7.0
| 1.16
| 1.12.2
| 2.9.1
| 2.58.3
| 2.58.0
| 2.24.32<br />3.24.5
| 2.24.5<br />3.24.0
| 2.3.1
| 1.42.4
| 0.71.0
| 3.28.0
| 2.9
| 2.10.1
| 7.6.4
| 2.64.2
|-
| Debian 11 (Bullseye, <i>testing</i>) <small>EOL ?</small><br/>(2021-04)
| 1.0.2
| 1.0.2
| 10.2.1
| 10.2.1
| 11.0
| 13.0.1
| 1.16
| 1.16
| 1.12.2
| 1.12.2
Line 256: Line 276:
| 2.72.0
| 2.72.0
|-
|-
| style="background:Violet;"|(RHEL) / CentOS 8.1 <small>EOFS 2024-05</small><br/>Based on Centros 8.1 package list
| Debian 12 (Bookworm, stable) <small>EOL 2028?</small>
| 0.92.3
| 1.2.2
| 8.3.1
| 12.2.0
| 8.0.1
| 15.0.6
| 1.15.12
| 1.16.0
| 1.12.0
| 1.12.1
| 2.8.14
| 2.10.4
| 2.56.4
| 2.74.5
| 2.56.0
| 2.74.0
| 2.24.32<br />3.22.30
| 3.24.36<br />4.8.3
| 2.24.5<br />3.22.2
| 3.24.7<br />4.8.0
| 1.7.5
| 6.0.0
| 1.42.4
| 1.50.12
| 0.66.0
| 22.12.0
| style="background:Violet;"|?
| 3.40.0
| 2.9
| 2.14.1
| 2.10.0
| 2.12.0<br />3.4.0
| 7.6.4
| 8.2.2
| 2.62.3
| 2.74.03<br />3.2.2
|-
|-
| Ubuntu 18.04 LTS (Bionic) <small>EOL 2023-04</small>
| Ubuntu 22.04 LTS (Jammy Jellyfish) <small>EOL 2027-04</small>
| 0.92.3
| 1.1.2
| 7.3
| 12.3.0
| 6.0
| 15.0.7
| 1.15.10
| 1.16.0
| 1.12.2
| 1.12.2
| 2.8.1
| 2.11.1
| 2.56.1
| 2.72.1
| 2.56.0
| 2.66.2
| 2.24.32<br />3.22.30
| 3.24.33<br />4.6.2
| 2.24.5<br />3.22.2
| 3.24.5<br />no libgtkmm-4.0
| 1.7.2
| 2.7.4
| 1.40.14
| 1.50.6
| 0.62.0
| 22.02.0
| 3.28.0
| 3.40.0
| 2.9
| 2.12-rc1
| 2.10.0
| 2.10.4
| 7.4.2
| 8.0.6
| 2.62.1
| 2.74.2<br />3.0.5
|-
|-
| Ubuntu 20.04 LTS (Focal Fossa) <small>EOL 2025-04</small>
| Ubuntu 24.04 LTS (Noble) <small>EOL 2029-04</small>
| 0.92.5
| 1.2.2
| 10
| 13.2.0
| 10
| 18.0.0<br />(18.1.3)
| 1.16
| 1.18.0
| 1.12.2
| 1.14.5<br />1.18.0
| 2.10.1
| 2.13.2
| 2.64.1
| 2.80.0
| 2.64.2
| 2.66.7<br />2.78.1
| 2.24.32<br />3.24.17
| 3.24.41<br />4.14.2
| 2.24.5<br />3.24.2
| 3.24.9<br />4.10.0
| 2.6.4
| 8.3.0
| 1.44.7
| 1.52.1<br />2.52.0
| 0.86.1
| 24.02.0
| 3.34.0
| 3.40.0
| 2.9.4
| 2.14.2
| 2.10.2
| 2.12.1<br />3.6.0
| 10
| 8.2.6
| 2.70.0
| 2.74.3<br />3.4.4
|}
 
{| class="wikitable"
|-
! Legend
|-
| style="background:Orange;"| Inkscape 1.0.x unsupported
|-
|-
| style="background:Violet;"| GTK+ 3 builds unsupported
| Ubuntu 24.10 (Oracular) <small>EOL 2025-06</small>
| 1.2.2
| 14.1.0
| 19.0<br />(19.0)
| 1.18.2
| 1.14.5<br />1.18.0
| 2.13.3
| 2.80.0
| 2.66.7<br />2.82.0
| 3.24.43<br />4.16.1
| 3.24.9<br />4.16.0
| 9.0.0
| 1.54.0<br />2.54.0
| 24.08.0
| 3.40.0
| 2.14.2
| 2.12.1<br />3.6.0
| 8.2.6
| 2.74.3<br />3.6.0
|}
|}
<sup>#</sup>Debian and Ubuntu offer multiple gcc and clang versions, latest available version listed.


* Agreed to at Saarbrücken hackfest.
* Agreed to at Saarbrücken hackfest.
Line 330: Line 362:
== Getting and Installing Source packages ==
== Getting and Installing Source packages ==


If your distro does not have some packages available (like many don't, ie, Fedora Core 2), you must often download
See [https://inkscape.org/develop/getting-started/ Getting Started]
source packages and build and install them yourself.  Actually this is not that hard, and is similar to
doing a Gentoo 'emerge.'
 
* Usually you download a file with a name like somepackage-1.0.tar.gz.  Unpack it with
 
    $ tar zxf somepackage-1.0.tar.gz
    or
    $ tar jxf somepackage-1.0.tar.bz2
 
* Then 'cd' into the new directory.
 
* Configure it with the command:
 
    $ ./configure
 
* Build it with:
 
    $ make
 
* As the 'root' user,  install it with:
 
    # make install
 
=== Boehm-GC ===
 
Website: http://www.hboehm.info/gc/
 
GitHub Project: https://github.com/ivmai/bdwgc
 
Binaries:  If searching for a package for GC, the name of it is sometimes:
 
* gc
* libgc
* gc-devel
* libgc-devel
* boehm-gc  (on Gentoo)
* debian/ubuntu:  sudo apt-get install libgc-dev
 
=== libSigc++ ===
 
Source: http://ftp.gnome.org/pub/GNOME/sources/libsigc++/2.2/libsigc++-2.2.3.tar.bz2
 
With this file, and for GlibMM and GtkMM below, it is usually desirable for us developers to
build this C++ library statically.  This removes a dependency that might be difficult for an
end-user during installation.  Configure it with:
 
    ./configure --enable-static --disable-shared
 
=== GlibMM ===
Try to match your Glib2 version with GlibMM's version. For example, if your Glib2 is 2.16.6, download glibmm-2.16.4.tar.bz2.
 
Latest source: http://ftp.gnome.org/pub/GNOME/sources/glibmm/
 
=== GtkMM ===
Usually you can try the latest version of GtkMM, but if you get version mismatch errors, try older releases.
 
Source: http://ftp.gnome.org/pub/GNOME/sources/gtkmm/2.12/gtkmm-2.12.7.tar.bz2
 
=== cairomm ===
 
if you got prompted about cairomm, try first solve your cairo version, so you can grab [http://www.cairographics.org/releases/ there] a compatible version.
 
 
=== Boost ===
 
Many users have reported when building from source that after installing the above dependencies, the configure script still requires a "boost" package. It can be found below, but even after installing, you will need to create a symlink to allow the configure script to find it:
 
    ln -s /usr/local/include/boost_1_xx_x/boost /usr/local/include/boost
 
Source: http://www.boost.org/users/download/
 
 
=== Boost-Filesystem ===
 
Boost filesystem is a temporary dependency we discussed in September 2020 because compilers we wanted to support (in particular gcc-8 and some macos compilers) do not yet support std::filesystem.
 
Once all compilers we support get std::filesystem, we will drop this dep
 
 
 
=== Poppler ===
 
Source: http://poppler.freedesktop.org/
 
Poppler is required for PDF import. There are several potential issues:
* Some Linux distributions do not ship the Xpdf headers required by Inkscape. In such cases, you need to recompile Poppler, passing --enable-xpdf-headers on the configure line or install the libpoppler-private-dev package. See [https://bugs.launchpad.net/inkscape/+bug/254849 this wishlist bug]. This typically manifests in error messages like this:
<pre>In file included from extension/internal/pdfinput/svg-builder.cpp:19:
extension/internal/pdfinput/svg-builder.h:32:23: error: CharTypes.h: No such file or directory
...
make[2]: *** [extension/internal/pdfinput/svg-builder.o] Error 1
make[2]: Leaving directory `/tmp/build/inkscape-0.46/src'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/tmp/build/inkscape-0.46'
make: *** [all] Error 2</pre>
* Inkscape 0.47 does not compile with Poppler >= 0.12.2. If you need to compile Inkscape on such systems, use the development version from Bazaar, where this bug is fixed. See [https://bugs.launchpad.net/inkscape/+bug/487038 the bug report] for details and a minimal patch.
* Inkscape compiled with Poppler <= 0.12.1 will run on systems with Poppler >= 0.12.2, but the PDF import function will crash instantly. This problem does not concern Windows users, since the correct Poppler version is contained in the Windows installer package. This cannot be fixed on Inkscape's side: those two versions of Poppler are not ABI compatible, yet share the same soname. See [https://bugs.launchpad.net/inkscape/+bug/258504 this bug] for more details.
* Poppler's Xpdf headers are not guaranteed to be API-compatible between releases. It's likely that future Poppler versions will break PDF import in some way. PDF import works at least up to 0.12.4 but might not work with later versions.


== Optional Dependencies ==
== Optional Dependencies ==

Latest revision as of 19:13, 18 November 2024

Compilers

  • Version 1.0 requires a C++11 compiler.
  • Version 1.1 requires a C++17 compiler.
  • Version 1.4 requires a C++20 compiler.

See c++11, c++17, and C++20.

Libs

C++ bindings are not included, since their required versions match those of the C counterparts.

Library v 0.92 v 1.0 v 1.1 v 1.2 v 1.3 v 1.4 master/gtk4
Boehm-GC 7.2 7.2 7.2
Cairo 1.14 1.14 (1.15.4 required for PDF links) 1.16* 1.16 1.16 1.18* **
double-conversion [1]
(lib2geom dependency) 		(not required) any
FreeType 2.9* (Required for Variable fonts) 2.9 2.9
GDL N/A
(3.4) 		3.4 Not Used Not Used Not Used Not Used
Glib 2.28 2.48 2.56 or 2.62* 2.64 2.64 2.68**
GTK+ 2.24
(3.8) 		3.22 3.24* 3.24 3.24 4.12+
GNU Scientific Library ? ?
HarfBuzz ? ? 2.2* 2.6 2.6 2.6.5* 7.0*
libsigc++ 2.0.12* 2.0.12* 2.0.12* 3.0**
libSoup (not required) (any)
libpotrace (not required) (any)
libxml 2.6.11* 2.6.11*
libxslt 1.0.15* 1.0.15*
lcms 1.13 2.2 2.2 (2.9*) 2.9* 2.9*
Pango 1.24 1.24 (1.41.1 required for variable fonts) 1.42* 1.44 1.44 (HarfBuzz shaping) 2.48**
Poppler 0.20.0 0.20.0 0.29 (0.71*) 0.29 (0.71*) 0.71*
gtk-mac-integration
gtk-osx-application-gtk3 		N/A 2.0.8 (macOS only)

* Tentative dependency

  • Pango 1.42.2 requires Harfbuzz 1.4.2
  • Pango 1.44.0 requires Glib 2.59.2 and Harfbuzz 2.0. 1.44 exposes hb_font directly.
  • Pango 1.45.1 requires Glib 2.60
  • Pango 1.48.4 has vertical upright marks fix.
  • Harfbuzz 4.1 changes glyph positioning for upright vertical text when font does not have vertical metrics (from glyph touching to of cell to being centered in cell).
  • Cairo 1.18 supports various color font formats include export to PDF.

** Gtkmm4 requires API changed Glibmm, Cairomm, and Pangomm. In particular, enums use child namespaces in newer libraries (Cairo::FORMAT_ARGB32 -> Cairo::Surface::Format::ARGB32).

+ Decision at 5 Nov 2023 developer's meeting. Gtk4 4.10.1 has an important scrolling bug fix.

Distros

Note: This table is not relevant to (non-fink) MacOS X, where we ship the desired version with Inkscape.

"Inkscape" column is default or distro version / oldest that builds - latest that builds. If no latest is given then that means trunk is expected to build on the given platform.

e.g. for a distro that ships with 0.48 but should support building of trunk you might get: 

0.48 / 0.47-

General rules:

  • Support latest Debian Stable (as of feature freeze) Debian packages
  • Support latest Ubuntu LTS (as of feature freeze) Ubuntu packages
    • e.g. Considering Inkscape 1.2, the latest Ubuntu LTS at feature freeze time (around February 2022) would have been Ubuntu 20.04. The latest LTS at release time (around May 2022), though, will be Ubuntu 22.04. Therefore, according to the rule, we should support Ubuntu 20.04 LTS as the minimum version.
  • Support last two Fedora releases (as of feature freeze) Fedora packages
  • Don't break point releases.
Distro Inkscape gcc# clang# cairo cairomm freetype glib glibmm gtk+ gtkmm harfbuzz pango poppler gdl lcms2 libsigc++ libgc libsoup
Windows MSYS2 (2021-04-14)
(mingw-w64 packages from MSYS2 project) 		1.0.2 10.2.0 11.0.0 1.17.4 1.12.2 2.10.4 2.68.1 2.66.0 3.24.27 3.24.3 2.8.0 1.48.4 20.12.1 3.34.0 2.12 2.10.6 8.0.4 2.72.0
Debian 11 (Bullseye, oldstable) EOL 2026 1.0.2 10.2.1 13.0.1 1.16 1.12.2 2.10.4 2.66.8 2.64.2 3.24.24 3.24.2 2.7.4 1.46.2 20.09.0 3.34.0 2.12 2.10.4 8.0.4 2.72.0
Debian 12 (Bookworm, stable) EOL 2028? 1.2.2 12.2.0 15.0.6 1.16.0 1.12.1 2.10.4 2.74.5 2.74.0 3.24.36
4.8.3 		3.24.7
4.8.0 		6.0.0 1.50.12 22.12.0 3.40.0 2.14.1 2.12.0
3.4.0 		8.2.2 2.74.03
3.2.2
Ubuntu 22.04 LTS (Jammy Jellyfish) EOL 2027-04 1.1.2 12.3.0 15.0.7 1.16.0 1.12.2 2.11.1 2.72.1 2.66.2 3.24.33
4.6.2 		3.24.5
no libgtkmm-4.0 		2.7.4 1.50.6 22.02.0 3.40.0 2.12-rc1 2.10.4 8.0.6 2.74.2
3.0.5
Ubuntu 24.04 LTS (Noble) EOL 2029-04 1.2.2 13.2.0 18.0.0
(18.1.3) 		1.18.0 1.14.5
1.18.0 		2.13.2 2.80.0 2.66.7
2.78.1 		3.24.41
4.14.2 		3.24.9
4.10.0 		8.3.0 1.52.1
2.52.0 		24.02.0 3.40.0 2.14.2 2.12.1
3.6.0 		8.2.6 2.74.3
3.4.4
Ubuntu 24.10 (Oracular) EOL 2025-06 1.2.2 14.1.0 19.0
(19.0) 		1.18.2 1.14.5
1.18.0 		2.13.3 2.80.0 2.66.7
2.82.0 		3.24.43
4.16.1 		3.24.9
4.16.0 		9.0.0 1.54.0
2.54.0 		24.08.0 3.40.0 2.14.2 2.12.1
3.6.0 		8.2.6 2.74.3
3.6.0

#Debian and Ubuntu offer multiple gcc and clang versions, latest available version listed.

  • Agreed to at Saarbrücken hackfest.

Getting and Installing Source packages

See Getting Started

Optional Dependencies

Inkscape will still compile without these, but some features may be missing if they are absent during compilation:

Library Needed for Default
aspell Dictionaries for spell checking On
libcdr Open Corel Draw files On
gettext/msgformat Translation support On
gtest/gmock Automatted testing Off
gspell Spell checking On
imagemagick Bitmap editing extensions, bitmap import resolution On
jpeg jpeg import? On
OpenMP Multi-threaded filter rendering On
scour Save as Optimized SVG (not needed during compiling, Python)
libvisio Open Visio Files, use Visio stencils On
libwpg Open WordPerfect Graphics On
Retrieved from "https://wiki.inkscape.org/wiki/index.php?title=Tracking_Dependencies&oldid=123079"