Difference between revisions of "Tracking Dependencies"

From Inkscape Wiki
Jump to navigation Jump to search
(→‎Distros: Update devlibs (according to devlibs Readme))
(270 intermediate revisions by 17 users not shown)
Line 1: Line 1:
(stub contents in need of filling out)
== Compilers ==


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


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


== Libs ==
== Libs ==
Line 11: Line 11:
C++ bindings are not included, since their required versions match those of the C counterparts.
C++ bindings are not included, since their required versions match those of the C counterparts.


{| class="wikitable" border="1"
{| class="wikitable"
|-
|-
! 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
|
|
|
|
|-
| FreeType
|
|
| 2.9* (Required for Variable fonts)
| 2.9
| 2.9
|
|
|-
|-
| GDK
| GDL
| ?
| N/A<br />(3.4)
| ?
| 3.4
| ?
| 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
| 2.64
|
| 2.68**
|-
|-
| GTK+
| GTK+
| ''2.12*''
| 2.24<br />(3.8)
| ''2.12*''
| 3.22
| 2.20
| 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''
''* Tentative dependency''


== 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" border="1"
''** 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 ==
Line 100: Line 199:
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.


{| class="wikitable" border="1"
"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"
|-
|-
! 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++
! libgc <!-- Fedora rpm: gc -->
! libsoup
|-
| Windows MSYS2 (2021-04-14)<br/>([https://github.com/Alexpux/MINGW-packages mingw-w64 packages] from MSYS2 project)
  <!-- see http://quodlibet.duckdns.org/msys2/base for list of latest package versions -->
| 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 <!-- mingw-w64-gc -->
| 2.72.0
|-
|-
|Windows Devlibs
| Debian 11 (Bullseye, oldstable) <small>EOL 2026</small>
| 1.10.2
| 1.0.2
| 2.28.8
| 10.2.1
| 2.26.0
| 13.0.1
| 2.24.8<br />(none)
| 1.16
| 2.22.0
| 1.12.2
| 1.28.3
| 2.10.4
| (none)
| 2.66.8
| 1.17
| 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) <small>EOL 2028?</small>
| 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<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
|-
| Ubuntu 22.04 LTS (Jammy Jellyfish) <small>EOL 2027-04</small>
| 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<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
|-
| Ubuntu 23.10 (Mantic)
| 1.2.2
| 13.2.0
| 16.0.0<br />(17.0.2)
| 1.14.4<br />1.16.0
| 1.14.4<br />1.16.2
| 2.13.1
| 2.78.0
| 2.66.6<br />2.78.0
| 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
|-
| Ubuntu 24.04 LTS (Noble) <small>EOL 2029-04</small>
| 1.2.2
| 13.2.0
| 18.0.0<br />(18.1.3)
| 1.18.0
| 1.14.5<br />1.18.0
| 2.13.2
| 2.80.0
| 2.66.7<br />2.78.1
| 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
|-
| Ubuntu 24.10 (Oracular)
| 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.
 
== 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"
|-
|-
| style="background:Orange;"| Debian 6.0 (Squeeze, <i>stable</i>) <small>EOL ~2014?</small>
! scope="col"| Library
| style="background:Orange;"| 1.8.10
! scope="col"| Needed for
| 2.24.2
! scope="col"| Default
| 2.24.2
| 2.20.1 <br /> (none)
| 2.20.3
| 1.28.3
| 2.30.1
| ?
|-
|-
| Fedora 15 <small>EOL 2012-06</small>
|aspell
| 1.10.2
|Dictionaries for spell checking
| 2.28.6
|On
| 2.28.6
| 2.24.4 <br /> 3.0.9
| 2.24.0
| 1.28.4
| 3.0.0
| ?
|-
|-
| Fedora 16
|libcdr
| 1.10.2
|Open Corel Draw files
| 2.30.1
|On
| 2.30.0
| 2.24.8 <br /> 3.2.1
| 2.24.2<br />3.2.0
| 1.29.4
| 3.2.0
| ?
|-
|-
| Open SuSE 11.4 <small>EOL 2012-09-15</small>
|gettext/msgformat
| 1.10.2
|Translation support
| 2.28.0
|On
| 2.25.5
| 2.22.1 <br /> (none)
| 2.22.0
| 1.28.3
| 2.30.1
| ?
|-
|-
| Open SuSE 12.1 <small>EOL 2013-05-15</small>
|gtest/gmock
| 1.10.2
|Automatted testing
| 2.30.1
|Off
| 2.30.0
| 2.24.7 <br /> 3.2.1
| 2.24.2<br />3.2.0
| 1.29.4
| 3.2.0
| ?
|-
|-
| style="background:Orange;"| Ubuntu 10.04 LTS (Lucid) <small>EOL 2013-04 (Desktop)</small>
|gspell
| style="background:Orange;"| 1.8.10
|Spell checking
| 2.24.0
|On
| 2.24.1
| 2.20.0 <br /> (none)
| 2.20.2
| 1.28.0
| 2.30.0
| ?
|-
|-
| Ubuntu 10.10 (Maverick) <small>EOL 2012-04</small>
|imagemagick
| 1.10.0
|Bitmap editing extensions, bitmap import resolution
| 2.26.1
|On
| 2.25.2
| 2.22.0 <br /> (none)
| 2.20.3
| 1.28.2
| 2.30.0
| 1.18
|-
|-
| 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
|-
|-
| 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
|-
|-
| Ubuntu 11.10 (Precise) <small>EOL ?</small>
|scour
| ?
|Save as Optimized SVG
| ?
|(not needed during compiling, Python)
| ?
| ?
| ?
| ?
| ?
| 2.x
|}
 
{| 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: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
Retrieved from "https://wiki.inkscape.org/wiki/index.php?title=Tracking_Dependencies&oldid=123031"