Difference between revisions of "Tracking Dependencies"

From Inkscape Wiki
Jump to navigation Jump to search
(extra markup codes not necessary)
(251 intermediate revisions by 16 users not shown)
Line 1: Line 1:
== Overview ==
== Compilers ==


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.
* Version 1.0 requires a C++11 compiler.
* Version 1.1 requires a C++17 compiler.
* Version 1.4 requires a C++20 compiler.


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.
See [[c++11]], [[c++17]], and [[C++20]].


== Libs ==
== Libs ==
Line 12: Line 14:
|-
|-
! Library
! Library
! v 0.47
! v 0.92
! v 0.48.x
! v 1.0
! trunk
! v 1.1
! v 1.2
! v 1.3
! master
! gtk4
|-
|-
| Boehm-GC
| Boehm-GC
| ?
| 7.2
| 6.4
| 7.2
| 6.4
| 7.2
|
|
|
|
|-
|-
| Cairo
| Cairo
| ?
| 1.14
| ?
| 1.14 (1.15.4 required for PDF links)
| 1.10
| 1.16*
| 1.16
| 1.16
|
| 1.16**
|-
| double-conversion [https://github.com/google/double-conversion]<br/>''(lib2geom dependency)''
| ''(not required)''
| any
|
|
|
|
|-
|-
| GDK
| FreeType
| ?
|
| ?
|
| ?
| 2.9* (Required for Variable fonts)
| 2.9
| 2.9
|
|
|-
|-
| GDL<sup>1</sup>
| GDL
| N/A
| N/A<br />(3.4)
| N/A
| 3.4
| (3.4)<sup>2</sup>
| Not Used
| Not Used
| Not Used
| Not Used
|-
|-
| Glib
| Glib
| ''2.16*''
| 2.28
| ''2.16*''
| 2.48
| 2.24
| 2.56 or 2.62*
|-
| 2.64
| glibmm
| 2.64
| ?
|
| ?
| 2.68**
| ?
|-
|-
| GTK+
| GTK+
| ''2.12*'' <br /> < 3.0
| 2.24<br />(3.8)
| ''2.12*''<br /> < 3.0
| 3.22
| 2.20<br /> < 3.0
| 3.24*
| 3.24
| 3.24
|
| 4.12<sup>+</sup>
|-
|-
| GNU Scientific Library
| GNU Scientific Library
| ?
| ?
| ?
|
|
|
|
|
|-
| HarfBuzz
| ?
| ?
| ?
| ?
| 2.2*
| 2.6
| 2.6
| 2.6.5*
|
|-
|-
| LittleCMS
| libsigc++
| 1.13
| ''2.0.12*''
| 1.13
| ''2.0.12*''
| 1.13
| ''2.0.12*''
|
|
|
| 3.0**
|-
| libSoup
| ''(not required)''
| (any)
|
|
|
|
|
|-
| libpotrace
| ''(not required)''
| (any)
|
|
|
|
|
|-
|-
| libxml
| libxml
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
|
|
|
|
|
|-
|-
| libxslt
| libxslt
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
|
|
|
|
|
|-
| lcms
| 1.13
| 2.2
| 2.2 (2.9*)
| 2.9*
| 2.9*
|
|
|-
|-
| Pango
| Pango
| ?
| 1.24
| ?
| 1.24 (1.41.1 required for variable fonts)
| ?
| 1.42*
| 1.44
| 1.44 (HarfBuzz shaping)
|
| 2.48**
|-
|-
| Poppler
| Poppler
| ''0.5.9*''
| 0.20.0
| ''0.5.9*''
| 0.20.0
| ''0.5.9*''
| 0.29 (0.71*)
| 0.29 (0.71*)
| 0.71*
|
|
|-
|-
| libsigc++
| [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]
| ''2.0.12*''
| N/A
| ''2.0.12*''
| 2.0.8 ([[CompilingMacOsX|macOS only]])
| ''2.0.12*''
|
|
|
|
|
|}
|}


''* Tentative dependency'' <br />
''* Tentative dependency''
<sup>1</sup>Inkscape has an internal fork of GDL that we will eventually remove.  GDL 3.4 will contain all the new functionality that was introduced in our fork.  However, this will also introduce a dependency upon GTK+ 3.<br />
<sup>2</sup>We can't actually build against GDL 3.4 until we are able to support GTK+ 3.


== Functions used ==
* 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).


