Getting Started/Build: Difference between revisions

Revision as of 14:02, 3 March 2011

Warning

This page is yet to be reviewed for changes required by the migration to Git. Information and commands on this page may no longer be valid and should be used with care. Please see the KDE Git hub page for more details.

Getting Started/Build

Here you will find instructions for compiling and installing KDE from source and suggestions for when compilation doesn't go so smoothly.

Introduction

Extra Information

The build process described in these pages is kept as simple and generic as possible, but it is generally assumed you are building KDE4 on Linux. Extra information about building KDE under specific platforms or conditions can be found at the following links:

Building KDE3 or KDE2
Project Neon on Kubuntu
Debian
FreeBSD
Microsoft Windows
Apple Mac OS X
On a Virtual Machine.
Linux
openSUSE Linux
Coexisting Versions: Directions to build multiple KDE versions on the same machine simultaneously.

Scripted Builds

The easiest way to build the KDE SC from scratch is to use one of the build scripts that are available. This approach is highly recommended for those new to building KDE SC. The builds remain compatible with the manual methods of building KDE SC so you can change later if you want.

The kdesrc-bld script by Michael Pyne
The build-tool script by Michael Jansen

Getting Ready

Manually building KDE Software requires that you first set up the build environment and install the required development tools and libraries.

Set up yourBuild Environment
Install the Build Requirements
Install or build Qt
Install or build kdesupport

Building From Source

Troubleshooting The Build

Compile and Linking errors are frequent sources of discouragement. Make careful note of the first occurrence of an error in your build process. It could be as simple as a bad environment variable, an unexpected version of a library or missing prerequisite.

Please review your logs and do searches for fixes. If you cannot find a solution, try the sources listed below. If you still cannot resolve the problem then please for help on IRC or a Mailing List. You can post your detailed issue from Build/Stories.

Troubleshooting
/KDE4/Errors
FAQ: Help with errors and other questions you might have.

@@ Line 17: / Line 17: @@
 * [[/Mac_OS_X|Apple Mac OS X]]
 * [[Getting_Started/Build/KDE4/on_virtual_machines|On a Virtual Machine]].
+* [[/KDE4|Linux]]
+* [http://en.opensuse.org/KDE/Developing/Guide openSUSE Linux]
+* [[/Coexisting Versions|Coexisting Versions]]: Directions to build multiple KDE versions on the same machine simultaneously.
 == Scripted Builds ==
@@ Line 24: / Line 27: @@
 * The [http://michael-jansen.biz/build-tool build-tool] script by Michael Jansen
-== Build Environment ==
+== Getting Ready ==
-The KDE Build System requires certain environment settings before it can build KDE software.  There are also further shortcut settings you can configure to make your like easier.  You can find the details of these on the [[../Environment|Build Environment]] page.
+Manually building KDE Software requires that you first set up the build environment and install the required development tools and libraries.
-== Build Requirements ==
-Building and running KDE software requires a number of supporting tools and libraries to be installed on your system.  You can find the details of these on the [[/Requirements|Build Requirements]] page.
-== Qt ==
-Building and running KDE software requires the Qt libraries to be installed on your system.  You can find the details of this on the [[/Qt|Qt]] page.
+* Set up your[[/Environment|Build Environment]]
+* Install the [[/Requirements|Build Requirements]]
+* Install or build [[/Qt|Qt]]
+* Install or build [[/KdeSupport|kdesupport]]
-== Building The Source ==
+== Building From Source ==
-* [[Getting_Started/Build/Requirements|Build Requirements]] from your distribution
-* [[Getting_Started/Sources/Anonymous_SVN|SVN]]
 * [[Getting_Started/Build/KDE4|Download and Build KDE SC from Git]]
 * [[Getting_Started/Build/KDE4.x|Build a stable 4.x release]]
 * [[Getting_Started/Set_up_KDE_4_for_development|Set up scripts]] to ease KDE development
+== Troubleshooting The Build ==
+Compile and Linking errors are frequent sources of discouragement. Make careful note of the first occurrence of an error in your build process. It could be as simple as a bad environment variable, an unexpected version of a library or missing prerequisite.
+Please review your logs and do searches for fixes. If you cannot find a solution, try the sources listed below.  If you still cannot resolve the problem then please [http://techbase.kde.org/Development/Getting_Help|ask for help] on IRC or a Mailing List. You can post your detailed issue from [[Build/Stories]].
-* [[/KDE4|Linux]]
+* [[/Troubleshooting|Troubleshooting]]
-** [http://en.opensuse.org/KDE/Developing/Guide openSUSE Linux]
+* [[/KDE4/Errors]]
+* [[/FAQ|FAQ]]: Help with errors and other questions you might have.
-; [[/Coexisting Versions|Coexisting Versions]]: Directions to build multiple KDE versions on the same machine simultaneously.
-; [[/FAQ|FAQ]]: Help with errors and other questions you might have.
-== Troubleshooting the build ==
-See [[../Troubleshooting|Troubleshooting]]
-Compile and Linking errors are frequent sources of discouragement. Make careful note of the first occurrence of an error in your build process. It could be as simple as a bad environment variable, an unexpected version of a library or missing prerequisite.
-Please review your logs and do searches for fixes. If you cannot find a solution, try [[Build/KDE4/Errors]], the IRC channel, and the mailing lists. You can post your detailed issue from [[Build/Stories]].
 [[Category:Build KDE]]