Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
xfce:building [2017/12/11 15:08] – [Build requirements] skunnyk | xfce:building [2020/08/09 18:09] – update links to point to gitlab kevinbowen | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Building Xfce ====== | + | ~~NOTOC~~ |
+ | ====== Building Xfce from source | ||
To compile a complete Xfce desktop from source requires some information about the dependency chain and the various configure options available in each module. This page will describe this in detail, so you can compile your own Xfce desktop; both system wide as well as in your $HOME directory. | To compile a complete Xfce desktop from source requires some information about the dependency chain and the various configure options available in each module. This page will describe this in detail, so you can compile your own Xfce desktop; both system wide as well as in your $HOME directory. | ||
- | ====== Version ====== | + | * **[[building# |
+ | * **[[building# | ||
+ | * **[[building# | ||
+ | * **[[building# | ||
+ | * **[[building# | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Choosing your Xfce version | ||
First you will need to decide on which version of Xfce that you want to compile. Xfce version numbers are constructed like this: 1.2.3 => major.minor.micro. If the minor version is an even number, this means that it is a stable release. An odd numbered minor version indicate a development, | First you will need to decide on which version of Xfce that you want to compile. Xfce version numbers are constructed like this: 1.2.3 => major.minor.micro. If the minor version is an even number, this means that it is a stable release. An odd numbered minor version indicate a development, | ||
Line 9: | Line 18: | ||
The latest releases available can be found on the [[http:// | The latest releases available can be found on the [[http:// | ||
- | ====== Source ====== | + | ---- |
- | Once you have decided which version that you want to compile, there are a couple of ways to download | + | ===== Obtaining |
- | If your are not sure what to choose, | + | Once you have decided which version that you want to compile, there are a couple of ways to download the source code. You can either |
- | ===== Released packages ===== | + | If you are not sure which to choose, it is easiest to begin with the latest stable fat-tarball of a collection release. |
- | Xfce packages have two types of releases. Click the links, below, to open the the download | + | ==== Released packages ==== |
+ | |||
+ | Xfce packages have two types of releases: collection releases and individual | ||
* [[http:// | * [[http:// | ||
* [[http:// | * [[http:// | ||
- | ===== From the code repository | + | ==== From the code repository ==== |
- | For the latest code, you need to make local copies of the [[http://git.xfce.org/ | + | For the latest code, you need to make local copies of the [[https://gitlab.xfce.org/ |
- | You first need to make clones of each GIT repository, like the command below, where '' | + | <note information> |
- | git clone git://git.xfce.org/$category/ | + | You first need to make clones of each GIT repository, like the command below, where '' |
- | After the repository is cloned, you will need to choose which branch you want to compile. By default, the '' | + | git clone https:// |
- | To switch | + | After the repository is cloned, you will need to choose which branch |
- | | + | To switch to another branch ('' |
+ | |||
+ | | ||
After this, you can update your local copy of the repository with git pull and switch to another branch with '' | After this, you can update your local copy of the repository with git pull and switch to another branch with '' | ||
- | ====== Dependencies ====== | ||
- | ===== Build requirements | + | [[|Back To Top]] |
+ | ---- | ||
+ | |||
+ | ===== Xfce Dependencies explained ===== | ||
+ | |||
+ | ==== Build requirements ==== | ||
Before you can start compiling, you need a couple of packages that are required to compile Xfce. Use your distributions package manager to install those packages. Additional packages are required too for some modules, but we'll get to that later. | Before you can start compiling, you need a couple of packages that are required to compile Xfce. Use your distributions package manager to install those packages. Additional packages are required too for some modules, but we'll get to that later. | ||
Line 45: | Line 62: | ||
* [[http:// | * [[http:// | ||
* Gtk+ and Glib headers, in some distributions called the -devel packages | * Gtk+ and Glib headers, in some distributions called the -devel packages | ||
- | * Xfce 4.14 requires Gtk+ 3.20 and Glib 2.42 | + | * Xfce 4.14 requires Gtk+ 3.22 and Glib 2.42 |
- | * Xfce 4.12 requires Gtk+ 2.24 and Glib 2.30 | + | * Xfce 4.12 requires Gtk+ 2.24 and Glib |
+ | * pkgconfig | ||
+ | * Coffee or tea | ||
+ | |||
+ | |||
+ | For history, here are the versions needed for older xfce releases, which are not supported anymore | ||
* Xfce 4.10 requires Gtk+ 2.20 and Glib 2.24 | * Xfce 4.10 requires Gtk+ 2.20 and Glib 2.24 | ||
* Xfce 4.8 requires Gtk+ 2.14 and Glib 2.20 | * Xfce 4.8 requires Gtk+ 2.14 and Glib 2.20 | ||
* Xfce 4.6 requires Gtk+ 2.10 and Glib 2.12 | * Xfce 4.6 requires Gtk+ 2.10 and Glib 2.12 | ||
- | * pkgconfig | ||
- | * Coffee | ||
- | ===== Xfce's dependency chain ===== | + | |
+ | ==== Xfce's dependency chain ==== | ||
The Xfce packages need to be built in a specific order. If you don't follow this, compile options might not be available or the configure stage will abort because of missing dependencies. | The Xfce packages need to be built in a specific order. If you don't follow this, compile options might not be available or the configure stage will abort because of missing dependencies. | ||
Line 60: | Line 81: | ||
* libxfce4util | * libxfce4util | ||
* xfconf | * xfconf | ||
- | * libxfce4ui, garcon, < | + | * libxfce4ui |
- | * exo | + | * garcon, |
- | * xfce4-panel | + | |
* thunar | * thunar | ||
- | * xfce4-settings, | + | * xfce4-panel, |
- | ===== Package specific dependencies | + | ==== Package specific dependencies ==== |
Some core packages in Xfce have additional or optional dependencies, | Some core packages in Xfce have additional or optional dependencies, | ||
Line 74: | Line 94: | ||
| ^ Dependency(-ies) ^ Optional Dependency(-ies) ^ | | ^ Dependency(-ies) ^ Optional Dependency(-ies) ^ | ||
^ xfce4-dev-tools | autoconf, automake, intltool, pkgconfig | | | ^ xfce4-dev-tools | autoconf, automake, intltool, pkgconfig | | | ||
- | ^ libxfce4util | glib ((new in 4.10, was gobject in previous releaes)) | + | ^ libxfce4util | glib2 | | |
- | ^ xfconf | libxfce4util, | + | ^ xfconf | libxfce4util, |
^ libxfce4ui | libxfce4util, | ^ libxfce4ui | libxfce4util, | ||
- | ^ garcon | gio, libxfce4util | + | ^ garcon | gio, libxfce4util | | |
- | ^ libxfcegui4 ((deprecated, | + | ^ exo | libxfce4util, |
- | ^ exo | libxfce4util, | + | |
^ xfce4-panel | libxfce4ui, exo, garcon, libwnck | libstartup-notification | | ^ xfce4-panel | libxfce4ui, exo, garcon, libwnck | libstartup-notification | | ||
- | ^ thunar | libxfce4ui, exo, libpng, gtk+, glib | libexif, | + | ^ thunar | libxfce4ui, exo, libpng, gtk+, glib | libexif, |
- | ^ xfce4-settings | libxfce4ui, exo, xfconf, | + | ^ xfce4-settings | libxfce4ui, exo, xfconf, |
- | ^ xfce4-session | libxfce4ui, perl-xml-parser, | + | ^ xfce4-session | libxfce4ui, perl-xml-parser, |
- | ^ xfwm4 | libxfce4util, | + | ^ xfwm4 | libxfce4util, |
- | ^ xfdesktop | libxfce4ui, xfconf, libwnck, exo ((was optional in 4.8)) | thunarx, garcon, libnotify | | + | ^ xfdesktop | libxfce4ui, xfconf, libwnck, exo garcon |
- | ^ xfce4-appfinder | libxfce4ui, garcon, gio ((new dependency since 4.10)) | | | + | ^ xfce4-appfinder | libxfce4ui, garcon, gio | | |
- | ^ < | + | ^ tumbler | dbus-glib, gio, gmodule, gdk-pixbuf | freetype-config (fonts), jpeg (jpeg thumbnails from exif), libffmpegthumbnailer (video), gstreamer-1.0 (video), poppler-glib (pdf), libgsf (odf), libopenraw-gnome (various raw images) | |
- | ^ gtk-xfce-engine-2 | gtk+ | | | + | |
- | ^ tumbler | dbus-glib, gio, gmodule, gdk-pixbuf | freetype-config (fonts), jpeg (jpeg thumbnails from exif), libffmpegthumbnailer (video), gstreamer-0.10 (video), poppler-glib (pdf), libgsf (odf), libopenraw-gnome (various raw images) | | + | |
- | ====== Building ====== | + | [[|Back To Top]] |
+ | ---- | ||
- | ===== Installation location and variables | + | ===== Building the packages ===== |
+ | ==== Installation location and variables ==== | ||
Now it is finally time to start compiling the Xfce desktop. Last remaining thing is to choose an installation location. Possible examples are ''/ | Now it is finally time to start compiling the Xfce desktop. Last remaining thing is to choose an installation location. Possible examples are ''/ | ||
Line 108: | Line 127: | ||
export CFLAGS="" | export CFLAGS="" | ||
- | ===== Compiling and installing | + | |
+ | ==== Compiling and installing ==== | ||
Next step is compiling the various packages following the dependency chain above. If you have downloaded the tarballs, you will need to unpack them before going on. Inside each package directory you should run the following command: | Next step is compiling the various packages following the dependency chain above. If you have downloaded the tarballs, you will need to unpack them before going on. Inside each package directory you should run the following command: | ||
Line 128: | Line 148: | ||
sudo make install | sudo make install | ||
- | ==== Debug Levels | + | ==== Understanding |
Most Xfce modules use the m4 macro // | Most Xfce modules use the m4 macro // | ||
Line 141: | Line 161: | ||
! Same as the level above, including '' | ! Same as the level above, including '' | ||
- | ====== Help ====== | + | [[|Back To Top]] |
+ | ---- | ||
+ | ===== Finding additional | ||
Hopefully everything went fine after reading this guide. If you still have problems or questions you can ask on the [[http:// | Hopefully everything went fine after reading this guide. If you still have problems or questions you can ask on the [[http:// | ||
Line 147: | Line 169: | ||
Have fun building Xfce! | Have fun building Xfce! | ||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | [[: |