{| class="wikitable"
''** Gtkmm4 requires API changed Glibmm, Cairomm, and Pangomm. In particular, enums use child namespaces in newer libraries (Cairo::FORMAT_ARGB32 -> Cairo::Surface::Format::ARGB32).''
|-
 
! Function
''<sup>+</sup> Decision at 5 Nov 2023 developer's meeting. Gtk4 4.10.1 has an important scrolling bug fix.''
! Lib
! Since
! Required
|-
| g_timeout_add_seconds
| Glib
| 2.14
| ?
|}


== Distros ==
== Distros ==


Note: This table is not relevant to (non-fink) MacOS X, where we ship the desired version with Inkscape.
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) [https://www.debian.org/distrib/packages Debian packages]
* Support latest Ubuntu LTS (as of feature freeze) [https://packages.ubuntu.com/ 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) [https://packages.fedoraproject.org/ Fedora packages]
* Don't break ''point'' releases.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Distro
! Distro
! Inkscape
! gcc<sup>#</sup>
! clang<sup>#</sup>
! cairo
! cairo
! cairomm
! freetype
! glib
! glib
! glibmm
! glibmm
! gtk+
! gtk+
! gtkmm
! gtkmm
! harfbuzz
! pango
! pango
! poppler
! gdl
! gdl
! lcms
! lcms2
! libsigc++
! libsigc++
! libgc <!-- Fedora rpm: gc -->
! libsoup
|-
|-
|Windows Devlibs
| Windows MSYS2 (2021-04-14)<br/>([https://github.com/Alexpux/MINGW-packages mingw-w64 packages] from MSYS2 project)
| 1.10.2
  <!-- see http://quodlibet.duckdns.org/msys2/base for list of latest package versions -->
| 2.28.8
| 1.0.2
| 2.26.0
| 10.2.0
| 2.24.8
| 11.0.0
| 2.22.0
| 1.17.4
| 1.28.3
| 1.12.2
| (none)
| 2.10.4
| 1.17
| 2.68.1
| 2.2.4.2
| 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 <!-- mingw-w64-gc -->
| 2.72.0
|-
|-
| style="background:Orange;"| Debian 6.0 (Squeeze, <i>stable</i>) <small>EOL ~2014?</small>
| Debian 11 (Bullseye, oldstable) <small>EOL 2026</small>
| style="background:Orange;"| 1.8.10
| 1.0.2
| 2.24.2
| 10.2.1
| 2.24.2
| 13.0.1
| 2.20.1
| 1.16
| 2.20.3
| 1.12.2
| 1.28.3
| 2.10.4
| 2.30.1
| 2.66.8
| 1.18
| 2.64.2
| 2.2.4.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
|-
|-
| Fedora 15 <small>EOL 2012-06</small>
| Debian 12 (Bookworm, stable) <small>EOL 2028?</small>
| 1.10.2
| 1.2.2
| 2.28.6
| 12.2.0
| 2.28.6
| 15.0.6
| 2.24.4 <br /> 3.0.9
| 1.16.0
| 2.24.0
| 1.12.1
| 1.28.4
| 2.10.4
| 3.0.0
| 2.74.5
| 1.19 <br /> 2.2
| 2.74.0
| 2.2.9
| 3.24.36<br />4.8.3
| 3.24.7<br />4.8.0
| 6.0.0
| 1.50.12
| 22.12.0
| 3.40.0
| 2.14.1
| 2.12.0<br />3.4.0
| 8.2.2
| 2.74.03<br />3.2.2
|-
|-
| Fedora 16  
| Ubuntu 22.04 LTS (Jammy Jellyfish) <small>EOL 2027-04</small>
| 1.10.2
| 1.1.2
| 2.30.1
| 12.3.0
| 2.30.0
| 15.0.7
| 2.24.8 <br /> 3.2.1
| 1.16.0
| 2.24.2<br />3.2.0
| 1.12.2
| 1.29.4
| 2.11.1
| 3.2.0
| 2.72.1
| 1.19 <br /> 2.3
| 2.66.2
| 2.2.10
| 3.24.33<br />4.6.2
| 3.24.5<br />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<br />3.0.5
|-
|-
| Open SuSE 11.4 <small>EOL 2012-09-15</small>
| Ubuntu 23.10 (Mantic)
| 1.10.2
| 1.2.2
| 2.28.0
| 13.2.0
| 2.25.5
| 16.0.0<br />(17.0.2)
| 2.22.1
| 1.14.4<br />1.16.0
| 2.22.0
| 1.14.4<br />1.16.2
| 1.28.3
| 2.13.1
| 2.30.1
| 2.78.0
| 1.19 <br /> 2.1
| 2.66.6<br />2.78.0
| 2.2.8
| 3.24.38<br />4.12.2
| 3.24.8<br />4.10.0
| 8.0.1
| 1.51.0<br />2.50.1
| 23.08.0
| 3.40.0
| 2.14.2
| 2.12.0<br />3.4.0
| 8.2.4
| 2.74.3<br />3.4.2
|-
|-
| Open SuSE 12.1 <small>EOL 2013-05-15</small>
| Ubuntu 24.04 LTS (Noble) <small>EOL 2029-04</small>
| 1.10.2
| 1.2.2
| 2.30.1
| 13.2.0
| 2.30.0
| 18.0.0<br />(18.1.3)
| 2.24.7<br /> 3.2.1
| 1.18.0
| 2.24.2<br />3.2.0
| 1.14.5<br />1.18.0
| 1.29.4
| 2.13.2
| 3.2.0
| 2.80.0
| 1.19 <br /> 2.2
| 2.66.7<br />2.78.1
| 2.2.10
| 3.24.41<br />4.14.2
| 3.24.9<br />4.10.0
| 8.3.0
| 1.52.1<br />2.52.0
| 24.02.0
| 3.40.0
| 2.14.2
| 2.12.1<br />3.6.0
| 8.2.6
| 2.74.3<br />3.4.4
|-
|-
| style="background:Orange;"| Ubuntu 10.04 LTS (Lucid) <small>EOL 2013-04 (Desktop)</small>
| Ubuntu 24.10 (Oracular)
| style="background:Orange;"| 1.8.10
| 1.2.2
| 2.24.0
| 14.1.0
| 2.24.1
| 19.0<br />(19.0)
| 2.20.0
| 1.18.2
| 2.20.2
| 1.14.5<br />1.18.0
| 1.28.0
| 2.13.3
| 2.30.0
| 2.80.0
| 1.18
| 2.66.7<br />2.82.0
| 2.2.4.2
| 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.
 
== Getting and Installing Source packages ==
 
See [https://inkscape.org/develop/getting-started/ Getting Started]
 
== Optional Dependencies ==
 
Inkscape will still compile without these, but some features may be missing if they are absent during compilation:
 
{| class="wikitable"
|-
! scope="col"| Library
! scope="col"| Needed for
! scope="col"| 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
|-
|-
| Ubuntu 10.10 (Maverick) <small>EOL 2012-04-10</small>
|imagemagick
| 1.10.0
|Bitmap editing extensions, bitmap import resolution
| 2.26.1
|On
| 2.25.2
| 2.22.0
| 2.20.3
| 1.28.2
| 2.30.0
| 1.18
| 2.2.4.2
|-
|-
| Ubuntu 11.04 (Natty) <small>EOL 2012-10</small>
|jpeg
| 1.10.2
|jpeg import?
| 2.28.6
|On
| 2.28.0
| 2.24.4 <br /> 3.0.8
| 2.24.0
| 1.28.4
| 2.30.1
| 1.18
| 2.2.4.2
|-
|-
| Ubuntu 11.10 (Oneiric) <small>EOL 2013-04</small>
|OpenMP
| 1.10.2
|Multi-threaded filter rendering
| 2.30.0
|On
| 2.30.0
| 2.24.6<br /> 3.2.0
| 2.24.2<br />3.2.0
| 1.29.3
| 3.1.5
| 1.19 <br /> 2.2
| 2.2.10
|-
|-
| Ubuntu 12.04 (Precise) <small>EOL 2017-04</small> <small>(as of 2012-03-08)</small>
|scour
| 1.10.2
|Save as Optimized SVG
| 2.31.20
|(not needed during compiling, Python)
| 2.31.20
| 2.24.10<br />3.3.18
| 2.24.2<br />3.3.18
| 1.29.5
| 3.3.4
| 1.19 <br /> 2.2
| 2.2.10
|}
 
{| class="wikitable"
|-
|-
! Legend
|libvisio
|Open Visio Files, use Visio stencils
|On
|-
|-
| style="background:Red;"| Inkscape 0.48 unsupported
|libwpg
|Open WordPerfect Graphics
|On
|-
|-
| style="background:Orange;"| Inkscape trunk unsupported
|}
|}


[[Category:About Inkscape]]
[[Category:About Inkscape]]
[[Category:Developer Documentation]]
[[Category:Developer Documentation]]

Revision as of 09:10, 25 September 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 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.16**
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*
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).

** 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 23.10 (Mantic) 1.2.2 13.2.0 16.0.0
(17.0.2)
1.14.4
1.16.0
1.14.4
1.16.2
2.13.1 2.78.0 2.66.6
2.78.0
3.24.38
4.12.2
3.24.8
4.10.0
8.0.1 1.51.0
2.50.1
23.08.0 3.40.0 2.14.2 2.12.0
3.4.0
8.2.4 2.74.3
3.4.2
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) 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