Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

xfce:4.22:building [2026/10/25 05:54] – created kevinbowenxfce:4.22:building [2026/11/12 20:07] (current) – sync with changes from main page kevinbowen
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
 {{ :xfce-64x64.png?nolink|}} {{ :xfce-64x64.png?nolink|}}
-====== Building Xfce from source ======+~~NOTOC~~ 
 +====== Building Xfce from Source ======
  
-To compile a complete Xfce desktop from source requires some information about the dependency chain and the various configuration options available in each module. This page will describe these requirements in detail, so that you can compile your own Xfce desktop; both system wide as well as in your $HOME directory.+Compiling a complete Xfce desktop from source requires information about the dependency chain and the various configuration options available in each module. This page will describe these requirements in detail, so that you can compile your own Xfce desktop; both system wide as well as in your ''$HOME'' directory.
  
-  * **[[building#Choosing your Xfce version|Choosing your Xfce version]]** +  * **[[#Choosing an Xfce Version|Choosing an Xfce Version]]** 
-  * **[[building#Obtaining the Xfce source code|Obtaining the Xfce source code]]** +  * **[[#Obtaining Xfce Source Code|Obtaining Xfce Source Code]]** 
-  * **[[building#Xfce dependencies explained|Xfce dependencies explained]]** +      * **[[#Released Packages|Released Packages]]** 
-  * **[[building#Building the packages|Building the packages]]** +      * **[[#From the Code Repository|From the Code Repository]]** 
-  * **[[building#Finding additional help|Finding additional help]]**+  * **[[#Xfce Dependencies Explained|Xfce Dependencies Explained]]** 
 +      * **[[#Build Requirements|Build Requirements]]** 
 +      * **[[#Xfce Dependency Chain |Xfce Dependency Chain ]]** 
 +      * **[[#Package Specific Dependencies|Package Specific Dependencies]]** 
 +  * **[[#Building Xfce packages|Building Xfce packages]]** 
 +      * **[[#Compiling and Installing|Compiling and Installing]]** 
 +  * **[[#Finding Additional Help|Finding Additional Help]]**
  
 ---- ----
  
-===== Choosing your Xfce version =====+===== Choosing an 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 indicates a development, or testing snapshot. The micro number increases with each release. Also, it is recommended to keep the major.minor version the same for the core components (some packages don't follow those numbers) or there will most likely be dependency version problems during compilation.+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, it is a stable release. An odd numbered minor version indicates a development, or testing snapshot. The micro number increases with each release. 
  
-The latest releases available can be found on the [[https://www.xfce.org/download|download]] page. You can also build from the source repositories if you have enough experience. Additional information about this is provided below.+It is recommended to keep the ''major.minor'' version the same for the core components (some packages don't follow those numbers) or there will most likely be dependency version problems during compilation. 
 + 
 +The latest stable releases can be found on the [[https://www.xfce.org/download|download]] page. You can also build from the source repositories. Additional information about this process is provided below.
  
 ---- ----
  
-===== Obtaining the Xfce source code =====+===== Obtaining Xfce Source Code =====
  
-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 choose to build official released packages, or clone the source repositories. Choosing the released packages is the recommended option. The source repositories could possibly be broken and are not generally suitable for production environments. However, they always contain the latest features, bug fixes and translations.+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 choose to build official released packages, or clone the source repositories.  
 + 
 +**Buildling from the released packages is the recommended option.** 
 + 
 +The source repositories could possibly be broken and are not generally suitable for production environments. However, they always contain the latest features, bug fixes and translations.
  
 If you are not sure which to choose, it is easiest to begin with the latest stable fat-tarball of a collection release. If you are not sure which to choose, it is easiest to begin with the latest stable fat-tarball of a collection release.
  
-==== Released packages ====+---- 
 + 
 +==== Released Packages ====
  
 Xfce packages have two types of releases: collection releases and individual releases. Click the links below to open the relevant download location. Xfce packages have two types of releases: collection releases and individual releases. Click the links below to open the relevant download location.
  
-  * [[https://archive.xfce.org/xfce/|Collection releases of the core modules]]\\ From time to time a new collection release of Xfce is made. A collection release consists of a number of individual tarballs and a fat-tarball that contains all of the individual tarballs.\\ The collection releases always contains the correct versions needed to build the other packages in the release. If you want the latest version of each package, you can start with a collection release and then look for individual bug fix releases, explained in the item below. +  * [[https://archive.xfce.org/xfce/|Collection releases of the core modules]]\\ Approximately every two years(in December), a new collection release of Xfce is made. A collection release consists of a number of individual tarballs and a fat-tarball that contains all of the individual tarballs.\\ The collection releases always contains the correct versions needed to build the other packages in the release. If you want the latest version of each package, you can start with a collection release and then look for individual bug fix releases, explained in the item below. 
   * [[https://archive.xfce.org/src/xfce/|Individual releases]]\\ Each package in Xfce is allowed to make development and stable releases at any time, see the [[http://xfce.org/about/releasemodel|release model]] documentation for more information.    * [[https://archive.xfce.org/src/xfce/|Individual releases]]\\ Each package in Xfce is allowed to make development and stable releases at any time, see the [[http://xfce.org/about/releasemodel|release model]] documentation for more information. 
  
-==== From the code repository ====+---- 
 + 
 +==== From the Code Repository ====
  
-For the latest code, you need to make local copies of the [[https://gitlab.xfce.org/|GIT repositories]]. This is the place where developers submit their code. If you decide to use GIT, try to use the same branch for all the packages to avoid dependency version problems.+For the latest code, you need to make local copies of the [[https://gitlab.xfce.org/|Git repositories]]. This is the place where developers submit their code. If you decide to use Git, try to use the same branch for all the packages to avoid dependency version problems.
  
 <note information>For additional information about using Git with Xfce, see the [[https://docs.xfce.org/contribute/dev/git/start|Xfce and git information]] page.</note> <note information>For additional information about using Git with Xfce, see the [[https://docs.xfce.org/contribute/dev/git/start|Xfce and git information]] page.</note>
  
-You first need to make clones of each GIT repository, like the command below, where ''$category'' is for example ''xfce'' and ''$module'' ''xfce4-panel''. If you click on a module in the [[https://gitlab.xfce.org/xfce|online repository]] list, the clone uri is shown at the bottom of the page.+You first need to make clones of each Git repository, like the command below, where ''$category'' is for example ''xfce'' and ''$module'' ''xfce4-panel''. If you click on a module in the [[https://gitlab.xfce.org/xfce|online repository]] list, the clone URI is shown in the ''Code'' dropdown button.
  
   git clone https://gitlab.xfce.org/$category/$module   git clone https://gitlab.xfce.org/$category/$module
  
-After the repository is cloned, you will need to choose which branch you want to compile. By default, the ''master'' branch is selected, but there are also branches for stable releases like ''xfce-4.22''. The stable branches contain the latest bug fixes without any major new features, the master branch is the development version for the next release of Xfce. Both should not be used in a production environment.+Once the repository is cloned, you will need to choose which branch to compile. By default, the ''master'' branch is selected, but there are also branches for stable releases like ''xfce-4.22''. The stable branches contain the latest bug fixes without any major new features, the master branch is the development version for the next release of Xfce. Neither branch should be used in a production environment.
  
 To switch to another branch (''git branch -a'' lists all available branches) run the following command inside the cloned directory to switch to, for example, the ''xfce-4.20'' branch: To switch to another branch (''git branch -a'' lists all available branches) run the following command inside the cloned directory to switch to, for example, the ''xfce-4.20'' branch:
Line 50: Line 67:
   git checkout --track origin/xfce-4.22   git checkout --track origin/xfce-4.22
  
-After this, you can update your local copy of the repository with git pull and switch to another branch with ''git checkout $branchname''. Read the [[http://git-scm.com/documentation|GIT manuals]] for more information about using GIT.+After this, you can update your local copy of the repository with the ''git pull'' command or switch to another branch with ''git checkout $branchname''. Read the [[http://git-scm.com/documentation|Git documentation]] for more information about using Git.
  
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
  
-===== Xfce Dependencies explained =====+===== Xfce Dependencies Explained =====
  
-==== Build requirements ====+==== 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 63: Line 80:
   * [[http://en.wikipedia.org/wiki/GNU_toolchain|A working GNU toolchain]]   * [[http://en.wikipedia.org/wiki/GNU_toolchain|A working GNU toolchain]]
   * Gtk+ and Glib headers, in some distributions called the -devel packages    * Gtk+ and Glib headers, in some distributions called the -devel packages 
-    * Xfce 4.20 requires Gtk+ 3.24 and Glib-2.0 >= 2.72 (See also: [[https://wiki.xfce.org/releng/4.20/roadmap#changes_in_dependencies|4.20 dependencies]])+    * Xfce 4.22 requires gtk3 >= 3.24.41 and glib >= 2.80.0 (See also: [[https://wiki.xfce.org/releng/4.22/roadmap#changes_in_dependencies|4.22 dependencies]])
       * Same version for gmodule-2.0, gobject-2.0, gthread-2.0, gio-2.0 and gdbus       * Same version for gmodule-2.0, gobject-2.0, gthread-2.0, gio-2.0 and gdbus
-    * gdk-pixbuf-2.0 >= 2.42.8 +    * gdk-pixbuf >= 2.42.10 
-    * gobject-introspection >= 1.72 +    * gobject-introspection >= 1.80.1 
-    * wayland 1.20 +    * wayland >= 1.22 
-    * wayland-protocols 1.25 +    * wayland-protocols >= 1.45 
-    * gtk-layer-shell 0.7.0+    * gtk-layer-shell-0 >= 0.8.2
     * pkgconfig     * pkgconfig
-    * meson (Xfce 4.21+)+    * meson >= 0.61.0 
     * Coffee or tea     * Coffee or tea
  
  
 For history, here are the versions needed for older Xfce releases: For history, here are the versions needed for older Xfce releases:
 +    * Xfce 4.22 requires Gtk+ 3.24.41 and Glib 2.80.0
     * Xfce 4.20 requires Gtk+ 3.24 and Glib 2.72     * Xfce 4.20 requires Gtk+ 3.24 and Glib 2.72
     * Xfce 4.18 requires Gtk+ 3.24 and Glib 2.66     * Xfce 4.18 requires Gtk+ 3.24 and Glib 2.66
     * Xfce 4.16 requires Gtk+ 3.22 and Glib 2.50     * Xfce 4.16 requires Gtk+ 3.22 and Glib 2.50
     * Xfce 4.14 requires Gtk+ 3.22 and Glib 2.42     * Xfce 4.14 requires Gtk+ 3.22 and Glib 2.42
-    * Xfce 4.12 requires Gtk+ 2.24 and Glib +    * Xfce 4.12 requires Gtk+ 2.24 and Glib 2.30
     * 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
  
 +----
  
-==== Xfce's dependency chain ====+==== Xfce 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.
  
-  * xfce4-dev-tools (only required if you build with autotools and from GIT)+  * xfce4-dev-tools (only required if you build with autotools and from Git)
   * libxfce4util   * libxfce4util
   * xfconf   * xfconf
Line 98: Line 117:
   * xfce4-panel, xfce4-settings, xfce4-session, xfdesktop, xfwm4, xfce4-appfinder, tumbler...   * xfce4-panel, xfce4-settings, xfce4-session, xfdesktop, xfwm4, xfce4-appfinder, tumbler...
  
-==== Package specific dependencies ====+---- 
 + 
 +==== Package Specific Dependencies ====
  
-Some core packages in Xfce have additional or optional dependencies, all are listed in the table below for the latest stable version. We only show the top-dependency (so xfce4-panel also requires gtk+, but libxfce4ui already depends on that).+Some core packages in Xfce have additional, or optional dependencies. They all are listed in the table below for the latest stable version. Only the top-dependency is shown (so xfce4-panel also requires GTK+, but libxfce4ui already depends on that).
  
-<note tip>Note that some of the package-names may vary between distributions.</note>+<note tip>Note that some of the package names may vary between distributions.</note>
  
-| ^ Dependency(-ies) ^ Optional Dependency(-ies) ^+| ^ Required Dependencies ^ Optional Dependencies ^
 ^ xfce4-dev-tools | autoconf, automake, intltool, pkgconfig | | ^ xfce4-dev-tools | autoconf, automake, intltool, pkgconfig | |
 ^ libxfce4util | glib2 | | ^ libxfce4util | glib2 | |
Line 123: Line 144:
 ---- ----
  
- +===== Building Xfce Packages =====
-===== Building the packages (meson) =====+
  
 <note important>This section is currently a work in progress, it applies for building from git master and Xfce 4.21+</note> <note important>This section is currently a work in progress, it applies for building from git master and Xfce 4.21+</note>
Line 130: Line 150:
 Now it is finally time to start compiling the Xfce desktop. Last remaining thing is to choose an installation location. Possible examples are ''/usr'', ''/usr/local'' and ''/opt/xfce4'' for a system-wide installation or ''$HOME/local'' if you want to install in your home directory (whatever you choose, never put spaces in the name). We will refer to this location as ${PREFIX} in the code examples below! Now it is finally time to start compiling the Xfce desktop. Last remaining thing is to choose an installation location. Possible examples are ''/usr'', ''/usr/local'' and ''/opt/xfce4'' for a system-wide installation or ''$HOME/local'' if you want to install in your home directory (whatever you choose, never put spaces in the name). We will refer to this location as ${PREFIX} in the code examples below!
  
-==== 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 149: Line 169:
 ---- ----
  
-===== Building the packages (autotools) =====+===== Finding Additional Help =====
  
-<note important>This section is deprecated, autotools support was removed after Xfce 4.20</note>+Hopefully everything went fine after reading this guide. More advanced options to build and debug Xfce applications can be found [[https://wiki.xfce.org/building/advanced|here]].
  
-==== Installation location and variables ====+If you are still having problems or questions, the following resources are available: 
  
-Now it is finally time to start compiling the Xfce desktop. Last remaining thing is to choose an installation location. Possible examples are ''/usr'', ''/usr/local'' and ''/opt/xfce4'' for a system-wide installation or ''$HOME/local'' if you want to install in your home directory (whatever you choose, never put spaces in the name). We will refer to this location as ${PREFIX} in the code examples below!+  * **[[https://matrix.to/#/#xfce-dev:matrix.org|xfce-dev Matrix channel]]** (Recommended Support channel) 
 +  * **[[https://mail.xfce.org/mailman/listinfo/xfce4-dev|Xfce Developers Mailing List]]** 
 +  * **[[https://forum.xfce.org|Xfce Support Forum]]** 
 +  * Distribution-specific questions should be asked on their respective forums and mailing lists.
  
-You need to make sure the ''PKG_CONFIG_PATH'' variable include the path to the *.pc files installed by the Xfce libraries: +Have fun building Xfce!
- +
-  export PKG_CONFIG_PATH="${PREFIX}/lib/pkgconfig:$PKG_CONFIG_PATH" +
- +
-You can also set some optimization flags for the compiler. This may speed up Xfce, but can also make debugging impossible on some systems. Even worse, this can also cause gcc to generate broken code, so be careful with this. The line below should be safe for most system. +
- +
-  export CFLAGS="-O2 -pipe" +
-  +
-If you want a debugging environment, unset the CFLAGS and use ''%%--enable-debug%%'', see below for the different debug levels. +
- +
-  export CFLAGS="" +
-   +
-==== 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: +
- +
-  ./configure --prefix=${PREFIX} && make && make install +
- +
-To build from GIT you need to install the xfce4-dev-tools package first, all other packages should be installed with this command: +
- +
-  ./autogen.sh --prefix=${PREFIX} && make && make install +
- +
-Specific configure options for each package can be shown with ''%%./configure --help%%''. Note that most packages will see a performance benefit if passed the configure option ''%%--disable-debug%%''.  +
- +
-However, if you want to provide backtraces or test new code, no ''$CFLAGS'', no binary stripping and ''%%--enable-debug=full%%'' are recommended. Please note that ''%%--disable-debug%%'' is not available for xfce4-dev-tools. +
- +
-<note>When reusing the ''%%./configure%%'' script while building from GIT remember to pass the flag ''%%--enable-maintainer-mode%%''.</note> +
- +
-If you install the package in a public prefix, for example ''/usr'' or ''/usr/local'', you will need to run ''make install'' using sudo. This way, you will be asked for the system administrator password and will have write permissions to install in those locations. +
- +
-  sudo make install +
- +
-If you want to uninstall the installed files, you can do so by executing: +
- +
-  sudo make uninstall +
- +
- +
-==== Understanding Debug levels ==== +
- +
-Most Xfce modules use the m4 macro //XDT_FEATURE_DEBUG// to manage the debug compiler levels. If so there are a number of options possible for ''%%--enable-debug=%%'' +
- +
-? no +
-! Cast checks and asserts in the Glib macros are disabled, this might be a tad faster, but it can results in segfaults and unexpected crashes. +
-? minimum +
-! This is the same as ''%%--disable-debug%%''. No additional compiler options are added, but checks in Glib are not disabled. This is the recommended level for users and distributions.  +
-? yes +
-! A number of ''$CFLAGS'' are set to check the code for different errors. During configure you'll see all the options are tested to avoid binaries that do not work. +
-? full +
-! Same as the level above, including ''-Werror'' so the compilers aborts during compiler errors. The compiler will also generate binaries with debug information suitable for [[:contribute:bugs:|backtraces]] and memory checks. This is the recommended level for developers or users who want to report bugs.+
  
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
-===== Finding additional Help ===== 
  
-Hopefully everything went fine after reading this guide. More advanced options to build and debug Xfce applications can be found [[https://wiki.xfce.org/building/advanced|here]].+[[:contribute:dev:start|Return to the Developer's Resource Page]]
  
-If you still have problems or questions you can ask on the [[https://www.xfce.org/community#mail|Xfce users mailing list]], the [[https://forum.xfce.org|forum]] or ask distribution related questions on their forums and mailing lists. +[[:4.22:start|Return to Xfce 4.22 Main Documentation Page]]
- +
-Have fun building Xfce! +
- +
-[[|Back To Top]] +
----- +
-[[:4.22:start|Back to Xfce 4.22 Main Documentation Page]]+