KDE TechBase - User contributions [en]

Contribute/Get a Contributor Account

2009-03-08T20:29:04Z

Powerfox: /* Getting the SSH keys */

{{Template:I18n/Language Navigation Bar|Contribute/Get a SVN Account}}
This tutorial is about how to apply for a SVN account for KDE.

== Notations ==

* The word ''SVN'' applies to all SVN servers.
* The phrase ''KDE SVN'' refers only to KDE's SVN server.
* The phrase ''anonymous SVN'' means KDE's anonymous SVN mirrors.

== What is KDE SVN? ==

To have write access to KDE SVN, you have to use the main SVN server of KDE. (Anonymous SVN uses mirrors of this server. SVN does not allow you to read from one server and write to another.)

To be able to use the main KDE SVN server, you need an account there. An account is made up of a ''username'' (normally your family name), a password and an email address. The username is for getting in, the password for authenticating and the email address for knowing who to contact if another developer wants to contact the account holder. (The username is sometimes known also as the ''login''.)

'''Note''': you can see the accounts in [http://websvn.kde.org/trunk/kde-common/accounts kde-common/accounts]. That is the list of all accounts. Yes, '''the account list is public''', for example on [http://websvn.kde.org WebSVN].

To access the main KDE SVN, you have two possibilities, with different ways to encrypt transmitted data:
* using HTTPS
* using SSH

If you have never used ssh before, you might prefer ''HTTPS'', it's a bit simpler to set up.

However it seems that currently svn-over-ssh is really much faster than svn-over-https, so that is a good reason for using ssh.

The password you will need to create depends on the above:
* a normal password for accessing by HTTPS, or
* a SSH public key for accessing by SSH

A KDE SVN account allows you to write to nearly anywhere in the KDE SVN. However, there are exceptions:
* the KDE SVN internals
* the admin directory
* the www module (exceptions can be made for this.)

== Who Can Apply For a KDE SVN Account? ==

Normally, any developer who has done some work on KDE can apply for a KDE SVN account.

Translators should get approval from their team leader so that they can organize how the work is being done in his/her team. Please mention the approval from the team leader when requesting the account.

Please also [[Policies/SVN Commit Policy|read the KDE SVN commit policy]]. You must accept these rules when using your future KDE SVN account.

Also please apply for an account only if you think that you will work on KDE for a somewhat longer time. If you know that you will only work for a couple of weeks and then never again, please consider not applying for a KDE SVN account but still, do continue to send patches.

The limitations are not there to exclude anyone - they are there to ensure that the maintenance of accounts remains reasonable.

Of course, to be clear: ''the [mailto:sysadmin@kde.org KDE's sysadmins] have the last word about whether or not to create a KDE SVN account for somebody''.

== Choosing a Password ==

This section assumes that you want access via HTTPS (without SSH). Otherwise skip this section.

First you have to choose a password. If possible, one that you do not use for anything else on your computer (as the SVN account has nothing to do with any other account on your computer.)

In any case, please use ''common precautions'' about passwords.

Strong passwords:
* have both upper and lower case letters.
* have digits and/or punctuation characters as well as letters.
* are easy to remember, so they do not have to be written down.
* are at least eight characters long.

A strong password is '''not''':

* Personal information such as your name, phone number, social security number, birth date or address. Even names of acquaintances and the like should not be used.
* Any word in the dictionary, or based closely on such a word (such as a word spelled backwards).
* A word with letters simply replaced by digits. For example, bl0wf1sh is not a strong password.
* Easy to spot while you're typing them in. Passwords like 12345, qwerty (i.e., all keys right next to each other), or nnnnnn should be avoided.

All the rules are not here to annoy you but to guarantee a certain level of security for the KDE SVN server.

== Getting the Encoded Password ==

This section assumes that you want access via HTTPS (without SSH). Otherwise skip this section.

Now that you have your password, you need to encode it, not to have to send it in clear. (Note: this encryption is the same type of encryption used by many Linux distributions for their {{path|/etc/shadow}} file.)

If your password is 8 characters long, one way to do this would be using Perl: 
<nowiki>perl -e 'print crypt("<your password>","\$1\$xyz\$")."\n";'</nowiki>
where <your password> has to be replaced with your password and ''xyz'' with 3 to 8 random characters of your choice. Leave the \$1\$ before it and the \$ after it.

(Hint: $ must be "escaped" with a backslash. For instance: If your password is "abc$123" you have to replace <your password> with "abc\$123". )

'''Note''': do not worry to find your choice of <xyz> at the start of the encoded password, it is meant to be so.

Another solution is to create a dummy account on a Unix system where you have administrator access. You can use the built-in user management programs of your distribution and search for the account in your file {{path|/etc/shadow}} or you can use the following code:
useradd dummy; passwd dummy; grep dummy /etc/passwd /etc/shadow; userdel dummy

In any case, the password is then the part between the first ':' and the second ':'. (Note: not a star! (*) That means that it is not the password!)

Save the encoded password so that you can use it later in the application.

== Getting the SSH keys ==

This section assumes that you want access via SSH (not with HTTPS). Otherwise skip this section.

Please refer to a SSH documentation or book to see how to create a pair of SSH keys, the short version is <code bash>ssh-keygen -t dsa</code>
The '-t dsa' indicates that 'dsa' type keys should be created. Dsa and rsa keys are used in the version 2 of the SSH protocol, whereas rsa keys are used in version 1. See the [http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen ssh documentation] for more. Accept the default filename and the default of no passphrase.

You '''need''' a SSH public key. Don't send us a GPG (OpenPGP) key, that is completely unrelated!

The password in the sense of this documentation is the '''public key''' that you are creating. The public key can usually be found at {{path|$HOME/.ssh/id_dsa.pub}}.

Do '''not''' send the private key at {{path|$HOME/.ssh/id_dsa}}, it has to remain a secret.

You should also set up <tt>ssh-agent</tt> so you do not have to type the password every time. There are several tutorials available explaining how to do this, for example [http://mah.everybody.org/docs/ssh this one].

'''Note''': if you already have an ssh key, you can just use the extisting key instead of creating a new one.

{{tip|
If you want to use SVN with SSH with another user than the one who created the keys, you need to copy <tt>$HOME/.ssh/id_dsa.pub</tt> and <tt>$HOME/.ssh/id_dsa</tt> to the other user's <tt>$HOME/.ssh</tt> directory.

You should probably also backup those files.
}}

=== Setting up SVN+SSH protocol ===

Once you created your key, you'll have to tell SSH that this one should be used for all connections to KDE sites. Add the following lines to the <tt>~/.ssh/config</tt> file. Replace USERNAME with yours.

<pre>
Host *.kde.org
User USERNAME
IdentityFile ~/.ssh/id_dsa
</pre>

The linked IdentityFile must belong to the public key you send in when applying for the SVN account. But it is ''not'' the public key (<tt>*.pub</tt>).

== Apply for an account ==

Now that you have a password, you need a username for your KDE SVN account. Normally your family name is used. Let us call it ''username'' for this example.

You can propose something else if you want. But be careful that one day, you could ask for a KDE email address and this would be the base for your address. For example: <tt>username@kde.org</tt>. (Note, however, that KDE email addresses are not granted so easily anymore, as too many people have ranted with a KDE address and other people thought that it was the official position of the KDE Team. In the meantime, [http://www.kdemail.net KDE Mail] was created for if you need a permanent address.)

So now you have a username and a password. Now the email address: you have to use your own (be it a normal address or a KDE Mail address). Of course, do not forget that this '''email address becomes public''' (at least by [http://websvn.kde.org WebSVN]) so you will unfortunately get spam.

Also note that this email address should be the same one that you use on [http://bugs.kde.org bugs.kde.org]. If you don't have one, please create it so that it can be given usual developer rights. Closing bug reports with keywords in commit comments only works if the email address of your Subversion and [http://bugs.kde.org bugs.kde.org] accounts match.

Now you are ready to apply for for a KDE SVN account.
Go to [https://sysadmin.kde.org/svnaccount/ https://sysadmin.kde.org/svnaccount/] and fill out the form. It should be easy to do now.

After filling out the form, you will receive an email with a link to click on. This is done to verify your email address. The application is not complete before you click on it.

Also note that the form will ask you who has encouraged you to apply. He or she will also get an email to verify your request.

The form also holds a field ''justification'', here you can explain what you want to do with your future KDE SVN account, like for examples developing a certain application, making documentations, being team leader of a translation...

== And Now? ==

After having sent the form and clicking the link in the email, you have to wait for the answer (typically within two or three days).

Once you have confirmation that your account has been created, you need to adapt your local copy to the new server. See the [[Contribute/First Steps with your KDE SVN Account|next tutorial]] for your first steps with your new account.

Please add your geographical location (what country are you in?) and other details at the [http://commit-digest.org/data/ Commit Digest data page] so that the Commit Digest can accurately reflect who is working where.

Development/Tutorials/Debugging/Using Error Messages

2008-08-28T13:08:51Z

Powerfox: /* Links */

{{Template:I18n/Language_Navigation_Bar|Development/Tutorials/Debugging/Using Error Messages}}

When you start a konsole and type the commands to start an application you
will see all sorts of statements are printed in the konsole while the
application is running. All applications print these messages, to look
at them you have to know where to look. The application will have to be
compiled with the debugging enabled. So using a precompiled package from a distribution
probably will not give you this information. If you compiled the application
yourself, make sure the configure option "<tt>--disable-debug</tt>" was not used.

In KDE all debugging text-output can be switched on or off based on so
called '''areas'''. One application can be one or more area. One part of the kde base libraries can be another area. Enabling/disabling these areas from being printed can be done using the '''kdebugdialog''' application. For simple debugging selecting all
sections is probably wise.

When you are debugging it is best to simply start a konsole and start the
application from there. In a konsole you could simply type:

kicker

and in the konsole kicker could return a message like:

ERROR: kicker is already running!

When a lot of output is written to the konsole it might go out of view before
you could read it, therefor it is easy to create a text file which contains
all this information, to do so type the following:

application 2>&1 | tee debug.log

where 'application' can be replaced with the application you are debugging.
Afterwards you could open the file 'debug.log' to look at the messages again.

If you are NOT starting the application from a konsole the messages will be
logged somewhere else, or they could have been discarded by the program that
started your application.

If your application is started by clicking on an icon your best bet is to check
the following log files. Beware; they contain logs for a lot of applications,
not just the application you are debugging!

'''Case 1: Graphical login (i.e. kdm, gdm, xdm, etc.'''

The debug messages get redirected into the file {{path|~/.xsession-errors}} or
{{path|~/.X.err}} in your home directory (that is with a leading dot '.' also
watch the Capital).

'''Case 2: You are using startx:'''

Use the following command to restart your session:
startx 2>&1 | tee startx.log

so that all the debug messages of applications started at KDE's startup (and
any application launched from the panel etc.) go to the file "startx.log"

== Links ==

The debug messages are usually printed in C++ with the kDebug or kWarning statement. Example:

kDebug(1210) << "arbitrary message";
kWarning(1210) << "this rather should not happen";

The number 1210 (so called ''debug area'') in this case represents kicker. You can omit the number.

See also: [http://api.kde.org/4.0-api/kdelibs-apidocs/kdecore/html/group__kdebug.html kDebug/kWarning API documentation] and [http://websvn.kde.org/trunk/KDE/kdelibs/kdecore/kdebug.areas?view=markup kdebug.areas] for list of debug areas numbers.
Note that you can use add_definition(-DKDE_DEFAULT_DEBUG_AREA=<number> ) in CmakeLists.txt to specify default debug area.

''Initial Author:'' [mailto:zander@kde.org Thomas Zander]

Development/Tutorials/Debugging/Using Error Messages

2008-08-28T13:08:11Z

Powerfox: /* Links */ Note about kdebug.areas

{{Template:I18n/Language_Navigation_Bar|Development/Tutorials/Debugging/Using Error Messages}}

When you start a konsole and type the commands to start an application you
will see all sorts of statements are printed in the konsole while the
application is running. All applications print these messages, to look
at them you have to know where to look. The application will have to be
compiled with the debugging enabled. So using a precompiled package from a distribution
probably will not give you this information. If you compiled the application
yourself, make sure the configure option "<tt>--disable-debug</tt>" was not used.

In KDE all debugging text-output can be switched on or off based on so
called '''areas'''. One application can be one or more area. One part of the kde base libraries can be another area. Enabling/disabling these areas from being printed can be done using the '''kdebugdialog''' application. For simple debugging selecting all
sections is probably wise.

When you are debugging it is best to simply start a konsole and start the
application from there. In a konsole you could simply type:

kicker

and in the konsole kicker could return a message like:

ERROR: kicker is already running!

When a lot of output is written to the konsole it might go out of view before
you could read it, therefor it is easy to create a text file which contains
all this information, to do so type the following:

application 2>&1 | tee debug.log

where 'application' can be replaced with the application you are debugging.
Afterwards you could open the file 'debug.log' to look at the messages again.

If you are NOT starting the application from a konsole the messages will be
logged somewhere else, or they could have been discarded by the program that
started your application.

If your application is started by clicking on an icon your best bet is to check
the following log files. Beware; they contain logs for a lot of applications,
not just the application you are debugging!

'''Case 1: Graphical login (i.e. kdm, gdm, xdm, etc.'''

The debug messages get redirected into the file {{path|~/.xsession-errors}} or
{{path|~/.X.err}} in your home directory (that is with a leading dot '.' also
watch the Capital).

'''Case 2: You are using startx:'''

Use the following command to restart your session:
startx 2>&1 | tee startx.log

so that all the debug messages of applications started at KDE's startup (and
any application launched from the panel etc.) go to the file "startx.log"

== Links ==

The debug messages are usually printed in C++ with the kDebug or kWarning statement. Example:

kDebug(1210) << "arbitrary message";
kWarning(1210) << "this rather should not happen";

The number 1210 (so called ''debug area'') in this case represents kicker. You can omit the number.

See also: [http://api.kde.org/4.0-api/kdelibs-apidocs/kdecore/html/group__kdebug.html kDebug/kWarning API documentation] and [http://websvn.kde.org/trunk/KDE/kdelibs/kdecore/kdebug.areas?view=markup] for list of debug areas numbers.
Note that you can use add_definition(-DKDE_DEFAULT_DEBUG_AREA=<number> ) in CmakeLists.txt to specify default debug area.

''Initial Author:'' [mailto:zander@kde.org Thomas Zander]

Development/Tutorials/Debugging/Debugging with GDB

2008-06-20T15:31:24Z

Powerfox: /* Debugging core files with GDB */

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Debugging/Debugging with GDB}}
This is a short tutorial on debugging KDE applications. Throughout this
tutorial I will use "kedit" as an example application.

==Debugging with GDB==

The recommended version of gdb to use is version 4.95 or higher; older
versions have problems generating proper backtraces.

There are three ways to debug an application with gdb:

# You can start the application from within gdb.
# You can attach gdb to an already running application.
# You can run gdb after an application has crashed using a core file.

==Starting applications from within gdb==

To start an application with gdb you can start gdb as follows:

> gdb kedit
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
(gdb)

You can now set the command line arguments that you want to pass to kedit with
the gdb command "<tt>set args</tt>":

(gdb) set args myfile.txt
(gdb)

gdb has loaded the kedit executable on startup but it hasn't loaded any of
the libraries yet. This means that you can't set any breakpoints in the
libraries yet. The easiest way to do that is to set a breakpoint in the
first line of main and then start the program:

(gdb) break main
Breakpoint 1 at 0x804855c
(gdb) run
Starting program: /ext/kde2.0/bin/kedit myfile.txt
Breakpoint 1 at 0x4002cf18: file kedit.cpp, line 1595.

Breakpoint 1, main (argc=2, argv=0xbffff814) at kedit.cpp:1595
1595 bool have_top_window = false;
Current language: auto; currently c++
(gdb)

You can now set breakpoints everywhere. For example lets set a breakpoint
in the KApplication constructor. Unfortunately, gdb is not very good in
handling C++ names, so it is not really possible to specify the constructor
directly after the break command. Instead we look up a line of source
code where we want to place the breakpoint. An external editor is of great
use at this point. With the list command we can select the source file we
are interested in and verify that we have found the correct source line:

(gdb) list kapp.cpp:220
215 parseCommandLine( argc, argv );
216 }
217
218 KApplication::KApplication( bool allowStyles, bool GUIenabled ) :
219 QApplication( *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
220 GUIenabled ),
221 KInstance( KCmdLineArgs::about),
222 d (new KApplicationPrivate)
223 {
224 if (!GUIenabled)
(gdb) break 224
Breakpoint 2 at 0x4048aa7e: file kapp.cpp, line 224.
(gdb)

We can now continue the execution of kedit. Execution will stop when it hits
a breakpoint or when the program exits. In this case execution will stop
in the first line of the KApplication constructor:

(gdb) continue
Continuing.
Qt: gdb: -nograb added to command-line options.
Use the -dograb option to enforce grabbing.

Breakpoint 2, KApplication::KApplication (this=0xbffff6a8, allowStyles=true,
GUIenabled=true) at kapp.cpp:224
224 if (!GUIenabled)
(gdb)

Important: many applications use "KUniqueApplication" to ensure that only one instance can exist at a given time in a given KDE session. This is the case for kwin, kontact, konsole, plasma, etc. To debug those applications, attach to them while they're running (see next session) or use <code>set args --nofork</code>

==Attaching gdb to already running applications==

Sometimes it is not practical to start an application from within gdb.
E.g. in those cases where you didn't know the application was about to
crash :-) When you get the friendly DrKonqi dialog informing you about
a crash you are just in time to start your debugger.

First lets attach gdb to an application that hasn't crashed (yet).

You start with finding the process of the application with e.g. "ps -aux":

> ps -aux | grep kedit
bastian 21570 15.1 6.8 13740 8800 pts/6 S 15:34 0:01 kedit
bastian 21582 0.0 0.3 1132 412 pts/6 R 15:34 0:00 grep kedit

From this you learn that kedit has process id 21570. Now you can start gdb as
follows:

> gdb kedit 21570
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
/home1/bastian/21570: No such file or directory.
Attaching to program: /ext/kde2.0/bin/kedit, Pid 21570
Reading symbols from /ext/kde2.0/lib/kedit.so.0...done.
Loaded symbols for /ext/kde2.0/lib/kedit.so.0
...
Reading symbols from /lib/ld-linux.so.2...done.
Loaded symbols for /lib/ld-linux.so.2
Reading symbols from /lib/libnss_compat.so.2...done.
Loaded symbols for /lib/libnss_compat.so.2
Reading symbols from /lib/libnsl.so.1...done.
Loaded symbols for /lib/libnsl.so.1
0x40c3d88e in __select () from /lib/libc.so.6
(gdb)

You will usually end up in the middle of a select() call from the event-loop.
This is the place where a KDE application spends most of its time, waiting
for things to happen.

A backtrace will typically look something like this:

(gdb) bt
#0 0x40c3d88e in __select () from /lib/libc.so.6
#1 0x40a22844 in __DTOR_END__ () at fam.c++:356
#2 0x407293bf in QApplication::enter_loop (this=0xbffff6e8)
at kernel/qapplication.cpp:2552
#3 0x406b1d7b in QApplication::exec (this=0xbffff6e8)
at kernel/qapplication_x11.cpp:2217
#4 0x4002d500 in main (argc=1, argv=0xbffff854) at kedit.cpp:1662
#5 0x40bbba5e in __libc_start_main (main=0x8048568 <main>, argc=1,
argv=0xbffff854, init=0x8048514 <_init>, fini=0x80486cc <_fini>,
rtld_fini=0x4000aa20 <_dl_fini>, stack_end=0xbffff84c)
at ../sysdeps/generic/libc-start.c:92
(gdb)

==Debugging core files with GDB==

Debugging process requires much memory. If you have to inspect crash, you can debug core files. It's much faster and requires less memory. First limit the maximum size of core files and run the application:
ulimit -c 100000
kedit --nocrashhandler
Don't forget to use '--nocrashhandler' option. Core file would be created if the application crashed, so you can use gdb with created core file:
gdb kedit ./core-file #in my system it is core.PID

==Improving your gdb experience for KDE/Qt applications==

In the SVN path named "kdesdk", you will find the file [http://websvn.kde.org/trunk/KDE/kdesdk/scripts/kde-devel-gdb kdesdk/scripts/kde-devel-gdb].
This file contains a few macros that help looking into some Qt objects (for instance QString).
See the beginning of the file for instructions on how to use it.

If you want to go even further, you can apply those [http://developer.kde.org/documentation/other/gdb-patches patches to the gdb source],
to fix a few annoyancies in gdb:

* source.c: don't try to open a directory in "." that has the same name as the executable we want to open (not needed for gdb-6.0 and above)
* symfile.c: no prompting at end of page while opening shared libraries (not needed for gdb-6.2 and above)
* solib.c: less output when opening shared libraries

Those patches are maintained by [mailto:faure@kde.org David Faure].

Have fun with gdb! Hmm, ok, the definition of 'fun' is very relative...

Development/Tutorials/Debugging/Debugging with GDB

2008-06-20T13:38:50Z

Powerfox: Added debugging core files section

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Debugging/Debugging with GDB}}
This is a short tutorial on debugging KDE applications. Throughout this
tutorial I will use "kedit" as an example application.

==Debugging with GDB==

The recommended version of gdb to use is version 4.95 or higher; older
versions have problems generating proper backtraces.

There are three ways to debug an application with gdb:

# You can start the application from within gdb.
# You can attach gdb to an already running application.
# You can run gdb after an application has crashed using a core file.

==Starting applications from within gdb==

To start an application with gdb you can start gdb as follows:

> gdb kedit
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
(gdb)

You can now set the command line arguments that you want to pass to kedit with
the gdb command "<tt>set args</tt>":

(gdb) set args myfile.txt
(gdb)

gdb has loaded the kedit executable on startup but it hasn't loaded any of
the libraries yet. This means that you can't set any breakpoints in the
libraries yet. The easiest way to do that is to set a breakpoint in the
first line of main and then start the program:

(gdb) break main
Breakpoint 1 at 0x804855c
(gdb) run
Starting program: /ext/kde2.0/bin/kedit myfile.txt
Breakpoint 1 at 0x4002cf18: file kedit.cpp, line 1595.

Breakpoint 1, main (argc=2, argv=0xbffff814) at kedit.cpp:1595
1595 bool have_top_window = false;
Current language: auto; currently c++
(gdb)

You can now set breakpoints everywhere. For example lets set a breakpoint
in the KApplication constructor. Unfortunately, gdb is not very good in
handling C++ names, so it is not really possible to specify the constructor
directly after the break command. Instead we look up a line of source
code where we want to place the breakpoint. An external editor is of great
use at this point. With the list command we can select the source file we
are interested in and verify that we have found the correct source line:

(gdb) list kapp.cpp:220
215 parseCommandLine( argc, argv );
216 }
217
218 KApplication::KApplication( bool allowStyles, bool GUIenabled ) :
219 QApplication( *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
220 GUIenabled ),
221 KInstance( KCmdLineArgs::about),
222 d (new KApplicationPrivate)
223 {
224 if (!GUIenabled)
(gdb) break 224
Breakpoint 2 at 0x4048aa7e: file kapp.cpp, line 224.
(gdb)

We can now continue the execution of kedit. Execution will stop when it hits
a breakpoint or when the program exits. In this case execution will stop
in the first line of the KApplication constructor:

(gdb) continue
Continuing.
Qt: gdb: -nograb added to command-line options.
Use the -dograb option to enforce grabbing.

Breakpoint 2, KApplication::KApplication (this=0xbffff6a8, allowStyles=true,
GUIenabled=true) at kapp.cpp:224
224 if (!GUIenabled)
(gdb)

Important: many applications use "KUniqueApplication" to ensure that only one instance can exist at a given time in a given KDE session. This is the case for kwin, kontact, konsole, plasma, etc. To debug those applications, attach to them while they're running (see next session) or use <code>set args --nofork</code>

==Attaching gdb to already running applications==

Sometimes it is not practical to start an application from within gdb.
E.g. in those cases where you didn't know the application was about to
crash :-) When you get the friendly DrKonqi dialog informing you about
a crash you are just in time to start your debugger.

First lets attach gdb to an application that hasn't crashed (yet).

You start with finding the process of the application with e.g. "ps -aux":

> ps -aux | grep kedit
bastian 21570 15.1 6.8 13740 8800 pts/6 S 15:34 0:01 kedit
bastian 21582 0.0 0.3 1132 412 pts/6 R 15:34 0:00 grep kedit

From this you learn that kedit has process id 21570. Now you can start gdb as
follows:

> gdb kedit 21570
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
/home1/bastian/21570: No such file or directory.
Attaching to program: /ext/kde2.0/bin/kedit, Pid 21570
Reading symbols from /ext/kde2.0/lib/kedit.so.0...done.
Loaded symbols for /ext/kde2.0/lib/kedit.so.0
...
Reading symbols from /lib/ld-linux.so.2...done.
Loaded symbols for /lib/ld-linux.so.2
Reading symbols from /lib/libnss_compat.so.2...done.
Loaded symbols for /lib/libnss_compat.so.2
Reading symbols from /lib/libnsl.so.1...done.
Loaded symbols for /lib/libnsl.so.1
0x40c3d88e in __select () from /lib/libc.so.6
(gdb)

You will usually end up in the middle of a select() call from the event-loop.
This is the place where a KDE application spends most of its time, waiting
for things to happen.

A backtrace will typically look something like this:

(gdb) bt
#0 0x40c3d88e in __select () from /lib/libc.so.6
#1 0x40a22844 in __DTOR_END__ () at fam.c++:356
#2 0x407293bf in QApplication::enter_loop (this=0xbffff6e8)
at kernel/qapplication.cpp:2552
#3 0x406b1d7b in QApplication::exec (this=0xbffff6e8)
at kernel/qapplication_x11.cpp:2217
#4 0x4002d500 in main (argc=1, argv=0xbffff854) at kedit.cpp:1662
#5 0x40bbba5e in __libc_start_main (main=0x8048568 <main>, argc=1,
argv=0xbffff854, init=0x8048514 <_init>, fini=0x80486cc <_fini>,
rtld_fini=0x4000aa20 <_dl_fini>, stack_end=0xbffff84c)
at ../sysdeps/generic/libc-start.c:92
(gdb)

==Debugging core files with GDB==

Debugging process requires much memory. If you have to inspect crash, you can debug core files. It's much faster and requires less memory. First limit the maximum size of core files and run the application:
ulimit -c 100000
kdevelop --nocrashhandler
Don't forget to use '--nocrashhandler' option. Core file would be created if the application crashed, so you can use gdb with created core file:
gdb kedit ./core-file #in my system it is core.PID

==Improving your gdb experience for KDE/Qt applications==

In the SVN path named "kdesdk", you will find the file [http://websvn.kde.org/trunk/KDE/kdesdk/scripts/kde-devel-gdb kdesdk/scripts/kde-devel-gdb].
This file contains a few macros that help looking into some Qt objects (for instance QString).
See the beginning of the file for instructions on how to use it.

If you want to go even further, you can apply those [http://developer.kde.org/documentation/other/gdb-patches patches to the gdb source],
to fix a few annoyancies in gdb:

* source.c: don't try to open a directory in "." that has the same name as the executable we want to open (not needed for gdb-6.0 and above)
* symfile.c: no prompting at end of page while opening shared libraries (not needed for gdb-6.2 and above)
* solib.c: less output when opening shared libraries

Those patches are maintained by [mailto:faure@kde.org David Faure].

Have fun with gdb! Hmm, ok, the definition of 'fun' is very relative...

Talk:Archive:Development/Tutorials/Git

2008-05-10T12:04:47Z

Powerfox: Link

Lots of good ideas can be found here; [http://wiki.winehq.org/GitWine Git tutorial at WineHq].
I am in the process of writing a front-end that is more userfriendly; it may be useful to link to it [http://vng.googlecode.com home] [http://repo.or.cz/w/vng.git repo].
[[User:Zander|Zander]] 09:51, 21 April 2008 (CEST)

A little article about Git + KDevplatform: http://www.kdevelop.org/mediawiki/index.php/Using_Git
It covers svn:externals. May I add it to the article?
[[User:powerfox|powerfox]] 16:04, 10 May 2008

Getting Started/Build/KDE4 (ru)

2008-04-08T10:24:12Z

Powerfox: Warning! The page is out of date!

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

{{warning|Внимание! Страница устарела! Рекомендую использовать статью на английском (хотя бы инструкции оттуда (список команд). Смогу обновить перевод не раньше, чем на майских праздниках.
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== Установка необходимых пакетов в различных дистрибутивах ==

Зависимости для сборки kde4 значительно различаются в разных дистрибутивах. Ниже преведены ссылки на инструкции для различных дистрибутивов:

* [[../KDE4/Ark Linux (ru)|Ark Linux]]
* [[../KDE4/Arch Linux (ru)|Arch Linux]]
* [[../KDE4/Fedora (ru)|Fedora]]
* [[../KDE4/Kubuntu and Debian (ru)|Kubuntu and Debian]]
* [[../KDE4/openSUSE (ru)|openSUSE]]
* [[../KDE4/Gentoo (ru)|Gentoo]]
* [[../KDE4/Mandriva (ru)|Mandriva]]

С чего продолжить установку зависит от того, какой дистрбутив вы используете.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. However, this should only be required for older distros.

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc4</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc4}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас доступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started (ru)

2008-03-19T13:40:03Z

Powerfox:

{{Template:I18n/Language Navigation Bar|Getting_Started}}
{{Box|Как получить исходный код|
[[Image:Action_down.svg|right|32px]]

* [[Getting_Started/Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]
* [[Getting_Started/Sources/Using_Subversion_with_KDE|Работа с Subversion-репозиторием KDE]] ''Более детальное описание по доступу к исходному коду KDE с помощью subversion: включает схему репозитория (repository layout) и инструкции по работе с версиями и патчами.''
* [[Getting_Started/Sources/Snapshots|Ежедневные снимки (Snapshots)]]
* [http://websvn.kde.org/ Просмотр репозитория онлайн]
|100%}}

{{Box|Сборка KDE|
[[Image:Action_tool.svg|right|32px]]
Существует несколько ветвей KDE. Для «промышленного» использования рекомендуется стабильная версия KDE.
* [[Getting_Started/Build/KDE4_(ru)|KDE 4 (Версия для разработчиков, TRUNK)]]
* [[Getting_Started/Build/KDE4.0|KDE 4 (Текущий релиз или ВЕТВЬ)]]
* [[Getting_Started/Build/KDE4-both|KDE4 (Установка и TRUNC, и BRANCH)]]
* [[Getting_Started/Build/Stable Version|KDE 3.5 (Стабильная версия)]]
* [[Getting_Started/Build|Другие версии и FAQ]] '', включая информацию по сборке на системах отличных от GNU/Linux''
|100%}}

{{Box|Настройка окружения|
[[Image:Action_pen.svg|right|32px]]
После сборки KDE неплохо бы узнать о том как запускать приложения и выполнять регулярные задачи по разработке:
* [[Getting_Started/Increased Productivity in KDE4 with Scripts|Повышение вашей продуктивности в KDE4 с помощью скриптов]]
* [[Getting_Started/Set up KDE 4 for development_(ru)|Настройка KDE4 для разработки]]
|100%}}
[[Category:Build KDE]]

Getting Started (ru)

2008-03-19T13:39:21Z

Powerfox: Update

{{Template:I18n/Language Navigation Bar|Getting_Started}}
{{Box|Как получить исходный код|
[[Image:Action_down.svg|right|32px]]

* [[Getting_Started/Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]
* [[Getting_Started/Sources/Using_Subversion_with_KDE|Работа с Subversion-репозиторием KDE]] ''Более детальное описание по доступу к исходному коду KDE с помощью subversion: включает схему репозитория (repository layout) и инструкции по работе с версиями и патчами.''
* [[Getting_Started/Sources/Snapshots|Ежедневные снимки (Snapshots)]]
* [http://websvn.kde.org/ Просмотр репозитория онлайн]
|100%}}

{{Box|Сборка KDE|
[[Image:Action_tool.svg|right|32px]]
Существует несколько ветвей KDE. Для «промышленного» использования рекомендуется стабильная версия KDE.
* [[Getting_Started/Build/KDE4_(ru)|KDE 4 (Версия для разработчиков, TRUNK)]]
* [[Getting_Started/Build/KDE4.0|KDE 4 (Текущий релиз или BRANCH(ВЕТВЬ)]]
* [[Getting_Started/Build/KDE4-both|KDE4 (Установка и TRUNC, и BRANCH)]]
* [[Getting_Started/Build/Stable Version|KDE 3.5 (Стабильная версия)]]
* [[Getting_Started/Build|Другие версии и FAQ]] '', включая информацию по сборке на системах отличных от GNU/Linux''
|100%}}

{{Box|Настройка окружения|
[[Image:Action_pen.svg|right|32px]]
После сборки KDE неплохо бы узнать о том как запускать приложения и выполнять регулярные задачи по разработке:
* [[Getting_Started/Increased Productivity in KDE4 with Scripts|Повышение вашей продуктивности в KDE4 с помощью скриптов]]
* [[Getting_Started/Set up KDE 4 for development_(ru)|Настройка KDE4 для разработки]]
|100%}}
[[Category:Build KDE]]

Getting Started/Build/KDE4/Kubuntu and Debian (ru)

2008-01-12T20:19:22Z

Powerfox: From Build

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Kubuntu and Debian}}

Здесь приведено уточнение всех зависимостей, которые должны быть удовлетворены в Kubuntu 7.10 (Gutsy) и Debian (Testing/Unstable), чтобы получить минимальное работающее окружение. Их можно установить с помощью команды, приведённой ниже:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
kdesdk-scripts subversion ssh xserver-xephyr doxygen libqt4-dev dbus-x11 \
libstreamanalyzer-dev libstrigiqtdbusclient-dev \
libxml2-dev libxslt1-dev shared-mime-info libungif4-dev libssl-dev \
libboost-dev libgpgme11-dev libxine-dev libqimageblitz-dev
</code>

Будут установлены некоторые необходимые для любой сборки пакеты (такие как build essential) и будут удовлетворены все зависимости, выполнение которых необходимо для сборки KDE 4, и установлены некоторые рекомендованные пакеты (например, libssl-dev для поддержки https). Soprano, рекомендованный к установке, следует [[#Install soprano from svn|устанавливать из svn]]. Остальные необязательные и рекомендованные пакеты перечислены ниже.

После установки всех требуемых пакетов вернитесь к
[[Getting_Started/Build/KDE4#kdelibs|сборке KDE 4]].

== Необходимое для сборки программное обеспечение ==

В Kubuntu 7.04 (Feisty) и Debian (Testing/Unstable) необходимое программное обеспечение можно установить следующей командой:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

В Kubuntu 7.10 (Gutsy) и Debian unstable следует добавить:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev libxkbfile-dev
</code>

Для того чтобы задействовать всю функциональность системы документации (API documentation framework), также выполните:
<code>
sudo aptitude install graphviz
</code>

В Kubuntu Gutsy и Debian unstable нет никакой необходимости компилировать qt или kdesupport. Все необходимые пакеты доступны после процедуры описанной в настоящем разделе, потому переходите сразу к [[#kdelibs|сборке kdelibs]], перед этим только [[#Создание пользователя для разработки KDE 4|создав отдельного пользователя в системе для запуска программ KDE4]].

{{Note|При возникновении проблем при компиляции KDE4 Beta4 или выше в Kubuntu 7.10, похожих на:

Soprano version is too low

strigi xxx.h not found...

Необходимо обновить и собрать соответствующую часть исходного кода kdesupport.
Это описано в разделе о сборке kdesupport.

Также удалите пакет soprano: sudo apt-get remove libsoprano4 libsoprano-dev (этот пакет мы соберём из исходников самостоятельно)

If you still get an error in the kdelibs section about soprano like:
CMake Error: Error in cmake code at
$src/KDE/kdelibs/cmake/modules/FindSoprano.cmake:78:
FILE Internal CMake error when trying to open file: /usr/include/soprano/version.h for reading.

then delete kdelibs/CMakeCache.txt
}}

Getting Started/Build/KDE4 (ru)

2008-01-12T20:17:04Z

Powerfox: /* Установка необходимых пакетов в различных дистрибутивах */ Links correction

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== Установка необходимых пакетов в различных дистрибутивах ==

Зависимости для сборки kde4 значительно различаются в разных дистрибутивах. Ниже преведены ссылки на инструкции для различных дистрибутивов:

* [[../KDE4/Ark Linux (ru)|Ark Linux]]
* [[../KDE4/Arch Linux (ru)|Arch Linux]]
* [[../KDE4/Fedora (ru)|Fedora]]
* [[../KDE4/Kubuntu and Debian (ru)|Kubuntu and Debian]]
* [[../KDE4/openSUSE (ru)|openSUSE]]
* [[../KDE4/Gentoo (ru)|Gentoo]]
* [[../KDE4/Mandriva (ru)|Mandriva]]

С чего продолжить установку зависит от того, какой дистрбутив вы используете.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас доступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (ru)

2008-01-12T20:12:03Z

Powerfox: Update

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== Установка необходимых пакетов в различных дистрибутивах ==

Зависимости для сборки kde4 значительно различаются в разных дистрибутивах. Ниже преведены ссылки на инструкции для различных дистрибутивов:

* [[/Ark Linux|Ark Linux]]
* [[/Arch Linux|Arch Linux]]
* [[/Fedora|Fedora]]
* [[/Kubuntu and Debian|Kubuntu and Debian]]
* [[/openSUSE|openSUSE]]
* [[/Gentoo|Gentoo]]
* [[/Mandriva|Mandriva]]

С чего продолжить установку зависит от того, какой дистрбутив вы используете.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас доступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4/Mandriva (ru)

2008-01-12T19:57:32Z

Powerfox: From Build

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Mandriva}}

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

Getting Started/Build/Distributions/Mandriva

2008-01-12T19:55:38Z

Powerfox: Added LangNavBar

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Mandriva}}
In Mandriva the build dependencies you need are installed with:

<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel libxine-devel
</code>

If you're running 64-bit environment you should replace all packages starting with "lib..." to "lib64...".

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mandriva Linux Control Center.

This includes installation of CMake, DBus, so you can proceed to [[Getting_Started/Build/KDE4#|compiling qt]].

Getting Started/Build/KDE4/Gentoo (ru)

2008-01-12T19:52:43Z

Powerfox: From Build

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Gentoo}}

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

Getting Started/Build/Distributions/Gentoo

2008-01-12T19:51:37Z

Powerfox: Added LangNavBar

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Gentoo}}
Gentoo requirements
==== Install by hand ====

You can use stable ebuilds just remember to sync your portage before you begin.

Remember: All commands are executed as root.

Required:

We need to allow the following keyword masked ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Make sure you have set the berkdb USE flag for redland, otherwise nepomuk won't work.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
echo 'x11-libs/qt accessibility' >> /etc/portage/package.use
</code>

These are the packages you will need to emerge, I included the update option into the emerge command so you will not re-emerge anything that you might already have installed.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

You will also need to emerge either 'kde-base/kdesdk' or kde-base/kdesdk-scripts'.

If you emerged DBUS, CMAKE, QT or HAL you may skip those sections respectively.
Good luck!

==== Install via portage ====

Also you can install the KDE 4 packages directly via
<code bash>
emerge -a <packagename>
</code>

To get the things you need, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] and then pull in the "kde" overlay (which contains experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
After this you need to adjust some USE-flags for KDE 4 and tell portage to use the testing KDE 4 ebuilds instead of the stable KDE 3 ones.

That way portage will do the dependency tracking for you.

Detailed instructions on building KDE 4 in Gentoo via portage can be found in the [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. They are discussed in the forum thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds], which is continued [http://forums.gentoo.org/viewtopic-p-4359581.html#4359581 here]

Getting Started/Build/KDE4/openSUSE (ru)

2008-01-12T19:50:58Z

Powerfox: From Build

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/openSUSE}}
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

Getting Started/Build/Distributions/openSUSE

2008-01-12T19:49:37Z

Powerfox: Added LangNavBar

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/openSUSE}}
In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Optional Packages'''

You can skip the manual and painful installation kdesupport and its dependencies ( Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi,
Soprano and other Nepomuk dependencies) by adding the KDE:KDE4 repository from
the [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

CMake binary packages for openSUSE are available from the KDE:KDE4 repository as well as from the [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

There are a lot more packages that are needed to satisfy the config-check, such as libusb-devel, bison etc., so look out for the config notifications and install accordingly. Please remember to skip any instructions that refer to kdesupport below. Start to compile with kdelibs.

Return to [[Getting_Started/Build/KDE4#kdelibs|building KDE 4]].

Getting Started/Build/KDE4 (ru)

2008-01-12T19:42:10Z

Powerfox: /* Необходимое программное обеспечение */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

* [[/Ark Linux (ru)|Ark Linux]]
* [[/Arch Linux (ru)|Arch Linux]]
* [[/Fedora (ru)|Fedora]]
* [[/Kubuntu and Debian (ru)|Kubuntu and Debian]]

=== openSUSE ===
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

=== Gentoo ===

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Fedora ===

Для сборки KDE4 вам необходимо иметь установленную Fedora 7 или выше. Необходимые пакеты можно установить, выполнив от пользователя с правами root'a, следующую команду:

<code bash>
yum install cmake clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

=== Mandriva ===

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас доступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (ru)

2008-01-12T19:40:28Z

Powerfox: Half update

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

=== openSUSE ===
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

=== Gentoo ===

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Fedora ===

Для сборки KDE4 вам необходимо иметь установленную Fedora 7 или выше. Необходимые пакеты можно установить, выполнив от пользователя с правами root'a, следующую команду:

<code bash>
yum install cmake clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

=== Mandriva ===

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас доступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4/Fedora (ru)

2008-01-12T19:24:16Z

Powerfox:

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Fedora}}
Чтобы установить большинство необходимых для сборки KDE4 в Fedora 7 (и выше), выполните:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

DCH-10/15/07: Примечание: возможно, что проще собрать RPM-ки. Можно отредактировать переменные в /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

Секция сборки (build stage) должна выглядеть примерно так:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Я сумел достичь лучших результатов, собирая kdesupport rpm, что означает, что Вам не потребуется устанавливать RPM-пакеты soprano или strigi. YMMV (непереводимый смайл или восклицание :) ).

{{TODO| Требуется аудит. Организовать в виде модуля.
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/KDE4/Arch Linux (ru)

2008-01-12T19:22:50Z

Powerfox:

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Arch Linux}}
В Arch Linux необходимо установить следующие пакеты:
<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Если Вы хотите использовать qt4 из репозитория Arch Linux, то его можно установить с помощью следующей команды:
<code bash>
pacman -Sy qt4
</code>

{{TODO| Проверить, включает ли Arch HAL/kdesupport...
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/KDE4/Ark Linux (ru)

2008-01-12T19:21:03Z

Powerfox:

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Ark Linux}}
В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

{{TODO| Проверить, включает ли ARK HAL и утилиты из kdesupport.
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/Distributions/Debian

2008-01-12T16:35:51Z

Powerfox: Added LangNavBar

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Kubuntu and Debian}}
This page details installation of kde4 requirements on Kubuntu 7.10 (Gutsy) and Debian (Testing/Unstable). For a basic functioning desktop, the recommended packages are installed with the command:

<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
kdesdk-scripts subversion ssh xserver-xephyr doxygen libqt4-dev dbus-x11 \
libstreamanalyzer-dev libstrigiqtdbusclient-dev \
libxml2-dev libxslt1-dev shared-mime-info libungif4-dev libssl-dev \
libboost-dev libgpgme11-dev libxine-dev libqimageblitz-dev
</code>

This installs build prerequisites such as build essential, all compilation requirements for kde4 and some recommended packages such as libssl-dev for https support. Soprano is also recommended, but must be [[#Install soprano from svn|installed from svn]]. Further recommended and optional packages are listed below.

After installing required and desired packages, proceed to [[Getting_Started/Build/KDE4#kdelibs|building KDE 4]].

== Build prerequisites ==
In Kubuntu 7.10 (Gutsy) and Debian (Testing/Unstable) the build prerequisites are installed with:

<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
kdesdk-scripts subversion ssh xserver-xephyr
</code>

Optional packages for API documentation generation:
<code bash>
sudo aptitude install doxygen graphviz
</code>

== kdelibs dependancies ==

Kdelibs dependancies can be installed with:
<code bash>
sudo aptitude install libqt4-dev dbus-x11 \
libstreamanalyzer-dev libstrigiqtdbusclient-dev \
libxml2-dev libxslt1-dev shared-mime-info libungif4-dev
</code>

=== Recommended packages ===
* libssl-dev - needed for https support etc.
* libbz2-dev

<code bash>
sudo aptitude install libssl-dev libbz2-dev
</code>

=== Optional packages ===
* libasound2-dev - The Alsa sound system.
* libaspell-dev - spell checking support (in kwrite etc)
* libavahi-common-dev - avahi/zeroconf service discovery
* libenchant-dev - spell checking wrapper library
* libjasper-dev - image processing library
* libopenexr-dev - image processing library
* libpcre3-dev - regular expression library
* libxml2-utils - used to validate generate doc files.
<code bash>
sudo aptitude install libxml2-utils libpcre3-dev libopenexr-dev \
libjasper-dev libenchant-dev libavahi-common-dev libaspell-dev \
libasound2-dev
</code>

== kdepimlibs dependancies ==
kdepimlibs dependancies can be installed with:
<code bash>
sudo aptitude install libboost-dev libgpgme11-dev
</code>

=== kdepimlibs recommended ===
* libldap2-dev - For ldap support in kde4.
<code bash>
sudo aptitude install libldap2-dev
</code>

== kdebase dependancies ==
kdebase-runtime dependancies can be installed with:
<code bash>
sudo aptitude install libxine-dev
</code>

{{Note|Note that libxine1-dev depends on gnome packages due to a kubuntu gutsy packaging bug (fixed in hardy). Also kubuntu packages xinelib version 1.1.8, which has trouble playing short sounds (fixed in xinelib 1.1.9).
}}

kdebase-apps dependancies can be installed with:
<code bash>
sudo aptitude install libqimageblitz-dev
</code>

=== kdebase-apps optional ===
* libxcb1-dev - X C binding - Used for video widget support in xine
* soprano - Recommended by nepomuk. See [[#Install soprano from svn]]
* libxkbfile-dev - keyboard configuration package
* libsmbclient-dev - for samba support in kde4

<code bash>
sudo aptitude install libsmbclient-dev libxkbfile-dev libxcb1-dev
</code>

=== kdebase-workspace optional ===
* libsmbclient-dev - for samba support in kde4
* network-manager-dev - Can be used by solid for network management
* libcaptury-dev - video capturing tool for screencasts
* libusb-dev - for usb support in solid
* libbluetooth-dev - for bluetooth support in solid
* libxcomposite-dev - for compositing support in kwin
* libxdamage-dev - for compositing support in kwin
* libxklavier11-dev - virtual keyboard
* soprano - See [[#Install soprano from svn]]

<code bash>
sudo aptitude install libxklavier11-dev libxdamage-dev libxcomposite-dev \
libbluetooth-dev libusb-dev libcaptury-dev network-manager-dev \
libsmbclient-dev
</code>

== kdeedu ==
* libeigen-dev - used by kalzium.

== koffice ==
* libqca2-dev - qt cryptographic support.

== kdepim ==
* libqca2-dev - qt cryptographic support.

== Install soprano from svn ==
Soprano is recommended by kdebase-workspace. If you already have the provided soprano package installed, it needs to be removed or it will be found instead of the svn version.

<code bash>
sudo aptitude remove libsoprano4 libsoprano-dev
</code>

Soprano is a modular system. For functionality install the following packages:
libclucene-dev - full text indexing library
librdf-dev - rdf backend

<code bash>
sudo aptitude install libclucene-dev librdf-dev
</code>

To check out soprano and compile:

<code bash>
cs
svn co -N svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
svn up soprano
cmakekde
</code>

Return to [[Getting_Started/Build/KDE4#kdelibs|building KDE 4]].

Getting Started/Build/KDE4/Fedora (ru)

2008-01-12T16:34:20Z

Powerfox: From Build

Чтобы установить большинство необходимых для сборки KDE4 в Fedora 7 (и выше), выполните:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

DCH-10/15/07: Примечание: возможно, что проще собрать RPM-ки. Можно отредактировать переменные в /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

Секция сборки (build stage) должна выглядеть примерно так:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Я сумел достичь лучших результатов, собирая kdesupport rpm, что означает, что Вам не потребуется устанавливать RPM-пакеты soprano или strigi. YMMV (непереводимый смайл или восклицание :) ).

{{TODO| Требуется аудит. Организовать в виде модуля.
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/Distributions/Fedora

2008-01-12T16:32:57Z

Powerfox: Navigation Bar correction

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Fedora}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source (Fedora Linux requirements)|

pre=[[Getting_Started/Build/KDE4|Build KDE 4]]|

next=[[Getting_Started/Build/KDE4|Build KDE 4]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]]|
}}

Some of the required packages for building KDE4 on Fedora 7 or higher:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel
</code>

Some optional packages for koffice support:
<code bash>
yum install qca2-devel gsl-devel freeglut-devel \
GraphicsMagick-c++-devel GraphicsMagick-devel
</code>

This includes installation of D-Bus and CMake -- you can skip steps 5 and 6.

DCH-10/15/07: Note - It may be simpler to spin RPMs. Note that you can edit the variables in /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

The build stage then looks like:
(but in what directory?)
%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

I have had better results with creating a kdesupport rpm which means that you should not install the soprano and strigi rpms. YMMV

telsh: On a Fedora 8 System I had to install "qt4-devel" too to have qmake.

{{TODO| Audit this and organize by module.
}}

Return to [[Getting_Started/Build/KDE4#HAL|building KDE 4]].

Getting Started/Build/Distributions/Fedora

2008-01-12T16:32:27Z

Powerfox: Navigation Bar correction

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Fedora Linux}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source (Fedora Linux requirements)|

pre=[[Getting_Started/Build/KDE4|Build KDE 4]]|

next=[[Getting_Started/Build/KDE4|Build KDE 4]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]]|
}}

Some of the required packages for building KDE4 on Fedora 7 or higher:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel
</code>

Some optional packages for koffice support:
<code bash>
yum install qca2-devel gsl-devel freeglut-devel \
GraphicsMagick-c++-devel GraphicsMagick-devel
</code>

This includes installation of D-Bus and CMake -- you can skip steps 5 and 6.

DCH-10/15/07: Note - It may be simpler to spin RPMs. Note that you can edit the variables in /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

The build stage then looks like:
(but in what directory?)
%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

I have had better results with creating a kdesupport rpm which means that you should not install the soprano and strigi rpms. YMMV

telsh: On a Fedora 8 System I had to install "qt4-devel" too to have qmake.

{{TODO| Audit this and organize by module.
}}

Return to [[Getting_Started/Build/KDE4#HAL|building KDE 4]].

Getting Started/Build/KDE4/Arch Linux (ru)

2008-01-12T16:31:05Z

Powerfox: From Build

В Arch Linux необходимо установить следующие пакеты:
<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Если Вы хотите использовать qt4 из репозитория Arch Linux, то его можно установить с помощью следующей команды:
<code bash>
pacman -Sy qt4
</code>

{{TODO| Проверить, включает ли Arch HAL/kdesupport...
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/KDE4/Ark Linux (ru)

2008-01-12T16:28:57Z

Powerfox:

В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

{{TODO| Проверить, включает ли ARK HAL и утилиты из kdesupport.
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/Distributions/Arch Linux

2008-01-12T16:28:04Z

Powerfox: Navigation Bar correction

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4/Arch Linux}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source (Arch Linux requirements)|

pre=[[Getting_Started/Build/KDE4|Build KDE 4]]|

next=[[Getting_Started/Build/KDE4|Build KDE 4]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]]|
}}

In Arch Linux you need to install the following packages:

<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib clucene
</code>

If you want to use qt4 from the Arch Linux repository you can install it with:
<code bash>
pacman -Sy qt4
</code>
("pacman -Sy qt" if you are running bleeding-edge Arch Testing)

{{TODO| Does Arch provide anything else? HAL/kdesupport?
}}

Return to [[Getting_Started/Build/KDE4#HAL|building KDE 4]].

Getting Started/Build/KDE4/Ark Linux (ru)

2008-01-12T16:25:54Z

Powerfox: From Build

=== Ark Linux ===
В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

{{TODO| Проверить, включает ли ARK HAL и утилиты из kdesupport.
}}

Вернуться к [[Getting_Started/Build/KDE4#HAL|сборке KDE 4]].

Getting Started/Build/KDE4

2008-01-12T14:49:07Z

Powerfox:

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. There are also tutorials for [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] and [http://solaris.kde.org/ Solaris]. Throughout the tutorial the bash shell is used.

{{warning|Expect a higher risk of build failure '''on Mondays''' when most kdelibs changes are committed. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Software Requirements ==

The following needs to be installed to successfully use this tutorial:
* gcc and g++, preferably version 4.2 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is included in kdesdk. You can install it from kdesdk (kdesdk-scripts on Debian) or similar packages, or download at [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], is the freedesktop MIME standard now used in KDE
* [http://boost.org/ boost], used by kdebase; after build and/or install, in order to make cmake aware about its location (FindBoost), add the boost directory (which contains the include subdirectory) to CMAKE_INCLUDE_PATH or set a environment variable called BOOST_ROOT that points to the boost directory.

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
{{Note|
On some systems a new user is configured by default to use {{path|/bin/sh}}. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.
On Ark Linux and Fedora, you can skip the <tt>-s /bin/bash</tt> switch - {{path|/bin/sh}} is {{path|bash}}.
}}
<code bash>
useradd -m kde-devel -s /bin/bash
passwd kde-devel
</code>

{{Warning|
The new kde-devel user will not be added automatically to all the user groups, which will result in not having sound, not being able to sudo, etc. Edit your /etc/groups file to add the kde-devel user to all the groups that you need (probably the groups that your usual username is already assigned to).
}}

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. Also if you want to use KDevelop to develop KDE 4 applications you may pass the ''-GKDevelop3'' flag to the ''cmake'' command (to make CMake generate KDevelop project files, it will help to avoid rebuilding in the future, see [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|this]]).
To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|
If the ssh command fails, check out the [[Getting_Started/Set_up_KDE_4_for_development#Launching_KDE_4_apps|Launching KDE 4 apps]] section of the [[Getting_Started/Set_up_KDE_4_for_development|KDE4 development guide]].
}}

== Required packages from your distribution ==
The requirements to build kde4 from source vary from distribution to distribution. Instructions for your distribution are provided below:

* [[/Ark Linux|Ark Linux]]
* [[/Arch Linux|Arch Linux]]
* [[/Fedora|Fedora]]
* [[/Kubuntu and Debian|Kubuntu and Debian]]
* [[/openSUSE|openSUSE]]
* [[/Gentoo|Gentoo]]
* [[/Mandriva|Mandriva]]

Your next compilation step depends on the packages supplied by your distro.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade. You probably want to skip building the bindings until/unless you know you will be building HAL (see below).

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 of the following instructions should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

The steps for building the glib bindings are similar to the above.

When these two packages are done building, we must fix the file ownership because 'sudo make install' has created root owned files and directories in ~kde-devel/kde.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get Qt4. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work.

If your distribution has a recent version of Qt4, that should work. Most distros backport bugfixes, and some distros, like Debian or openSUSE, even use the patches from KDE svn. In other cases, using the recipe below will give you a more stable Qt than your distro. Refer to the distribution specific sections above for more information.

As for now Qt3 compatibility layer in Qt 4 is mandatory, so please avoid using "-no-qt3support" option when building Qt4 from sources.

=== The Recipe ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# if we don't install, we'll just clear obj files to
# save disk space
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-6). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 7) and install (line 10) Qt. If install dir is the same as the current dir (line 8), then we just free some space (line 9) instead. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|Don't forget to read the [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] section first.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, QImageBlitz for image manipulation needed in kdebase, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (>=0.9.16a but watch out: version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

Please remember that if you use openSUSE, you can install the needed packages from the KDE:KDE4 buildservice repository and do not have to bother with fiddling the details below. Skip to the kdelibs section.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manually into the kdesupport directory in ~ and execute the command cmakekde. if this still doesn't work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? ($QTDIR and $PATH are used to get the QT installation path)
Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

If you get a message related to
target libQtTest.so not found
you may need to recompile qt-copy. This time you should take out
-nomake demos -nomake examples
from the configure command, so that Qt generates library QtTest.

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Software_Requirements|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If qmake wasn't found and you are using Debian packages, /usr/bin/qmake probably points to a wrong qmake version. To fix this run as root:
update-alternatives --config qmake
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)
* if none of the errors above match yours, you might just try a quick'n'dirty <code>make clean</code> in kdelibs.

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the recipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so

* if you get messages as "KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK." then, either find the files containing the offending line and comment it out manually, or run the following script in ~/kde/src/KDE/kdebase: [http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. It will just REMOVE the line that has "kde4_create_handbook" in it from all the found files.
*If you get an error (in ubuntu) concerning libxtst.so install the libxtst-dev package
* If you get the message "kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared", you might need to install libxklavier development packages.
* If you get "/home/kde-devel/kde/lib/libkio.so: undefined reference to `Strigi::AnalysisResult::AnalysisResult(std::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, long, Strigi::IndexWriter&, Strigi::StreamAnalyzer&)'" you probably have an outdated version of strigi installed by your distro.

== Running KDE 4 programs ==

You can now run KDE 4 programs (e.g. kwrite) by typing:
ssh -X kde-devel@localhost
kwrite

=== Troubleshooting ===

* If you get
KUniqueApplication: Cannot find the D-Bus session server
check if you can access the display, e.g. type
xclock
and see if a clock appears on the screen.

* If you get something like
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped)
You need to install kdebase - see above. It is enough to install the "runtime" directory from kdebase.

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

Note: it is not necessary to run cmakekde for updates.

== Installing a subset of a module ==

Many modules in KDE contain a large number of programs which could take a long time to download and compile. In cases where you want to work only on a particular program or programs in a module, it is possible to download and compile particular folders. In some cases, certain folders are required for any build of the module. This is determined in the CMakeLists.txt file of the module. For example the [http://websvn.kde.org/branches/KDE/4.0/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt file] lists:

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

So, the libkdegames and libkmahjongg directories are required to build any of kdegames. The cmake directory will also usually be required. All the other directories (doc, katomic etc) are optional. They will be built if present on your machine. In this example, we build kmahjongg and kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

=== Locked sessions ===
When installing KDE 4 as a user, one will not be able to unlock a locked session. To work around this issue you can either:
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
or
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Also you have to add a "kde" service in /etc/pam.d/ folder

For example for RH/Fedora based distros:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (ru)

2008-01-11T19:41:30Z

Powerfox: /* Инструкция */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

=== Ark Linux ===
В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

=== Arch Linux ===

В Arch Linux необходимо установить следующие пакеты:
<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Если Вы хотите использовать qt4 из репозитория Arch Linux, то его можно установить с помощью следующей команды:
<code bash>
pacman -Sy qt4
</code>

=== Fedora ===

Чтобы установить большинство необходимых для сборки KDE4 в Fedora 7 (и выше), выполните:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

DCH-10/15/07: Примечание: возможно, что проще собрать RPM-ки. Можно отредактировать переменные в /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

Секция сборки (build stage) должна выглядеть примерно так:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Я сумел достичь лучших результатов, собирая kdesupport rpm, что означает, что Вам не потребуется устанавливать RPM-пакеты soprano или strigi. YMMV (непереводимый смайл или восклицание :) ).

=== Kubuntu и Debian ===
В Kubuntu 7.04 (Feisty) и Debian (Testing/Unstable) необходимое программное обеспечение можно установить следующей командой:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

В Kubuntu 7.10 (Gutsy) и Debian unstable следует добавить:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev libxkbfile-dev
</code>

Для того чтобы задействовать всю функциональность системы документации (API documentation framework), также выполните:
<code>
sudo aptitude install graphviz
</code>

В Kubuntu Gutsy и Debian unstable нет никакой необходимости компилировать qt или kdesupport. Все необходимые пакеты доступны после процедуры описанной в настоящем разделе, потому переходите сразу к [[#kdelibs|сборке kdelibs]], перед этим только [[#Создание пользователя для разработки KDE 4|создав отдельного пользователя в системе для запуска программ KDE4]].

{{Note|При возникновении проблем при компиляции KDE4 Beta4 или выше в Kubuntu 7.10, похожих на:

Soprano version is too low

strigi xxx.h not found...

Необходимо обновить и собрать соответствующую часть исходного кода kdesupport.
Это описано в разделе о сборке kdesupport.

Также удалите пакет soprano: sudo apt-get remove libsoprano4 libsoprano-dev (этот пакет мы соберём из исходников самостоятельно)

If you still get an error in the kdelibs section about soprano like:
CMake Error: Error in cmake code at
$src/KDE/kdelibs/cmake/modules/FindSoprano.cmake:78:
FILE Internal CMake error when trying to open file: /usr/include/soprano/version.h for reading.

then delete kdelibs/CMakeCache.txt
}}

=== openSUSE ===
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

=== Gentoo ===

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Fedora ===

Для сборки KDE4 вам необходимо иметь установленную Fedora 7 или выше. Необходимые пакеты можно установить, выполнив от пользователя с правами root'a, следующую команду:

<code bash>
yum install cmake clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

=== Mandriva ===

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -nomake examples -nomake demos -qt-gif \
-no-exceptions -debug -fast -prefix $QTDIR
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас боступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (pt BR)

2008-01-09T20:46:58Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Começando|

name=Compilando O KDE4 A Partir Do Código Fonte|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstrato ==

Esse tutorial mostra uma maneira de instalar o KDE pelo trunk rodando em sistemas Linus/BSD. Você pode também ajudar a traduzir tutoriais para [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] e [http://solaris.kde.org/ Solaris]. Durante todo o tutorial o bash shell é usado.

{{warning|Existe um grande risco de falhas '''nas Segundas-Feiras''' quando a maioria das kdelibs são commited(atualizadas). Acesse o [http://developer.kde.org/~dirk/dashboard/ Dashboard] para reportar quebras inesperadas. Você é encorajado à corrigir as falhas e erros.
}}

== Requerimentos ==

Os seguintes softwares precisam ser instalados antes de seguir com o tutorial:
* gcc e g++, preferivel versão 4.2 ou superior
* svn, o controle de versão(cliente)
* pkg-config
* bibliotecas de desenvolvimento e headers para X11, OpenGL (mesa-common-dev e libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 e libxslt
* o <tt>makeobj</tt> script, que faz parte do kdesdk. Você pode instalar pelo kdesdk (kdesdk-scripts no Debian) ou pacotes semelhantes, ou faça o download pelo [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* o [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], que é o freedesktop MIME padrão usado agora pelo KDE
* [http://boost.org/ boost], precisa pelo kdebase; depois de compilar e/ou instalar, para que o cmake saiba sua localização (FindBoost), adicione o diretório do boost (o que contém o sub-diretório include) para CMAKE_INCLUDE_PATH ou crie uma environment variable chamada BOOST_ROOT apontado para o diretório do boost.

=== Ark Linux ===
No Ark Linux, as dependencias que você precisa é instalada pelo comando:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Se você preferir uma interface gráfica, selecione os pacotes listados acima na ferramenta "Install Software" no Mission Control.

Isso inclui a instalação do CMake, DBus e Qt - você pode pular os passos 5, 6 e 7.

=== Arch Linux ===
No Arch Linux você precisa instalar os seguintes pacotes:

<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Se quiser, você instalar o qt4 a partir do repositório do Arch Linux com o comando:
<code bash>
pacman -Sy qt4
</code>

Para as bibliotecas clucene você precisa do [http://aur.archlinux.org/packages.php?do_Details=1&ID=5968&O=0&L=0&C=0&K=clucene&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=nd PKGBUILD] pelo AUR.

=== Fedora ===

Alguns pacotes são requisitos para a compilação do KDE4 no Fedora 7 ou superior:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch
</code>

Esta instalação inclui o D-Bus e CMake -- você pode pular os passos 5 e 6.

DCH-10/15/07: Note - Pode ser mais simples usar RPMs. Note que vocÊ pode editar as variáveis em /etc/rpm/macros.kde4 (que são providas pelo Rawhide kde-filesystem).

Para compilar:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Eu tive melhores resultados criando uma rpm do kdesupport, significa que você não precisa instalar o soprano e strigi rpms. YMMV

=== Kubuntu e Debian ===

No Kubuntu 7.04 (Feisty) e Debian (Testing/Unstable) as dependencias que você precisa instalar são:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

No Kubuntu 7.10 (Gutsy) e Debian unstable você deve adicionar:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev
</code>

Para uma completa e funcional documentação da API você também precisa:
<code>
sudo aptitude install graphviz
</code>

Não tem necessidade de compilar o qt ou kdesupport no kubuntu gutsy. Todos os pacotes requeridos já estão inclusos na instalação acima. Para configurar o kde4 user e etc será explicado na próxima sessão, mas passe por cima das sessões de compilação do qt, hal e kdesupport.

{{Note|
Se você tiver erros na compilação do KDE4
Beta4 ou acima no Kubuntu 7.10, como:

Soprano version is too low

strigi xxx.h not found...

Talvez você precise dar um checkout na parte do código fonte do kdesupport no SVN server do KDE4.

Isso será mostrado quando você chegar na parte da compilação do kdesupport.

}}

=== openSUSE ===

No openSUSE 10.2 e mais novos, você pode instalar os pacotes usando [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

Em releases mais antigas do SUSE, você pode usar o YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Pacotes Requeridos'''

Os pacotes que você precisa para instalar são:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Pacotes Opcionais'''

Você pode pular a parte de instalação do manual e a do kdesupport e suas dependências ( Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi,
Soprano e outras dependências do Nepomuk) por adicionar o repositório KDE:KDE4 do [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] para suas instalações.

Para openSUSE 10.2 ou mais novo, faça:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Para versões mais velhas do SUSE Linux faça:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[SUA VERSÃO SUSE LINUX]
</code>

Agora instale os seguintes pacotes:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Existem mais pacotes que precisam ser instalados para satisfazer o config-check, como libusb-devel, bison etc., então dê uma olhada nas notificações de configuração e instale de acordo. Por favor lembre de pular qualquer instrução que seja referencia do kdesupport abaixo. Comece a compilar pelo kdelibs.

E para uma completa e funcional documentação da API você vai precisar também:
<code>
graphviz
</code>

Os pacotes binários do CMake para openSUSE estão disponiveis no repositório do KDE:KDE4 pelo [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Instalando na mão ====

Você pode usar stable ebuilds só lembrando o seu sync portage antes de começar.

Lembrete: Todos os comandos são executados como root.

Requerimento:

Precisamos habilitar os seguintes keywords no ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Tenha certeza que você setou a flah USE para o redland, se não o epomuk não irá funcionar.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
echo 'x11-libs/qt accessibility' >> /etc/portage/package.use
</code>

Esses são os pacotes que você vai precisar, Eu inclui a opção update para que você não precise reusar o emarge para pacotes já instalados.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Você também vai precisar usar o emerge para o 'kde-base/kdesdk' ou kde-base/kdesdk-scripts'.

Se você "emergou" o DBUS, CMAKE, QT ou HAL você pode pular as seguintes sessões.
Boa sorte!

==== Instalando via portage ====

Você pode instalar os pacotes KDE4 diretamente por:
<code bash>
emerge -a <packagename>
</code>

Para isso você precisa [http://gentoo-wiki.com/TIP_Overlays#Layman instalar layman] e depois colocar no "kde" overlay (que contém a experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
Depois disso você precisa ajudar alguns USE-flags para o KDE4 e avisar o portage para usar o testing KDE 4 ebuilds ao invez do stable KDE 3.

Assim o portage irá fazer todo trabalho de dependência para você.

Informações detalhadas de como compilar o KDE4 no Gentoo via portage pode ser encontrada no [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. E também é discutida nesse tópico [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Mandriva ===
No Mandriva as dependências necessárias para compilar o KDE4 são:

<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel libxine-devel
</code>

Se você está rodando em um processador 64-bit você deve substituir o começo dos nomes dos pacotes de "lib..." para "lib64...".

Se você prefere uma interfaçe gráfica(GUI), selecione os pacotes listados acima na ferramenta "Install Software" no Mandriva Linux Control Center.

Isso inclui as instalação do CMake, DBus - você pode pular os passos 5 e 6.

== Criando a conta de usuário para o desenvolvimento do KDE 4 ==

{{Note|
Algumas pessoas gostam de ter uma conta de usuário separada para o KDE4 (Antes de que um bug delete arquivos por engano), e as instruções abaixo foram escritas com esse proposito.

Entretando é muito mais eficiente por ter tudo em uma conta de usuário, veja [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Aumentando a produtividade no KDE4 com Scripts(inglês)]]
para mais detalhes.

Você pode continuar seguindo as instruções abaixo, mas não coloque as váriaveis de ambiente no seu <tt>.bashrc</tt>, coloque elas em um arquivo separado que você faça uso quando for para o ambiente de desenvolvimento do KDE 4.
}}

=== Opção 1: Linha de Comando ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Usando o KControl ===

Ao invez dos comandos acima, você pode usar o módulo User no KDE Control Center se você já tem o KDE3 instalado.

=== Configure o Ambiente ===

Copie o {{path|~/.bashrc}} do seu usuário normal par o novo usuário kde-devel. Depois, copie e cole o conteúdo do [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|exemplo .bashrc]] dentro do {{path|~kde-devel/.bashrc}}. Tenha certeza de comentar a linha <tt>alias make=makeobj</tt> se você não tem o comando <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>. Provavelmente você quer modificar os paths para ter certeza que não irá incluir os kde3 paths. Também se você quer usar o KDevelop para desenvolver aplicativos para o KDE 4 você precisa passar a flag ''-GKDevelop3'' ao comando ''cmake'' (para fazer o CMake gerar arquivos de projetos KDevelop, isso irá ajudar a recompilar no futuro, veja [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|isso]]).
Para fazer isso, você precisa abrir um novo bash ou executar
<code bash>
source ~/.bashrc
</code>

Isso irá dar acesso aos comandos tais como <tt>cmakekde</tt> que é usado no tutorial para forçar o cominho dos binários do Qt, KDE e CMake.

Para mais informações, por favor leia o tutorial [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Aumentando a produtividade no KDE4 com Scripts(inglês)]].

=== Mudando Para o Novo Usuário ===
Mude para o usuário kde-devel: (Não se esqueça do hífen)
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|
Se o ssh falhar, veja o [[Getting_Started/Set_up_KDE_4_for_development#Launching_KDE_4_apps|Launching KDE 4 apps]] na sessão [[Getting_Started/Set_up_KDE_4_for_development|KDE4 development guide]].
}}

== O Shell Para Desenvolvimento ==

Em alguns sistemas um novo usuário é configurado por padrão para usar o {{path|/bin/sh}}. Se esse não é o caso do seu sistema, você pode pular essa sessão. Usando {{path|/bin/sh}} pode ser bastante inconveniente para trabalhar e talvez você queria mudar isso para {{path|/bin/bash}} ou outro shell.
No Ark Linux, Fedora e Slackware, você pode pular esse passo - {{path|/bin/sh}} é {{path|bash}}.

=== Opção 1: Como o usuário kde-devel ===

Se você não tem acesso ao root e seu sistema suporta a mudança do seu próprio shell com o aplicativo <tt>chsh</tt>, então você pode tentar mudar seu shell para {{path|/bin/bash}} assim:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Como o usuário root ===

Se seu sistema vem com a aplicação <tt>usermod</tt> você pode rodar o seguinte comando como root: <tt>usermod -s /bin/bash kde-devel</tt>.

Outra opção é de usar a aplicação <tt>vipw</tt> como root para editar com segurança seu {{path|/etc/passwd}}. Ache o 'kde-devel' no arquivo. Mude '{{path|/bin/sh}}' no final da linha para '{{path|/bin/bash}}', salve as mudanças e saia.

O novo shell vai startar automaticamente quando você entrar como o usuário kde-devel.

== D-Bus ==
O QtDBus e KDE são conhecidos por trabalhar com versões 0.62, também com 0.92 e superiores, do D-Bus. As versões 0.60 e 0.61 podem funcionar também mas não foram testadas. Nós recomendamos usar a versão post-1.0 release (pelo menos a 0.94), então atualize se você não o fez.

Você pode pular essa parte se você já tem uma versão recente do D-Bus ou se não quer atualizar. Provavelmente você não quer compilar os bindings ao menos que você irá ter que compilar o HAL (ver abaixo).

Antes de continuar com os passos, tenha certeza que os cabeçalhos do X11 e as bibliotecas estão habilitadas. O script configure roda na linha 5, a seguinte instrução deverá aparecer para confirmar:
Building X11 code: yes

=== A Receita ===

{{tip|Tenha certeza que você configurou o ambiente corretamente como feito [[Getting_Started/Build/KDE4_%28pt_BR%29#Configure_o_Ambiente|acima]]. Isso é necessário para as funções <tt>cs</tt> e <tt>cb</tt> funcionarem.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' é uma função bash, clique aqui para saber mais(inglês)]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

cs # ver acima
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== O Quê Aconteceu ===
Depois de mudar para o diretório do código fonte(linha 1), o código fonte do D-Bus é baixado pelo freedesktop.org (linha 2) e descompactado (linha 3). Depois entra no diretório criado para o D-Bus (linha 4), as configurações de compilação são criadas pelo script {{path|configure}} (linha 5). Depois da compilação (linha 6) e instalação (linha 7) do D-Bus, nós usamos a ferramenta <tt>dbus-uuidgen</tt> para instalar o arquivo de identificação da maquina (machine identification file) que permite o bus começar automaticamente quando a sessão do desktop começar (linha 8).

Note que você precisa de permissão de escrita no {{path|/var}} para os dois últimos passos. Se seu sistema não tem acesso ao comando sudo, você pode usar o comando <tt>su</tt>, ex. <tt>su -c "make install"</tt>.

Os passos para compilar os bindings do glib são similares aos acima.

Então quando esses dois pacotes estão compilados e instalados, nós precisamos arrumar o dono do arquivo pois ao usar 'sudo make install' o root que fica como dono do arquivo e dos diretórios no ~kde-devel/kde.

== CMake ==
Pule essa parte se você têm o [http://cmake.org/ CMake] >=2.4.5 instalado.
Você pode baixar os pacotes binários diretamente do [http://www.cmake.org/HTML/Download.html CMake site]. Existem também pacotes específicos para diversas distribuições.

=== A Receita ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' é uma função bash, clique aqui para saber mais(inglês) ]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== O Quê Aconteceu ===
Primeiro, vamos ao diretório do código fonte (linha 1), baixamos o código fonte do CMake (linha 2) e os descompactamos (linha 3). Criamos um diretório para compilar o CMake (linha 4) e entramos nele (linha 5). Rodamos o script de bootstrap do CMake para configurar a compilação (linha 6), depois compilamos (linha 7) e instalamos (linha 8) usando o usuário root.

Se seu sistema não tem acesso ao comando <tt>sudo</tt>, então você pode usar o <tt>su -c "make install"</tt>.

== Qt ==
Agora precisamos instalar o Qt4 que está no repositório do KDE. KDE é garantido com qualquer Qt 4.3. Qt 4.2 e antigos não são suportados e não irá funcionar. Você deve usar a cópia do Qt no server Subversion do KDE. (nota: algumas distros, tais como Debian e openSUSE, dão um suporte ao Qt com patches do KDE svn, então você pode usar o método pré-compilado da sua distro, porque eles irão funcionar normalmente). KDE tenta garantir que o código é compativel com o Qt 4.3.0, mas você pode pegar alguns bugfixes adicionais usando o qt-copy (entretanto, sua distribuição já deve cuidar desses bugfixes, então na maioria das vezes a distro já disponibiliza uma versão com atualizações suficientes). Para maior referência sobre distribuições, acesse as sessões acima.

Por enquanto a compatibilidade com o Qt3 é obrigatória, porfavor evite usar a opção "-no-qt3support" quando for compilar o Q4.

=== A Receita ===
cd # Note: qt-copy fica em $HOME/qt-copy. Veja $QTDIR em [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# se não instalamos, só limpa os arquivos obj para
# limpar memória no disco
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== O Quê Aconteceu ===
Nós mudamos de volta para o diretório home do usuário <tt>kde-devel</tt> (linha 1) e fizemos o download do código usando o subversion (svn) pelo repositório do KDE (linha 2). Depois acessamos o diretório {{path|qt-copy}} (linha 3), rodamos o script que manipula os patches que vem com o <tt>qt-copy</tt> (linha 4).

Uma vez que os patches foi feito, nós rodamos o script <tt>configure</tt> para configurar a instalação (linha 5-6). Os comandos de linha usados são explicados no arquivo {{path|qt-copy/README.qt-copy}}. Finalmente, nós compilamos os requerimentos minimos para o KDE (linha 7) e instalamos (linha 10) o Qt. Se o diretório de instalação for o mesmo do diretório corrente (line 8), então só limpamos um pouco de espaço (linha 9). Se você quiser todos os exemplos e aplicações demo, você pode compilar individualmente ou simplismente dar um <tt>make</tt> no diretório {{path|qt-copy}}.

Note que a instalação não requer root já que o Qt é instalado localmente no {{path|$QTDIR}}. Mas, a instalação só é necessário se o {{path|$QTDIR}} for diferente do {{path|$HOME/qt-copy}}, que não é o caso se você seguiu todas as instruções corretamente.

=== Problemas ===
Se você teve "error: X11/Xlib.h: No such file or directory", instale o devel package do <tt>xorg</tt> (o nome varia bastante da distribuição, por exemplo é <tt>xorg-dev</tt> nos sistemas baseados em Ubunto como o Kubuntu).

Se você teve um erro de no passo de configuração (linha 5-6), cheque o valor da variável <tt>$QMAKESPEC</tt>. Algumas distribuições setam essa variável apontado diretamente pro diretório Qt do sitema. Se <tt>unset QMAKESPEC</tt> resolver seu problema, então provavelmente você quer adicionar no seu script <tt>~/.bashrc</tt>.

Se você teve um erro ".pch/debug-shared/QtCore", isso é porque o Qt-4.3 habilita cabeçalhos pré-compilados para o gcc suportar isso, mas por alguma rasão isso não funcionou para você. Se você usar distcc, configure o qt com -no-pch. Se você usa o icecream, atualize para a útlima versão do svn trunk.

Tente rodar qualquer programa Qt, como o {{program|assistant}}. '''Nota:''' Você talvez precise rodar <tt>xhost +local:kde-devel</tt> com seu usuário normal do kde3 para rodar essa aplicação. Se der erro no QSpanData::adjustSpanMethods, então seu problema é o style. Tente remover {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} e {{path|lib/kde4/plugins/styles/oxygen.so}} se eles existirem no prefixo de instalação do KDE.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|Don't forget to read the [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] section first.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, QImageBlitz for image manipulation needed in kdebase, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (>=0.9.16a but watch out: version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

Please remember that if you use openSUSE, you can install the needed packages from the KDE:KDE4 buildservice repository and do not have to bother with fiddling the details below. Skip to the kdelibs section.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manually into the kdesupport directory in ~ and execute the command cmakekde. if this still doesn't work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? ($QTDIR and $PATH are used to get the QT installation path)
Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

If you get a message related to
target libQtTest.so not found
you may need to recompile qt-copy. This time you should take out
-nomake demos -nomake examples
from the configure command, so that Qt generates library QtTest.

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If qmake wasn't found and you are using Debian packages, /usr/bin/qmake probably points to a wrong qmake version. To fix this run as root:
update-alternatives --config qmake
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the recipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so

* if you get messages as "KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK." then, either find the files containing the offending line and comment it out manually, or run the following script in ~/kde/src/KDE/kdebase: [http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. It will just REMOVE the line that has "kde4_create_handbook" in it from all the found files.
*If you get an error (in ubuntu) concerning libxtst.so install the libxtst-dev package
* If you get the message "kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared", you might need to install libxklavier development packages.

== Running KDE 4 programs ==

You can now run KDE 4 programs (e.g. kwrite) by typing:
ssh -X kde-devel@localhost
kwrite

=== Troubleshooting ===

* If you get
KUniqueApplication: Cannot find the D-Bus session server
check if you can access the display, e.g. type
xclock
and see if a clock appears on the screen.

* If you get something like
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped)
You need to install kdebase - see above. It is enough to install the "runtime" directory from kdebase.

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

== Installing a subset of a module ==

Many modules in KDE contain a large number of programs which could take a long time to download and compile. In cases where you want to work only on a particular program or programs in a module, it is possible to download and compile particular folders. In some cases, certain folders are required for any build of the module. This is determined in the CMakeLists.txt file of the module. For example the [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt file] lists:

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

So, the libkdegames and libkmahjongg directories are required to build any of kdegames. The cmake directory will also usually be required. All the other directories (doc, katomic etc) are optional. They will be built if present on your machine. In this example, we build kmahjongg and kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

=== Locked sessions ===
When installing KDE 4 as a user, one will not be able to unlock a locked session. To work around this issue you can either:
su
chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
or
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (gl)

2008-01-09T20:46:19Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{warning_(gl)|Esta é unha tradución incompleta.}}

{{TutorialBrowser_(gl)|

series=Empezando...|

name=Compilar KDE4 dende as fontes|

pre=[[../../Sources/Anonymous_SVN_(gl)|Guía de consulta rápida do SVN anónimo]]|

next=[[../../Set_up_KDE_4_for_development|Configurar KDE 4 para desenvolvimento]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: Ferramenta para a compilación de KDE dende Subversion] [[../../Increased_Productivity_in_KDE4_with_Scripts|Productividade mellorada con guións de shell en KDE 4]] [[Development/Tutorials/CMake |Introdución a CMake]] [[../KDE4/FreeBSD|Notas sobre FreeBSD]] [[../KDE4/Mac OS X|Instrucións para Mac OS X]] [[../KDE4/Windows|Instrucións para MS Windows]]|
}}

== Introdución ==

Este tutorial mostra un xeito de obter KDE dende o trunk, usando sistemas baseados en Linux ou BSD. Hai tamén tutoriais para [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] e [http://solaris.kde.org/ Solaris]. Ao longo do tutorial será usada intensivamente un terminal de tipo bash.

{{warning_(gl)|Os '''luns''' córrese un maior risco de erros na compilación, pois é cando se suben os cambios nas kdelibs. O [http://developer.kde.org/~dirk/dashboard/ dashboard] avisa desas rupturas imprevistas. Animámosche a corrixir os módulos que faien.
}}

== Software necesario==

O seguinte debe estar instalado no teu sistema para poder rematar este manual de xeito satisfactorio:
* gcc e g++ do proxecto gcc, preferíbelmente a versión 4.1 ou superior
* svn, o cliente do sistema de control de versións Subversion.
* pkg-config
* librerias de desenvolvimento e cabeceiras de X11, OpenGL (mesa-common-dev e libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 e libxslt
* O script <tt>makeobj</tt>, que é parte de kdesdk. Podes instalalo como parte do kdesdk, (kdesdk-scripts en Debian) ou similar, ou simplemente descarregalo do [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* O paquete [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], que é o estándar MIME de freedesktop que está a usar KDE.
* [http://boost.org/ boost], necesitado por kdebase; logo de compilar e/ou instalar boost, para que cmake saiba onde se atopa (FindBoost), engade o directorio de boost (o que conten o subdirectorio) ao CMAKE_INCLUDE_PATH ou engade unha variábel de entorno chamada BOOST_ROOT apuntando ao directorio de boost.

=== Ark Linux ===
En Ark Linux, as dependenzas para a compilación instálanse asi:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Se prefires unha interface gráfica, selecciona os pacotes listados enriba na ferramenta de "Install Software" no Mission Control. Isto inclue a instalación de CMake, DBus e Qt, polo que podes pasar dos pasos 5, 6 e 7.

=== Kubuntu ===

En Kubuntu 7.04 (Feisty) (e, posibélmente 7.10) as dependencias para a compilación que tes que ter instaladas fanse asi:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts
</code>

Podes evitar a instalación manual de CMake 2.4.6 e DBus facendo:
<code bash>
sudo aptitude install libdbus-1-dev cmake
</code>

Para ter un framework completamente funcional para a documentación do API tamén precisarás:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

En openSUSE 10.2 e posteriores, podes instalar pacotes usando a ferramenta [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

En versións vellas de SUSE, podes usar YaST:
<code bash>
su
yast -i <nomepacote>
</code>

'''Pacotes precisos'''

Os pacotes que precisarás instalar son os seguintes:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Pacotes opcionais'''

Podes saltar a instalación de Qt 4.3, CMake 2.4.6 e DBus engadindo o repositorio do Servizo de Compilación de KDE 4 de openSUSE (openSUSE Build Service KDE4 Repository) ás tuas fontes de compilación.

Para openSUSE 10.2 e superior fai:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Para versións antigas de SUSE Linux fai:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[A TÚA VERSIÓN DE SUSE]
</code>

Agora instala os seguintes pacotes (e as suas dependencias):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Para ter un framework completamente funcional para a documentación do API tamén precisarás:
<code>
graphviz
</code>

Pacotes cos binarios de CMake para openSUSE están disponíbeis no [http://software.opensuse.org/download/devel:/tools:/building/ servizo de compilación de openSUSE].

=== Gentoo ===

==== Instalar a man ====

Para ter as ebuilds máis estábeis lembra sincronizar a árbore de portage antes de comezar.

Precísase que estean unmasked e/ou ''mantidas''(kept) nunha versión anterior para continuar.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.unmask
# echo 'dev-util/cmake' >> /etc/portage/package.unmask
# echo 'dev-cpp/clucene' >> /etc/portage/package.unmask
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Comproba que tes activada a bandeira berkdb USE para redland, ou nepomuk non funcionará:

<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Estes son os pacotes que tes que instalar, moitos deles xa estarán instalados no teu sistema, polo que podes saltalos engadindo a bandeira de update en emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

Supondo que fixeches ''emerge'' desas ebuilds, podes saltar os pasos de compilación a man e proceder á [[Getting_Started/Build/KDE4_(gl)#kdesupport|sección de kdesupport]].

Boa sorte!

==== Instalar via portage ====

Podes instalar os pacotes de KDE4 directamente via:
<code bash>
emerge -a <packagename>
</code>

Para conseguir as cousas que precisas, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] e ''and then pull in the KDE overlay'' (que contén ebuilds experimentais de KDE):
<code bash>
layman -a kde
</code>
Logo disto precisas axustar algunhas bandeiras USE KDE 4 e dicirlle a portage que use as ebuilds de proba de KDE 4 en lugar das estábeis de KDE 3.

Deste xeito portage encargarase das dependencias por ti.

Instrucións detalladas sobre compilar KDE 4 en Gentoo via portage podes atopalas no [http://overlays.gentoo.org/proj/kde/wiki wiki de overlay sobre KDE]. Tamén fálase no fío: [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

== Crear unha conta de usuário para o desenvolvimento de KDE 4 ==

{{Note_(gl)|
Algunha xente usa contas de usuário separadas para KDE 4 (por se, por exemplo, un bug elimina arquivos por erro), as instrucións a seguir están escritas segundo esa aproximación.

Sen embargo, é moito máis eficiente ter todo nunha simple conta de usuario, bótalle unha ollada a [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Productividade mellorada con guións de shell en KDE 4]] para máis detalles.

De todos os xeitos, podes seguir as instrucións de abaixo, pero non poñas variábeis de entorno no teu <tt>.bashrc</tt>, ponas nun arquivo separado das tuas fontes para intercambialo co entorno de KDE 4.
}}

=== Opción 1: Liña de comandos ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Opción 2: Usando KControl ===

No canto de usar os comando de enriba, podes usar o módulo de usuario do Centro de Control de KDE, se xa tes instalado KDE 3.

=== Configurando o entorno ===

Copia o {{path|~/.bashrc}} do teu usuario normal á nova conta de kde-devel. De seguir, copia e pega os contidos do [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc de exemplo]] en {{path|~kde-devel/.bashrc}}. Asegura-te de comentar a liña <tt>alias make=makeobj</tt> se non tes o comando <tt>[[Getting Started/Build/KDE4_(gl)#Required Software|makeobj]]</tt> disponíbel. Posíbelmente querrás modificar o ''path'' (camiño) para ter seguro que non inclue os ''paths'' do teu KDE3. Por outro lado, se queres desenvolver aplicacións KDE4 con KDevelop, podes pasarlle a opción ''-GKDevelop3'' a cmake para que xere os arquivos de proxecto (podes atopar máis información [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|aquí]]). Para facelo executar, tes que ter aberta unha nova bash ou executar:
<code bash>
source ~/.bashrc
</code>

Isto proporcionará aceso aos comandos como <tt>cmakekde</tt> que son usados ao longo deste tutorial asi como asegurará que os ''paths'' aos binarios de Qt, KDE e CMake están correctamente.

Para máis información, bótalle unha ollada ao tutorial de [[Getting Started/Increased Productivity in KDE4 with Scripts|Productividade mellorada con guións de shell en KDE 4]].

=== Cambiar a un novo usuário ===
Para usar o novo usuário kde-devel: (non esquezas o guión)
<code bash>
su - kde-devel
</code>

== A consola do usuario de desenvolvemento ==

Algúns sistemas están configurados para que os novos usuarios usen {{path|/bin/sh}} por defecto. Se non é o caso no teu podes saltarte esta sección (por exemplo se usas Ark Linux). Traballar con {{path|/bin/sh}} pode ser moi inconvinte, probablemente queras cambiala a {{path|/bin/bash}} ou outra consola.

=== Opción 1: Coma o usuario kde-devel ===

Se non tes privilexios de root e o teu sistema soporta o cambio da túa propia consolo co comando <tt>chsh</tt>, podes cambiala a {{path|/bin/bash}} con:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Opción 2: Coma usuario root ===

Se o teu sistema inclúe o comando <tt>usermod</tt> podes executa-lo seguinte coma root:
<code bash>
usermod -s /bin/bash kde-devel
</code>.

Outra opción é executa-lo comando <tt>vipw</tt> coma root para editar {{path|/etc/passwd}} de forma segura. Procura 'kde-devel' no arquivo e cambia '{{path|/bin/sh}}' no final da liña por '{{path|/bin/bash}}', garda os cambios e sae.

Poderás usa-la nova consola cando voltes a entrar coma usuario kde-devel.

== D-Bus ==
QtDBus e KDE funcionan coas versións de D-Bus 0.62, 0.92 e posteriores. As versións 0.60 e 0.61 tamén poderían funcionar, aínda que non foron probadas. As versións 0.90 e 0.91 non funcionan. Recomendamos usar versións posteriores á 1.0 (polo menos 0.94), considera actualizar se aínda non o fixeches.

Podes salta-la seguinte sección se tes unha versión de D-Bus suficientemente recente ou non desexas actualizala.

Antes de continuar asegúrate ter cabeceiras e bibliotecas X11 dispoñibles. A quinta liña do guión de configuración das seguintes instruccións debería ler:
Building X11 code: yes

=== A receita ===

{{tip_(gl)|Non esquezas configura-lo entorno adecuadamente, tal coma se describiu na sección [[Getting_Started/Build/KDE4_(gl)#Configurando_o_entorno|Configurando o entorno]]. É preciso para que as funcións <tt>cs</tt> e <tt>cb</tt> funcionen.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' é unha función bash, prema aquí para saber máis]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

=== ¿Que acontece? ===
Tras cambiar ó directorio das fontes (liña 1) descárgase o código de D-Bus dende freedesktop.org (liña 2) e descomprímese (liña 3). Éntrase no directorio de D-Bus recén creado (liña 4) e configúrase á construcción usando o guión {{path|configure}} (liña 5). Unha vez D-Bus está construído (liña 6) e instalado (liña 7) usamo-la utilidade <tt>dbus-uuidgen</tt> para instalar un arquivo de identificación de máquina que permite executar D-Bus automáticamente ó comezo da sesión de escritorio (liña 8).

Ten en conta que precisas ter permisos de escritura en {{path|/var}} para os dous últimos pasos. Se o teu sistema non posúe o comando sudo podes usar <tt>su</tt> no seu canto, por exemplo <tt>su -c "make install"</tt>.

== CMake ==
Podes saltarte esta sección se tes instalado [http://cmake.org/ CMake] versión 2.4.5 ou superior.

Deberías poder usar directamente os binarios dispoñibles na [http://www.cmake.org/HTML/Download.html páxina de CMake]. Tamén tes paquetes específicos para distintas distribucións.

=== A receita ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' é unha función bash, prema aquí para saber máis]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== ¿Que acontece? ===
Primeiro imos ó directorio das fontes do usuario <tt>kde-devel</tt> (liña 1), descargamo-las fontes de CMake (liña 2) e descomprimímolas (liña 3). Creamos un directorio onde construir CMake (liña 4) e entramos nel (liña 5). Executamo-lo guión autosuficiente de CMake para configura-la súa construcción (liña 6), construímolo (liña 7) e instalámolo usando o usuario root (liña 8).

Se o teu sistema carece do comando <tt>sudo</tt> podes executar <tt>su -c "make install"</tt> no seu canto.

== Qt ==
A continuación precisamos a biblioteca Qt4 que reside no repositorio de KDE. Grántese a construcción de KDE con Qt 4.3 mentres que as versións 4.2 e anteriores non funcionarán. Deberías usa-la copia que reside nos servidores Subversion de KDE (ten en conta que algunhas distribucións (por exemplo Debian) adoitan ofrecer Qt cos parches de KDE xa aplicados polo que poderías querer "facer trampas" e usar a Qt precompilada da túa distribución).

=== A receita ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# se non o instalamos limparemos os arquivos obxecto
# para aforrar espacio
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== ¿Que acontece? ===
Cambiamos ó directorio home do usuario <tt>kde-devel</tt> (liña 1) e descargamo-las fontes con subversion (svn) dende o repositorio de KDE (liña 2).
Tras entrar no directorio {{path|qt-copy}} resultante (liña 3), executamo-lo guión que manexa os parches incluídos en <tt>qt-copy</tt> (liña 4).

Unha vez aplicados os parches configuramo-la construcción co guión <tt>configure</tt> (liñas 5 e 6). As distintas opcións do comando explícanse no arquivo {{path|qt-copy/README.qt-copy}}. Por último construímos Qt cos requerimentos mínimos para KDE (liña 7) e instalámola. Se o directorio de instalación é o actual (liña 8) liberamos espazo (liña 9). Se desexas obter tódolos exemplos e demostracións podes construílos individualmente ou simplemente executar <tt>make</tt> dende o directorio {{path|qt-copy}}.

Decátate de que a instalación non precisa privilexios root xa que instala Qt localmente en {{path|$QTDIR}}. En calquera caso só é precisa a instalación se {{path|$QTDIR}} é diferente a {{path|$HOME/qt-copy}}, o cal non é o caso se seguiches totalmente as instruccións.

=== Solución de problemas ===
Se obtés "error: X11/Xlib.h: No such file or directory", instala o paquete de desenvolvemento de <tt>xorg</tt> (o nome variará en distintas distribucións, por exemplo é <tt>xorg-dev</tt> en sistemas baseados en Ubuntu coma Kubuntu).

Se obtés erros acerca de definicións non atopadas no paso de configuración, comproba o valor de <tt>$QMAKESPEC</tt>. Algunhas distribucións fan que apunte directamente a Qt instalada no sistema. Se <tt>unset QMAKESPEC</tt> arranxa o problema probablemente queras engadilo ó guión <tt>~/.bashrc</tt>.

Se obtés un erro ".pch/debug-shared/QtCore" é debido a que Qt-4.3 habilita cabeceiras precompiladas se o teu gcc o soporta, pero por alguha razón no che funciona. Se usas distcc, configura Qt con -no-pch. Se usas <tt>icecream</tt> actualiza á derradeira versión dende svn trunk.

Proba a executar calquera programa Qt coma {{program|assistant}}. '''Atención:''' Pode ser que precises executar <tt>xhost +local:kde-devel</tt> coma o teu usuario normal de kde3 para executar este programa. Se espeta en QSpanData::adjustSpanMethods enton o problema é o estilo oxygen. Tenta eliminar {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} e {{path|lib/kde4/plugins/styles/oxygen.so}} se existen no prefixo de instalación de KDE.

== kdesupport ==

{{warning_(gl)|Se chegaches a esta sección sen ler [[Getting_Started/Build/KDE4_(gl)#Configurando_o_entorno|Configurando o entorno]], '''as receitas non funcionarán'''.
As receitas son correctas; <tt>cs</tt> e <tt>cb</tt> non son erratas. Precisas te-lo entorno configurado adecuadamente para que funcionen estas instruccións.}}

En kdesupport están moitas bibliotecas das que dependen as aplicacións KDE, incluíndo Strigi e Soprano para procuras e metadatos, eigen para efectos visuail en aplicacións coma Kalzium, taglib para os reprodutores de audio e qca para as necesidades criptográficas.

Strigi ten unhas cantas dependencias de seu: precisarás as cabeceiras e bibliotecas para libz, libbz2, openssl (libcrypto ou libssl), libclucene (versión 0.9.16, a 0.9.17 '''non''' funciona), e libxml2 ou libexpat.

=== A receita ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs non é unha errata]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== ¿Que acontece? ===
Entramos no directorio das fontes (liña 1). Descargamo-las fontes en {{path|kdesupport}} con subversion (liña 2), entramos no novo directorio {{path|~/kde/src/kdesupport}} (liña 3) e comezamos a construcción (liña 4). Uhna vez remate ficaremos no directorio de construcción.

=== Solución de problemas ===
Se obtés:
cmakekde: command not found
tes que ir manualmente ó directorio kdesupport e executa-lo comando cmakekde. Se continúa se funcionar debe haber un erro no teu .bashrc.

Se obtés:
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
tes que instala-los paquetes de desenvolvemento de libxml2.

Se obtés:
CMake Error: Could NOT find REDLAND
precisas librdf de Redland.
Se a túa distribución non ofrece o paquete librdf, podes atopa-las fontes en [http://download.librdf.org/source/ http://download.librdf.org/source/] e construíla.
(Usuarios de Gentoo: O ebuild para librdf chámase dev-libs/redland)

Se obtés:
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
bótalle un ollo a [[Getting_Started/Sources/Using_Subversion_with_KDE_(gl)| Usando Subversion con KDE]].

Se obtés:
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
bótalle un ollo ó arquivo .bashrc descrito arriba, ¿son correctos os camiños?
Tamén pode ser que insalaches os paquetes qt4 da túa distribución saltandote a construcción de Qt descrita arriba. Constrúe qt-copy coma se describe arriba, se non funciona instálaa con "sudo make install"

== kdelibs ==

Xa podemos comezar a construí-las bibliotecas base de KDE.

=== A receita ===
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs non é unha errata]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== ¿Que acontece? ===
Entramos no directorio das fontes (liña 1), creamos o directorio KDE e entramos nel (liña 2). Descargamo-las fontes de kdelibs con subversion (liña 3), entramos no novo directorio {{path|~/kde/src/KDE/kdelibs}} (liña 4) e comezamos a construír (liña 5). Unha vez rematada a construcción ficaremos no directorio de construcción de kdelibs.

{{tip_(gl)|Pode haber dependencias incumpridas no teu sistema xa que é doado perder de vista esa información na saída de <tt>cmakekde</tt>.
Podes executar <tt>cmake $KDE_SRC/KDE/NOME_MODULO</tt> antes de construi-los módulos para comprobalo.}}

=== Módulos de CMake adicionais específicos de KDE ===
Hai módulos de CMake adicionais en {{path|kdelibs/cmake/modules/}} precisos para construir aplicacións KDE4. Estes módulos instalaranse automáticamente cando instales kdelibs.

=== Solución de problemas ===
Se tes problemas construíndo kdelibs asegúrate de que o software indicado na sección [[Getting_Started/Build/KDE4_(gl)#Software_necesario|Software necesario]] está instalado e funciona. Outras pistas posibles son:
* Se o comando <tt>cmakekde</tt> faia dicindo que CMake precisa unha construcción fóra do directorio das fontes, elimina {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} e proba outra vez.

Se <tt>cmakekde</tt> segue dando o mesmo erro proba esto:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* Se recibes un erro dicindo "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", precisas entrar ó directorio de construcción antes de executar cmakekde (por exemplo <tt>cs KDE/kdelibs && cb && cmakekde</tt>. Se a mensaxe persiste executa 'svn status' no directorio kdelibs e elimina tódolos arquivos etiquetados con '?'.
* Se non se atopou Qt ou atopouse unha versión errónea asegúrate de que o qmake das Qt que precisas é o primeiro no PATH.
* Se os problemas persisten proba a opción <tt>--keep-going</tt> de CMake.
* Precisa-la biblioteca libungif, de outro modo terás o erro "<tt>Could NOT find GIF</tt>".
* Actualización a Qt-4.3: se obtés un erro de ligazón en kjsembed sobre QScriptEngine, edita CMakeCache.txt en kdelibs e elimina as liñas que teñan QT_QTUITOOLS_LIBRARY e executa make outra vaz (esa biblioteca ten unha nova dependencia e o código cmake que a engade precisa executarse).
* Se obtés <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, instala openssl-devel e recompila Qt.
* Se obtés <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> significa que construiches Qt sen soporte Qt3.

== kdepimlibs ==
Despois de <tt>kdelibs</tt>, mais antes de ''kdebase'', precisas construír e instalar ''kdepimlibs''.

=== A receita ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs non é unha errata]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== ¿Que acontece? ===
Entramos no directorio das fontes (liña 1), descargámo-las fondes de kdepimlibs con subversion (liña 2) e entramos no novo directorio {{path|~/kde/src/KDE/kdepimlibs}} (liña 3). Comezámo-la construcción (liña 4). Unha vez finalizada ficaremos no directorio de construcción de <tt>kdepimlibs</tt>.

=== Solución de problemas ===
Se tes problemas compilando kdepimlibs:
* o comando cmakekde pode precisar unha versión posterior da biblioteca gpgme. Podes obtela da páxina web do proxecto: http://www.gnupg.org/(en)/download/index.html - ten en conta que para construir gpgme tamén precisas libgpg-error, dispoñible na mesma páxina. Ámbalas dúas instálanse coa secuencia "./configure", "make" e "sudo make install", co parámetro adicional "--with-gpg-error-prefix" para a biblioteca gpgme. Pode que precises sobreescribir o teu arquivo "/usr/bin/gpgme-config" coa nova versión para que kdepimlibs colla a nova instalación.

== kdebase ==
kdebase está dividido en tres partes:
* '''apps'''
:Contén aplicacións coma Dolphin ou KWrite.
* '''runtime'''
:Contén cousas que precisan as aplicacións na execución, coma iconas. É un requerimento para cada aplicación KDE polo que tes que construílo e instalalo.
* '''workspace'''
:Contén cousas específicas do escritorio KDE, coma Plasma ou o xestor de fiestras. A maioría dependen de X11. Só o precisas se desexas construír o escritorio KDE completo.

Podes costruír todo kdebase dunha vez, coma se describe na receita de embaixo. Se só desexas construír kdebase-runtime, que é o único requisito, podes remprazar <code bash>cd kdebase</code> por <code bash>cd kdebase/runtime</code> na receita.

=== A receita ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs non é unha errata]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Solución de problemas ===
Se tes problemas compilando kdebase:
* Asegúrate de ter as <tt>cabeceiras libxss</tt> instaladas (normalmente obtés referencias indefinidas nos obxectos xscreensaver se non as tes).
* <tt>which meinproc</tt> ten que devolver {{path|/home/kde-devel/kde/bin/meinproc}}.
* se cmakekde non atopa o camiño de kdepimlibs, edita o arquivo {{path| $KDE_BUILD/KDE/kdebase/CMakeCache.txt}} e engade <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>.
* se obtés un erro dicindo "Please set the following variables: X11_XTest_LIB (ADVANCED)", instala o paquete de desenvolvemento de <tt>Xtst</tt>. Nalgúns sistemas empaquétase separado de <tt>xest</tt> e chámase <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Pode que tamén precises elimina-lo arquivo CMakeCache.txt no directorio de construcción tras instala-lo paquete.
* o mesmo para "X11_Xinerama_LIB (ADVANCED)" onde precisarás o paquete de desenvolvemento de <tt>xinerama</tt>.
* se obtés un erro queixándose de que falta a variable X11_Xrandr_LIB, precisa-lo paquete de desenvolvemento de libxrandr (libxrandr-devel on ubuntu-systems)
* se obté-lo erro "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", precisas instala-las cabeceiras de libfontconfig.
* se obté-lo erro "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", precisas instalar soprano, de kdesupport, e reconstruír kdelibs.
* se obté-lo erro "‘XserverRegion’ does not name a type" asegúrate de ter as cabeceiras de libxcompolite instaladas (<tt>libxcomposite-dev</tt> en ubuntu).

== Xerando documentación local da API ==
Anque a documentación da API de KDE está dispoñible en liña en [http://api.kde.org api.kde.org], ás veces é útil tela no teu disco, por exemplo se desexas usar [[Getting_Started/Set_up_KDE_4_for_development_(gl)#KDevelop|KDevelop]] para consultar a documentación ou non podes estar en liña todo o tempo.

Xerar a documentación pode levar varias horas e ocupa case medio gigabyte no disco.
A xeración é levada a cabo por un guión en {{path|kdelibs/doc/api}}, precisas <tt>doxygen</tt> para executalo.

Para xerar a documentación da API de kdelibs, escribe o seguinte:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs non é unha errata]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repite para outros módulos se o desexas. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Outro método que é incluso máis doado consiste en descarga-lo arquivo [[Doxyfile]] ó teu sistema. Simplemente entra no directorio onde desexes xera-la documentación e executa
<code bash>
% doxygen /path/to/Doxyfile
</code>
Revisa o arquivo {{path|doxygen.log}} para ve-los avisos e erros. Atoparás a documentación no subdirectorio {{path|apidocs}}.

== Permanecendo actualizado ==

Para manter a instalación de KDE4 actualizada, cada modulo instalado debe ser actualizado periódicamente. O Luns é o día dos grandes cambios en kdelibs, Martes pode ser o mellor día para isto. Para cada módulo obtido, executa <tt>svn up</tt> e <tt>make</tt>.

Por exemplo:
<code bash>
cs kdesupport # cs non é un erro
svn up
cb # cb non é un erro
make -j2 VERBOSE=1 && make install
</code>

== Problemas xerais ==

De vez en cando, despois de algún comando <tt>svn up</tt>, algunhas ferramentas usadas na cadea de construcción de KDE cambian o formato da súa saída. Por exemplo, os arquivos <tt>kcfg</tt> son lidos por <tt>kconfig_compiler</tt> para producir diálogos de configuración. CMake non detecta esos cambios, e a compilación podería fallar. Un rodeo e forzar sempre a rexeneración de todolos arquivos:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
O mesmo aplicase a arquivos <tt>ui</tt> producidos polo deseñador Qt.

== ¡Éxito! ==

Agora estás listo para comezar a construir outros módulos svn da mesma maneira que construiches kdebase, executa e proba KDE4 ou escribe os teus propios parches e aplicacións.

Mira o tutorial [[Getting Started/Set up KDE 4 for development|Configura KDE4 para desenvolvemento]] de como comezar aplicacións KDE 4 e como usar o KDevelop para traballar nelas.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (sl)

2008-01-09T20:45:20Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Kako začeti|

name=Grajenje KDE 4 iz izvorne kode|

pre=[[../../Sources/Anonymous_SVN|Hitri vodnik po anonimnem SVN-ju]]|

next=[[../../Set_up_KDE_4_for_development|Nastavitev KDE 4 za razvoj]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: orodje za grajenje KDE-ja iz Subversion-a] [[../../Increased_Productivity_in_KDE4_with_Scripts|Povečanje storilnosti v KDE 4 z uporabo skriptov]] [[Development/Tutorials/CMake |Uvod v CMake]] [[../KDE4/FreeBSD|Opombe za FreeBSD]] [[../KDE4/Mac OS X|Navodila za Mac OS X]] [[../KDE4/Windows|Navodila za MS Windows]]|
}}

== Povzetek ==

Ta vodnik prikazuje enega izmed načinov, kako pripraviti KDE iz razvojnega debla, da bo tekel na sistemih Linux in BSD. Na voljo so tudi vodniki za [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] in [http://solaris.kde.org/ Solaris]. Vse skozi vodnik bomo uporabljali ukazno lupino bash.

{{warning|V '''ponedeljek''' lahko pričakujete večje število napak pri gradnji. Takrat se namreč vnaša spremembe v kdelibs. [http://developer.kde.org/~dirk/dashboard/ Dashboard] poroča o nepričakovanih napakah. Spodbudili bi vas radi, da popravite module, ki imajo napake pri gradnji.
}}

== Potrebna programska oprema ==

Da bi uspešno zaključili ta vodnik, morate najprej namestiti sledeče:
* gcc in g++ iz projekta GCC, najbolje različico 4.1 ali višjo
* svn, odjemalec Subversion za nadzor nad revizijami
* pkg-config
* razvijalske knjižnice in datoteke z glavo za X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* skript <tt>makeobj</tt>, ki je del modula kdesdk. Skript lahko naložite kot del paketa kdesdk (kdesdk-scripts na Debian-u), ali pa ga prenesete neposredno [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj s SVN-ja].
* [http://freedesktop.org/wiki/Software/shared-mime-info paket shared-mime-info], ki je MIME standard organizacije freedesktop.org in ga KDE sedaj uporablja
* [http://boost.org/ boost], ki ga potrebuje kdebase. Da bo CMake našel Boost, mora biti Boost-ova mapa, ki vsebuje podmapo include navedena v spremenljivki CMAKE_INCLUDE_PATH, ali pa morate nastaviti okoljsko spremenljivko BOOST_ROOT, ki kaže na mapo z Boost-om.

=== Kubuntu ===

Da namestite vse potrebne pakete v Kubuntu 7.04 (Feisty Fawn) poženite sledeči ukaz:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev
</code>

Ročno nameščanje CMake 2.4.6 in DBus lahko preskočite z:
<code bash>
sudo aptitude install libdbus-1-dev cmake
</code>

Za polno delujočo dokumentacijo programskega vmesnika (API-ja):
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

V openSUSE 10.2 in novejših lahko pakete namestite z orodjem
[http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <ime-paketa>
</code>

V starejših različicah lahko uporabite YaST:
<code bash>
su
yast -i <ime-paketa>
</code>

'''Potrebni paketi'''

Paketi, ki jih morate namestiti, so:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Neobvezni paketi'''

Ročno nameščanje Qt 4.3, CMake 2.4.6 in DBus lahko preskočite tako, da med vire za nameščanje dodate skladišče KDE4 storitve openSUSE Build.

V openSUSE 10.2 in novejših:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

V starejših različicah:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/<različica-vašega-suse-linuxa>
</code>

Po tem, ko dodate vir, namestite sledeče pakete (in odvisnosti):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Za polno delujočo dokumentacijo programskega vmesnika (API-ja):
<code>
graphviz
</code>

Paketi CMake za openSUSE so na voljo prek [http://software.opensuse.org/download/devel:/tools:/building/ storitve openSUSE Build].

=== Gentoo ===

==== Ročna namestitev ====

Uporabite lahko stabilne ebuilde. Preden začnete ne pozabiti pognati »emerge --sync«.

Nekatere ebuilde je potrebno odmaskirati, ali pa zagotoviti uporabo starejše različice:
<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

To so ebuildi, ki jih bo potrebno namestiti. Nekateri so morda že nameščeni, zato lahko uporabite možnost »-u«.
<code bash>
$ emerge -avu ebuild/ime
</code>

<code>
sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland
</code>

Če ste namestili vse te ebuilde, lahko preskočite ročno prevajanje in nadaljujete s poglavjem [[Getting_Started/Build/KDE4_(sl)#kdesupport|kdesupport]]

==== Z uporabo sistema portage ====

Pakete za KDE 4 lahko namestite tudi neposredno z:
<code bash>
emerge -a <packagename>
</code>

Najprej [http://gentoo-wiki.com/TIP_Overlays#Layman namestite orodje layman] in si nato prenesite overlay KDE, ki vsebuje poskusne ebuilde za KDE.
<code bash>
layman -a kde
</code>

Za KDE 4 je potrebno nastaviti še določene zastavice USE in povedati sistemu portage naj namesto ebuildov za KDE 3 uporablja ebuilde za KDE 4. Na ta način bo lahko portage sledil vsem odvisnostim.

Podrobna navodila za grajenje KDE 4 v Gentoo-ju lahko najdete na [http://overlays.gentoo.org/proj/kde/wiki Wikiju overlaya za KDE]. O njih se razpravlja na forumu v temi [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html Monolitski ebuildi za KDE 4].

== Ustvarite uporabniški račun za razvoj KDE 4 ==

{{Note|

}}

Getting Started/Build/KDE4 (it)

2008-01-09T20:44:51Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Guida rapida|

name=Compilare KDE4 Da Sorgente|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Introduzione ==

Questo tutorial spiega come installare KDE da trunk per sistemi Linux/BSD. Ci sono tutorial anche per [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] e [http://solaris.kde.org/ Solaris]. Il tutorial prevede l'utilizzo del terminale.

{{warning|Aspettati un rischio maggiore di errori di compilazione '''ogni Lunedì''' quando avvengono molti cambiamenti nelle kdelibs. La [http://developer.kde.org/~dirk/dashboard/ Dashboard] riporta errori imprevisti. Ti incoraggiamo a riparare i moduli corrotti.
}}

== Software richiesto ==

I seguenti pacchetti devono essere installati prima di seguire questo tutorial:
* gcc e g++, preferibilmente la versione 4.2 o superiore
* svn, il client di controllo di revisione di subversion
* pkg-config
* librerie di sviluppo e header per X11, OpenGL (mesa-common-dev e libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 e libxslt
* lo script <tt>makeobj</tt>, parte di kdesdk. Puoi installarlo come parte di kdesdk (kdesdk-scripts su Debian) o un pacchetto simile, o scaricalo semplicemente da [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* il [http://freedesktop.org/wiki/Software/shared-mime-info pacchetto shared-mime-info], che è lo standard MIME freedesktop che utilizza attualmente KDE
* [http://boost.org/ boost], richiesto da kdebase; dopo aver compilato e/o installato boost, per far rendere conto a cmake della sua ubicazione (FindBoost), aggiungi la directory di boost (quella che contiene la sottodirectory include) a CMAKE_INCLUDE_PATH o imposta una variabile di ambiente chiamata BOOST_ROOT che punta alla directory di boost.

=== Ark Linux ===
Su Ark Linux, le dipendenze di compilazione di cui hai bisogno si installano con:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Se preferisci un'interfaccia grafica seleziona i pacchetti della lista di sopra dallo strumento "Install Software" in Mission Control.

Ciò include l'installazione di CMake, DBus e Qt - puoi ignorare i passi 5, 6 e 7.

=== Fedora ===

Alcuni dei pacchetti necessari per compilare KDE4 su Fedora 7 o superiore:
<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

DCH-10/15/07: N.B.: - Può rivelarsi più semplice verificare gli RPM con Spin. Nota che puoi modificare le variabili in /etc/rpm/macros.kde4 (che è provvisto da kde-filesystems nella Rawhide).

La fase di compilazione sarà così:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Ho avuto migliori risultati creando un rpm di kdesupport in modo da non dover installare gli rpm di sopramo e strigi. YMMV

=== Kubuntu e Debian ===

Su Kubuntu 7.04 (Feisty Fawn) e Debian (Testing/Unstable) le dipendenze di compilazione si installano con:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev
</code>

Su Kubuntu 7.10 (Gutsy Gibbon) devi aggiungere:
<code bash>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev
</code>

Non c'è bisogno di compilare qt e kdesupport su Kubuntu Gutsy. Tutti i pacchetti necessari sono provvisti da questi pacchetti. Vai alla [[#kdelibs|sezione kdelibs]] e continua da lì.

Per un sistema di documentazione API completamente funzionale ti serve anche:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Su openSUSE 10.2 e superiori puoi installare i pacchetti usando [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <nome-del-pacchetto>
</code>

Su versioni più vecchie di SuSE puoi usare YaST:
<code bash>
su
yast -i <nome-del-pacchetto>
</code>

'''Pacchetti richiesti'''

I pacchetti che devi installare sono:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Pacchetti opzionali'''

Puoi evitare l'installazione manuale e complicata di kdesupport e relative dipendenze ( Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi,
Soprano e altre dipendenze di Nepomuk) aggiungendo il repository KDE:KDE4 dall'[http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] alle tue risorse di installazione.

Per openSUSE 10.2 e superiori:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Per versioni più vecchie di SuSE Linux:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[LA TUA VERSIONE DI SUSE LINUX]
</code>

Adesso installa i seguenti pacchetti:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Ci sono molti altri pacchetti che sono indispensabili per soddisfare il config-check, come libusb-devel, bison ecc., quindi fai attenzione alle notifiche di config e installa i pacchetti di seguito. Ricordati di ignorare qualsiasi istruzione che si riferisca a kdesupport più giù. Comincia a compilare da kdelibs.

E per un sistema apidox completamente funzionale ti serve anche:
<code>
graphviz
</code>

I pacchetti binari di CMake per openSUSE sono disponibili nel repository KDE:KDE4 così come in [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Installazione manuale ====

Puoi usare ebuild stabili, ricordati di sincronizzare l'albero di portage prima di cominciare.

Ricorda: Tutti i comandi sono eseguiti come root.

Richiesti:

Dobbiamo permettere i seguenti ebuild mascherati da keyword.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Assicurati di aver impostato il flag USE berkdb per redland, altrimenti nepomuk non funzionerà.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Questi sono i pacchetti che dovrete emergere, ho incluso l'opzione di aggiornamento nel comando emerge così da non riemergere qualsiasi cosa fosse già installata.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Devi anche emergere 'kde-base/kdesdk' o kde-base/kdesdk-scripts'.

Se emergi DBUS, CMAKE, QT o HAL puoi ignorare le rispettive sezioni di questo tutorial.
Buona fortuna!

==== Installazione tramite portage ====

Puoi installare i pacchetti di KDE 4 direttamente via
<code bash>
emerge -a <packagename>
</code>

Per avere ciò che ti serve, [http://gentoo-wiki.com/TIP_Overlays#Layman installa Layman] e poi preleva dall'overlay "kde" (che contiene ebuild sperimentali di KDE):
<code bash>
layman -a kde
</code>
Dopo di ciò devi aggiustare alcuni USE-flag per KDE 4 e dire a portage di usare gli ebuild di testing di KDE 4 anziché quelli stabili di KDE 3.

In questo modo portage ti terrà traccia delle dipendenze.

Istruzioni dettagliate su come installare KDE 4 su Gentoo tramite portage possono essere trovate nel [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Sono discusse nel thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Mandriva ===
Su Mandriva le dipendenze di compilazione si installano con:

<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel
</code>

Se stai usando un sistema a 64 bit devi modificare tutti i pacchetti che cominciano con "lib..." con "lib64...".

Se preferisci un'interfaccia grafica, seleziona i pacchetti della lista superiore nello strumento "Install Software" nel Mandriva Linux Control Center.

Ciò include l'installazione di CMake e DBus - puoi ignorare i passi 5 e 6.

== Creare un account utente per lo sviluppo di KDE4 ==

{{Note|
Alcuni preferiscono avere un account separato per KDE 4 (per esempio un vecchio bug cancellava dei file per errore), e le istruzioni qui sotto sono scritte con questo scopo.

Ad ogni modo è più efficiente fare tutto da un singolo account utente, vedi [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
per più dettagli.

Puoi comunque seguire le istruzioni seguenti, ma ricordati di non mettere le variabili di ambiente nel tuo <tt>.bashrc</tt>, mettile in un file separato che userai per passare all'ambiente di KDE 4.
}}

=== Opzione 1: Riga di comando ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Opzione 2: Usare KControl ===

Invece di usare i comandi di cui sopra. puoi usare anche il modulo Utenti nel KDE Control Center se hai già KDE3 installato.

=== Impostare l'ambiente ===

Copia il {{path|~/.bashrc}} del tuo account normale nel nuovo account kde-devel. Poi copia e incolla i contenuti di [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in {{path|~kde-devel/.bashrc}}. Assicurati di togliere il commento dalla linea <tt>alias make=makeobj</tt> se non hai il comando <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> disponibile. Vorrai probabilmente modificare anche il percorso per assicurarti che non includa i percorsi di KDE3. Se vuoi usare KDevelop per sviluppare applicazioni per KDE 4 puoi passare il flag ''-GKDevelop3'' al comando ''cmake'' (per far generare a CMake dei file di progetto KDevelop, che ti aiuterà a non ricompilare in futuro, vedi [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|questo]]).
Per farlo funzionare, devi aprire una nuova bash o eseguire
<code bash>
source ~/.bashrc
</code>

Ciò fornirà l'accesso a comandi come <tt>cmakekde</tt> che sono utilizzati in questo tutorial così da assicurarsi che i binari di Qt, KDE e CMake siano nei giusti percorsi.

Per più informazioni leggi il tutorial [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Passare al nuovo utente ===
Passa all'utente kde-devel: (non dimenticarti il trattino)
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|
Se il comando ssh fallisce, controlla la sezione [[Getting_Started/Set_up_KDE_4_for_development#Launching_KDE_4_apps|Launching KDE 4 apps]] della [[Getting_Started/Set_up_KDE_4_for_development|KDE4 development guide]].
}}

== La shell di sviluppo dell'utente ==

Su alcuni sistemi un nuovo utente utilizza come predefinito {{path|/bin/sh}}. Se questo non è il caso nel tuo sistema puoi ignorare questa sezione. Usare {{path|/bin/sh}} può rivelarsi sconveniente per lavorarci e dovresti perciò cambiarlo in {{path|/bin/bash}} o usare un'altra shell.
Su Ark Linux e Fedora puoi ignorare questo passo - {{path|/bin/sh}} è {{path|bash}}.

=== Opzione 1: Da utente kde-devel ===

Se non hai privilegi di root e il tuo sistema supporta il cambiamento della shell con l'applicazione <tt>chsh</tt>, allora potresti cambiare la tua shell in {{path|/bin/bash}} usando:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Opzione 2: Da root ===

Se il tuo sistema ha l'applicazione <tt>usermod</tt> puoi usare il seguente comando come root: <tt>usermod -s /bin/bash kde-devel</tt>.

Un'altra opzione è di usare l'applicazione <tt>vipw</tt> da root per modificare in sicurezza il tuo {{path|/etc/passwd}}. Localizza 'kde-devel' nel file. Modifica '{{path|/bin/sh}}' alla fine della riga in '{{path|/bin/bash}}', salva i cambiamenti ed esci.

La nuova shell partirà automaticamente quando farai di nuovo il login dell'utente kde-devel.

== D-Bus ==
QtDBus e KDE funzionano di certo con D-Bus versione 0.62, così come 0.92 e superiori. Le versioni 0.60 e 0.61 potrebbero anche funzionare ma non sono state testate. Le versioni 0.90 e 0.91 non funzionano. Ti raccomandiamo di usare versioni post-1.0 (almeno 0.94), quindi considera un aggiornamento se non l'hai ancora fatto.

Puoi oltrepassare questa sezione se hai una versione di D-Bus recente o se non vuoi aggiornare. Probabilmente preferirai non installare i binding finché/a meno che sai che compilerai HAL (vedi sotto).

Prima di seguire i comandi di seguito assicurati che le librerie e gli header di X11 siano disponibili. Lo script configure dovrebbe restituire una quinta riga di output del genere:
Building X11 code: yes

=== I comandi ===

{{tip|Assicurati di aver impostato il tuo ambiente correttamente come descritto [[Getting_Started/Build/KDE4#Setting_up_the_environment|sopra]]. È necessario per far funzionare i comandi <tt>cs</tt> e <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

cs # vedi sopra
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cb
sudo chown -R kde-devel:kde-devel *

=== Che sta succedendo? ===
Dopo essere entrati nella directory dei sorgenti (riga 1), il codice sorgente di D-Bus viene scaricato da freedesktop.org (riga 2) e spacchettato (riga 3). Dopo essere entrati nella nuova directory di D-Bus (riga 4), la compilazione viene configurata dall'apposito script {{path|configure}} (riga 5). Dopo la compilazione (riga 6) e l'installazione di D-Bus (riga 7), usiamo lo strumento <tt>dbus-uuidgen</tt> per installare un file di indentificazione della macchina che permette al bus di partire automaticamente quando comincia la sessione del desktop (riga 8).

Nota che ti serve il permesso di scrittura in {{path|/var}} per gli ultimi due passi. Se il tuo sistema non ha il comando sudo, puoi usare invece il comando <tt>su</tt>, esempio: <tt>su -c "make install"</tt>.

I passi per installare i binding di glib sono simili a quelli di sopra.

Quando questi due pacchetti sono compilati dobbiamo aggiustare le appartenenze dei file perché 'sudo make install' ha creato file e directory appartenenti a root in ~kde-devel/kde.

== CMake ==
Ignora questo se hai [http://cmake.org/ CMake] >=2.4.5 installato.
Dovresti poter usare direttamente i pacchetti binari disponibili sul [http://www.cmake.org/HTML/Download.html sito di CMake]. Ci sono anche pacchetti per distribuzioni specifiche.

=== I comandi ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Che sta succedendo? ===
Prima di tutto torniamo alla directory dei sorgenti dell'utente <tt>kde-devel</tt> (riga 1), otteniamo i sorgenti di CMake (riga 2) e li spacchettiamo (riga 3). Creiamo una directory per compilarci CMake (riga 4) e ci entriamo (riga 5). Poi eseguiamo lo script di bootstrap di CMake per impostare la compilazione di CMake (riga 6), facciamo make (riga 7), e lo installiamo (riga 8) usando i privilegi di root.

Se il tuo sistema non ha il comando <tt>sudo</tt>, puoi fare invece <tt>su -c "make install"</tt>.

== Qt ==
Adesso abbiamo bisogno di scaricare il Qt4 che si trova nel repository dei sorgenti di KDE. La compilazione di KDE è garantita con qualsiasi Qt 4.3. Qt 4.2 e precedenti non sono supportati e non funzioneranno. Dovresti usare la copia nei server Subversion di KDE. (Nota: alcune distro, come Debian o openSUSE, tendono a fornire Qt con patch applicate da KDE svn, quindi potresti farti furbo e installare dei Qt precompilati della tua distribuzione che funzioneranno a dovere). KDE prova a garantire che il sorgente sia compilabile con Qt 4.3.0 pulito e non patchato, ma potresti ottenere dei bugfix addizionali usando qt-copy (comunque, spesso la tua distribuzione si prende cura di fare backporting dei bugfix necessari, e sarebbe ottimale utilizzare quelli se sono abbastanza recenti). Riferisciti alle sezioni delle specifiche distribuzioni che puoi trovare sopra per avere più informazioni.

Per ora il layer di compatibilità con Qt3 in Qt4 è obbligatorio, quindi evita di usare l'opzione "-no-qt3support" quando compili Qt4 da sorgente.

=== I comandi ===
cd # Nota: qt-copy risiede in $HOME/qt-copy. Vedi $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# se non installiamo, allora puliremo i file obj per
# risparmiare spazio su disco
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Che sta succedendo? ===
Torniamo indietro alla home dell'utente <tt>kde-devel</tt> (riga 1) e scarichiamo il codice sorgente usando subversion (svn) dal repository di KDE (riga 2). Dopo esserci immessi nella risultante directory {{path|qt-copy}} (riga 3), eseguiamo uno script che gestisce le patch fornite da <tt>qt-copy</tt> (riga 4).

Una volta che le patch sono state applicate impostiamo la compilazione usando lo script <tt>configure</tt> (righe 5-6). Le varie righe di comando usate sono spiegate nel file {{path|qt-copy/README.qt-copy}}. Infine compiliamo i requisiti minimi di KDE (riga 7) e installiamo Qt (riga 10). Se la directory di installazione è la cartella corrente (riga 8), allora liberiamo dello spazio su disco (riga 9). Se vuoi tutti gli esempi e le applicazioni di dimostrazione puoi compilarli individualmente o dando un semplice <tt>make</tt> dalla directory {{path|qt-copy}}.

Nota che l'installazione non richiede l'utente root poiché installa Qt localmente in {{path|$QTDIR}}. Ad ogni modo, l'installazione è necessaria solo se {{path|$QTDIR}} differisce da {{path|$HOME/qt-copy}}, che non è il tuo caso se hai seguito attentamente le instruzioni.

=== Risoluzione dei problemi ===
Se ottieni "error: X11/Xlib.h: No such file or directory", installa il pacchetto di sviluppo di <tt>xorg</tt> (il nome esatto può variare tra i sistemi operativi, ad esempio si chiama <tt>xorg-dev</tt> su sistemi basati su Ubuntu come Kubuntu).

Se ottieni un errore durante il configure di definizioni mancanti controlla il valore di <tt>$QMAKESPEC</tt>. Alcune distribuzioni lo impostano in modo che punti direttamente al Qt installato dal sistema. Se <tt>unset QMAKESPEC</tt> risolve il problema vorrai sicuramente aggiungerlo allo script <tt>~/.bashrc</tt>.

Se ottieni un errore ".pch/debug-shared/QtCore" è perché Qt-4.3 abilita gli header precomplilati se il tuo gcc lo supporta, ma per qualche ragione non funzionerà per te. Se usi distcc, configura qt con l'opzione -no-pch. Se usi icecream aggiorna all'ultimo trunk svn di icecream.

Prova ad eseguire qualsiasi applicazione Qt come {{program|assistant}}. '''Nota:''' Potresti aver bisogno di eseguire <tt>xhost +local:kde-devel</tt> come il tuo normale utente di kde3 per eseguire quest'applicazione. Se va in crash in QSpanData::adjustSpanMethods allora il tuo problema è lo stile Oxygen. Prova a rimuovere {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} e {{path|lib/kde4/plugins/styles/oxygen.so}} se esistono nel prefisso di installazione di KDE.

== HAL ==

{{tip|Puoi usare qdbusviewer per vedere se hai org.freedesktop.hal. Se non è il tuo caso hai bisogno di una nuova versione di HAL. Se hai org.freedesktop.hal, non ne avrai probabilmente bisogno e non ''vorrai'' aggiornarla per mantenere il tuo HAL.}}

Se il tuo sistema ti chiede di compilare una nuova versione di HAL c'è una decente possibilità che tu debba compilare anche altre cose che non sono presenti in questo tutorial. Dato che questo dovrebbe essere indispensabile solo per vecchie distro, le istruzioni sono in [[Getting_Started/Build/HAL| una pagina separata]].

== kdesupport ==

{{warning|Non dimenticarti di leggere prima la sezione [[Getting_Started/Build/KDE4#Setting_up_the_environment|Impostare l'ambiente]].}}

Ci sono diverse librerie nel modulo kdesupport alle quali le applicazioni di KDE si appoggiano: Strigi e Soprano per i metadata e la ricerca dei file, QImageBlitz per la manipolazione delle immagini richiesto in kdebase, eigen per gli effetti visuali in applicazioni come Kalzium, taglib per riproduttori musicali e qca per necessità di crittografia.

Strigi di per sé ha alcune dipendenze: avrai bisogno delle librerie e header di libz, libbz2, openssl (libcrypto o libssl), libclucene (>=0.9.16a ma fà attenzione: la versione 0.9.17 '''non''' funziona), e libxml2 o libexpat.

Ti prego di ricordare che se usi openSUSE puoi installare i pacchetti richiesti dal buildservice repository KDE:KDE4 e non devi preoccuparti di seguire i dettagli forniti di seguito. Ignora la sezione kdelibs.

=== I comandi ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Che sta succedendo? ===
Ci immettiamo nella directory base dei sorgenti (riga 1). Scarichiamo i sorgenti di kdesupport usando subversion (riga 2), andiamo nella nuova directory {{path|~/kde/src/kdesupport}} (riga 3), e cominciamo la compilazione (riga 4). Ciò ci lascerà nella nella directory di compilazione di kdesupport quando la compilazione viene portata a termine.

=== Risoluzione dei problemi ===
Se ottieni
cmakekde: command not found
devi andare manualmente nella directory di kdesupport nella ~ ed eseguire il comando cmakekde. Se questo non risolve il problema, c'è qualcosa di sbagliato nel tuo bashrc.

Se ottieni
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
dovresti installare il pacchetto di sviluppo di libxml2.

Se ottieni
CMake Error: Could NOT find REDLAND
allora ti serve librdf dal Redland.
Se la tua distribuzione non include il pacchetto librdf, puoi scaricarne il sorgente da [http://download.librdf.org/source/ http://download.librdf.org/source/] e compilarlo.
(Utenti di Gentoo: l'ebuild di librdf si chiama dev-libs/redland)

Se ottieni
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
vedi [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

Se ottieni
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
dai un secondo sguardo al file .bashrc descritto sopra, i percorsi sono corretti? Alternativamente potresti ottenere quest'errore se decidi di utilizzare una versione di qt4 installata dalla distribuzione e hai saltato l'installazione di Qt come descritta sopra. Installa qt-copy come descritto sopra o fai "sudo make install". Se usi "sudo make install" assicurati di cambiare le appartenenze dei file al tuo utente per alcune sottodirectory in ~/kde affette dall'utilizzo di sudo (usa "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

== kdelibs ==

Adesso possiamo passare alla compilazione delle librerie di base di KDE.

=== I comandi ===
cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Che sta succedendo? ===
Ci immettiamo nella directory base dei sorgenti (riga 1), poi creiamo ed entriamo nella directory di KDE (riga 2). Scarichiamo i sorgenti di kdelibs usando subversion (riga 3), entriamo nella nuova cartella {{path|~/kde/src/KDE/kdelibs}} (riga 4) e cominciamo la compilazione (riga 5). Ciò ci lascerà nella directory di compilazione <tt>kdelibs</tt> quando la compilazione viene portata a termine.

{{tip|Potrebbero esserci delle dipendenze insoddisfatte nel tuo sistema! Sono facilmente individuabili nell'output di <tt>cmakekde</tt>.
Potresti fare <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prima di compilare qualsiasi modulo di kde (come kdelibs, kdepimlibs, ecc.)}}

=== Moduli addizionali di CMake specifici per KDE ===
Ci sono moduli CMake addizionali in {{path|kdelibs/cmake/modules/}} che sono necessari alla compilazione di applicazioni per KDE4. Saranno installati per te quando installerai kdelibs.

=== Risoluzione dei problemi ===
Se hai problemi a compilare kdelibs assicurati che il software nella sezione [[Getting_Started/Build/KDE4#Required_Software|Software richiesto]] sia installato e funzionante. Altri possibili errori possono essere:
* Se il comando <tt>cmakekde</tt> fallisce dicendo che CMake richiede una directory che non sia quella dei sorgenti rimuovi {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} e riprova.

Se <tt>cmakekde</tt> restituisce ancora lo stesso errore allora prova così:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* Se ricevi un errore che dice "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", allora devi cambiare la tua directory di compilazione prima di eseguire cmakekde (ad esempio: <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Se il messaggio insiste esegui 'svn status' nella cartella di kdelibs e rimuovi tutti i file etichettati con '?'.
* Se Qt non viene trovato o viene trovata una versione errata di Qt assicurati che il qmake del Qt che ti serve sia il qmake indicato nel percorso.
* Se qmake non viene trovato e stai utilizzando pacchetti Debian, /usr/bin/qmake probabilmente punta ad una versione errata di qmake. Per risolvere il problema esegui questo comando con privilegi di root:
update-alternatives --config qmake
* Se il problema persiste, prova l'opzione di CMake make-option <tt>--keep-going</tt>.
* Qui hai bisogno della libreria libungif, altrimenti otterrai un messaggio d'errore come "<tt>Could NOT find GIF</tt>".
* Aggiornamento di Qt-4.3: se ottieni un errore di collegamento in kjsembed riguardante QScriptEngine, modifica CMakeCache.txt in kdelibs e rimuovi le righe che parlano di QT_QTUITOOLS_LIBRARY, poi esegui make di nuovo (quella libreria statica ha una nuova dipendenza e il codice cmake che l'aggiunge deve essere eseguito).
* Se ottieni <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, installa openssl-devel, rimuovi CMakeCache.txt e ricompila QT.
* Se ottieni <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> significa che hai compilato QT senza il supporto a QT3 (no, linkare ad una vera installazione di QT3 non funzionerà).

== kdepimlibs ==
Dopo <tt>kdelibs</tt>, ma prima di ''kdebase'' devi compilare e installare ''kdepimlibs''.

=== I comandi ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Che sta succedendo? ===
Entriamo nella directory dei sorgenti di KDE (riga 1), scarichiamo il codice sorgente di kdepimlibs usando subversion (riga 2) ed entriamo nella nuova directory {{path|~/kde/src/KDE/kdepimlibs}} (riga 3). Dopodiché iniziamo la compilazione (riga 4). Ciò ci lascerà nella cartella di compilazione di <tt>kdepimlibs</tt> quando la compilazione viene portata a termine.

=== Risoluzione dei problemi ===
Se hai problemi a compilare kdepimlibs:
* il comando cmakekde può richiedere una versione aggiornata della libreria gpgme che è disponibile nel sito web del progetto: http://www.gnupg.org/(en)/download/index.html - ti prego di notare che la compilazione di gpgme richiede ancge libgpg-error, disponibile sempre nel sito del progetto. Entrambe le librerie si installano con la sequenza "./configure", "make" e "sudo make install", com la libreria gpgme configurata con il parametro addizionale "--with-gpg-error-prefix". Potresti dover sovrascrivere il tuo file esistente "/usr/bin/gpgme-config" con la nuova versione per far notare a kdepimlibs la nuova installazione.

== kdebase ==
kdebase è diviso in tre parti:
* '''apps'''
:Contiene applicazioni come Dolphin o KWrite.
* '''runtime'''
:Contiene cose richieste da ogni applicazione in esecuzione (runtime), come le icone. È una dipendenza richiesta per ogni applicazione per KDE, quindi devi compilarlo ed installarlo.
* '''workspace'''
:Contiene cose specifiche per il desktop KDE, come Plasma o il window manager. La maggior parte delle cose dipende da X11.Ne hai bisogno solo se vuoi compilare un desktop KDE completo.

Puoi compilare tutto il kdebase in un'unica volta, la quale compilazione è descritta qui sotto. Se vuoi compilare solo kdebase-runtime, che è l'unico richiesto, puoi rimpiazzare <code bash>cd kdebase</code> con <code bash>cd kdebase/runtime</code> nei comandi qui sotto.

=== I comandi ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Risoluzione dei problemi ===
Se hai problemi a compilare kdebase:
* Assicurati di avere gli header di <tt>libxss headers</tt> installati. (Spesso otterrai delle referenze non definite per gli oggetti xscreensaver se non hai quegli header)
* <tt>which meinproc</tt> deve restituire {{path|/home/kde-devel/kde/bin/meinproc}}.
* se cmakekde non trova il percorso di kdepimlibs, modifica il file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} e imposta manualmente <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>.
* se ottieni un errore che dice "Please set the following variables: X11_XTest_LIB (ADVANCED)", installa il pacchetto di sviluppo di <tt>Xtst</tt>. Per qualche sistema questo pacchetto è separato da <tt>xext</tt> ed è chiamato <tt>x11proto-xext-dev</tt> oppure <tt>libxtst-dev</tt>. Probabilmente avrai bisogno di eliminare il file CMakeCache.txt nella directory di compilazione dopo aver installato il pacchetto.
* lo stesso vale per "X11_Xinerama_LIB (ADVANCED)" dove avrai bisogno del pacchetto di sviluppo di <tt>xinerama</tt>.
* se ottiene un errore che parla di variabili mancanti in X11_Xrandr_LIB, ti serve il pacchetto di sviluppo di libxrandr (libxrandr-devel su sistemi basati su Ubuntu come Kubuntu).
* se ottieni l'errore "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", allora devi installare gli header di libfontconfig.
* se ottieni l'errore "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", devi installare soprano da kdesupport e ricompilare kdelibs.
* se ottieni l'errore "‘XserverRegion’ does not name a type" assicurati di avere gli header di libxcomposite installati (<tt>libxcomposite-dev</tt> su Ubuntu).
* se ottieni l'errore "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", prova a modificare CMakeCache.txt e ad impostare QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so

* se ottieni messaggi come "KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK.", allora trova i file contenenti la riga in questione e decommentala manualmente o esegui il seguente script in ~/kde/src/KDE/kdebase: [http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. RIMUOVERÀ semplicemente la riga che contiene "kde4_create_handbook" da tutti i file trovati.

== Eseguire programmi per KDE 4 ==

Ora puoi eseguire programmi per KDE 4 (ad esempio kwrite) digitando:
ssh -X kde-devel@localhost
kwrite

=== Risoluzione dei problemi ===

* Se ottieni
KUniqueApplication: Cannot find the D-Bus session server
controlla se hai l'accesso al display, ad esempio digita xclock e vedi se compare un orologio su schermo.

* Se ottieni qualcosa come
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped)
Devi installare kdebase - vedi sopra. Basta installare anche solo la directory "runtime" di kdebase.

== Generare documentazione locale API ==
Sebbene la documentazione API per KDE sia disponibile online su [http://api.kde.org api.kde.org] a volte è utile averla sul proprio disco, per esempio quando vuoi usare [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] per sfogliare la documentazione o quando non puoi restare online per tutto il tempo.

Bada bene che generare la documentazione API può metterci diverse ore e occupa almeno mezzo gigabyte di spazio su disco.
La generazione è gestita da uno script in {{path|kdelibs/doc/api}}, ti serve <tt>doxygen</tt> per poterlo eseguire.

Per compilare la documentazione API per kdelibs, digita i seguenti comandi:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' è una funzione di bash, clicca qui per saperne di più]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Ripeti l'operazione per gli altri moduli come si desidera. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Un alktro metodo più semplice è scaricare questo [[Doxyfile]] sul tuo sistema locale. Dopodiché devi cambiare semplicemente la directory su dove vuoi creare la documentazione ed esegui
<code bash>
% doxygen /path/to/Doxyfile
</code>
Poi rivedi il file {{path|doxygen.log}} per controllare eventuali errori e avvertenze di doxygen. Troverai la documentazione attuale nella sottodirectory {{path|apidocs}}.

== Rimanere aggiornati ==

Al fine di mantenere aggiornata le versione di kde4, ogni modulo installato dovrebbe essere aggiornato periodicamente. Come il Lunedì è il giorno dei maggiori cambiamenti in kdelibs, il Martedì può essere il momento migliore per farlo. Per ogni modulo in quesatione esegui <tt>svn up</tt> e <tt>make</tt>.

Per esempio:
<code bash>
cs kdesupport # cs non è un errore di battitura
svn up
cb # cb non è un errore di battitura
make -j2 VERBOSE=1 && make install
</code>

== Installare un sottoset di moduli ==

Molti moduli in KDE contengono un vasto numero di programmi che possono metterci molto tempo ad essere scaricati e compilati. Nel caso in cui tu voglia lavorare su un particolare programma o programmi in un modulo, è possibile scaricare e compilare le singole cartelle. In alcuni casi certe cartelle sono richieste per qualsiasi compilazione del modulo. Ciò viene determinato dal file CMakeLists.txt del modulo. Ad esempio il [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup file CMakeLists.txt di kdegames] dice:

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Quindi le directory libkdegames e libkmahjongg sono richieste per compilare ogni kdegames. Anche la directory di cmake sarà spesso richiesta. Tutte le altre directory (doc, katomic etc) sono opzionali. Saranno compilate se presenti sul tuo sistema. In quest'esempio compiliamo mahjongg e kbattleship:

<code bash>
cs KDE
svn co -N kdegames # Lo switch -N effettua un controllo non recursivo
cd kdegames
svn up libkdegames # Ottiene le directory richieste
svn up libkmahjongg
svn up cmake
svn up kbattleship # Ottiene le directory opzionali
svn up kmahjongg
cmakekde
</code>

== Risoluzione di problemi generali ==

Ciò che può succedere col passare del tempo, dopo alcuni comandi <tt>svn up</tt>, è che alcuni degli strumenti utilizzati nella catena di compilazione di KDE cambiano il loro formato dell'output. Per esempio, i file <tt>kcfg</tt> sono letti da <tt>kconfig_compiler</tt> per produrre finestre di dialogo. CMake non riesce ad individuare questi cambiamenti e la compilazione può perciò fallire. Un workaround è di forzare sempre una rigenerazione di tutti questi file:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
Lo stesso si applica ai file <tt>ui</tt> come prodotti dai progettatori Qt.

== Complimenti! ==

Adesso sei pronto per cominciare a compilare altri moduli svn nello stesso modo in cui hai compilato kdebase, eseguire e testare KDE4 o scrivere le tue patch e applicazioni.

Vedi il tutorial [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] per come far partire applicazioni per KDE 4 e come usare KDevelop per lavorarci.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (fr)

2008-01-09T20:44:18Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}
{{TutorialBrowser|

series=Démarrer avec KDE|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir l'interpréteur de commandes bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libpth-dev \
libxine-dev libxkbfile-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour que le framework [[apidox]] fonctionne correctement vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquants avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquetages requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Paquetages facultatifs'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquetages openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquetages suivants (et leurs dépendances):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous aurez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Ceux-ci sont les paquetages que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se connecter avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== L'interpréteur de commandes du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash kde-devel</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Ce qui se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquetage binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquetages spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Ce qui se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquetages adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make sub-src sub-tools
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;
</code>

=== Ce qui se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoi qu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquetage de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Ce qui se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
vous devez installer le paquetage de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquetage librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qui se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, et réessayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un message d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez-vous que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le lien vers une bonne installation de Qt3 ne fonctionne pas).
* Si vous avez un pb avec la lib Soprano >= 1.99 avec Kubuntu Gutsy alors supprimez les packages libsoprano-dev et libsoprano4, checkout et cmakekde du kdesupports si ce n'est déjà fait, puis
cs KDE/kdelibs \
cb \
rm CMakeCache.txt \
cs KDE/kdelibs \
cmakekde

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qui se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certaines choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquetage.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquetage de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs
* Si vous obtenez l'erreur "‘XserverRegion’ does not name a type", vérifiez que vous avez les en-têtes de libxcomposite installé (libxcomposite-dev dans Ubuntu).

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'opération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== Rester à jour ==

Pour garder une installation de KDE4 à jour, chaque module installé doit être mis à jour de manière périodique. Le lundi étant le jour des grosses modifications sur kdelibs, le mardi est le meilleur jour pour le faire. Pour chaque module que vous contrôlerez utilisez les commandes "svn up" puis "make" et "make install".

Par exemple :
<code bash>
cs KDE/kdesupport # cs n'est pas une commande unix
svn up
cb # cb n'est pas une commande unix
make -j2 VERBOSE=1 && make install
</code>

== Problèmes généraux ==

Ce qu'il peut arriver après quelques temps, après quelques commandes <tt>svn up</tt>, est que certain des outils utilisés dans la chaîne de compilation de KDE peuvent changer de format de sortie. Par exemple, les fichiers <tt>kcfg</tt> sont lu par <tt>kconfig_compiler</tt> pour produire les dialogues de configuration. CMake ne peut détecter ces changements, et dans ce cas la compilation échoue. Une solution consiste à forcer la re-génération de tout ces fichiers :
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
Le même principe s'applique aux fichiers <tt>ui</tt> produits par le Qt designer.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (da)

2008-01-09T20:43:32Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Kom igang|

name=Byg KDE4 fra kildekode|

pre=[[../../Sources/Anonymous_SVN|Anonym SVN hurtig startguide]]|

next=[[../../Set_up_KDE_4_for_development|Sæt KDE 4 op til udvikling]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: KDE fra Subversion bygnings værktøjet] [[../../Increased_Productivity_in_KDE4_with_Scripts|Øget produktivitet i KDE4 med scripts]] [[Development/Tutorials/CMake |Introduktion til CMake]] [[../KDE4/FreeBSD|FreeBSD noter]] [[../KDE4/Mac OS X|Instruktioner til Mac OS X]]|
}}

== Abstrakt ==

Denne tutorial viser en måde at få KDE fra trunk til at køre på Linux/BSD systemer. Gennem hele denne tutorial bruges bash shell'en. Hvis du er interesseret i at bygge KDE på andre systemer, f.eks Solaris, MacOS eller Microsoft Windows, så besøg [[../|Byg]] siden og se linksne i bunden til de respektive operativ systemer.

{{warning|Forvent en højere risiko for bygningsfejl '''på mandage''', hvor kritiske ændringer bliver implementeret. [http://developer.kde.org/~dirk/dashboard/ Dashboardet] reportere uventede brud. Du er meget velkommen til at rette de fejlende moduler.
}}

== Nødvendigt software ==

Det følgende skal være installeret før du kan gennemføre denne tutorial:
* gcc og g++ fra gcc projektet, anbefales version 4.1 ellere højere
* svn, subversion revisions kontrol klienten
* pkg-config
* udviklings biblioteker (development libraries) og headers til X11, OpenGL (mesa-common-dev og libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 og libxslt
* <tt>makeobj</tt> scriptet, som er en del af kdesdk. Du kan installere deb sin en del af kdesdk (kdesdk-scripts på Debian) eller lignende pakke, eller bare hente den selv fra [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info pakken], som er den freedesktop MIME standard KDE bruger nu
* [http://boost.org/ boost], skal bruges af kdebase; efter kompilering og/eller installering af boost, for at gøre cmake forberedt på dens placering (FindBoost), tilføj boost directory (den som indeholder include subdirectory) til CMAKE_INCLUDE_PATH eller sæt en miljøvariabel kaldet BOOST_ROOT som peger på boost directory.

Det anbefales desuden at du har følgende installeret:
* bash

=== Kubuntu ===

På Kubuntu 7.04 (Feisty) kan bygningsafhængighederne du behøver installeres med:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev
</code>

Du kan hoppe over den manuelle installation af Qt 4.3, CMake 2.4.6 og DBus ved at installere de følgende pakker (og deres afhængigheder). '''Notér venligst:''' Dette vil ikke virke for Qt til KDE4 efter Alpha 1 (Kubuntu feisty indeholder Qt4.3beta, ikke Qt4.3 final som er nødvendig. Hop videre til at bygge Qt fra svn længere nede):
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Og for fuldt funktionelt [[apidox]] framework skal du også bruge:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

I openSUSE 10.2 og nyere, kan du installere pakker ved at bruge [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <pakkenavn>
</code>

I ældre versioner af SUSE, kan du bruge YaST:
<code bash>
su
yast -i <pakkenavn>
</code>

'''Nødvendige pakker'''

Pakkerne du skal installere er:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Frivillige pakker'''

Du kan hoppe over den manuelle installation af Qt 4.3, CMake 2.4.6 og DBus ved at tilføje openSUSE Build Service KDE4 arkiv til dine installationskilder.

På openSUSE 10.2 og nyere, gør således:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

I ældre versioner af SUSE Linux, gør således:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[DIN SUSE LINUX VERSION]
</code>

Installer nu de følgende pakker (og deres afhængigheder):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Og for fuldt funktionelt apidox framework skal du også bruge:
<code>
graphviz
</code>

CMake binære pakker til openSUSE er tilgængelige fra [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Du kan bruge de mest stabile ebuildsm, bare husk at synkronisere din portage før du begynder.

Disse skal være unmasked og/eller holdt i en lavere version for at fortsætte.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Disse pakker er du nødt til at installere, nogen er måske allerede installeret, men så springer du dem bare over.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

Du vil starte med at kompilere i hånden fra [[Getting_Started/Build/KDE4#Strigi|Strigi sekionen]].

Held og lykke!

== Lav en brugerkonto til KDE4 udvikling ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash kde-devel</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
Det er bekræftet at QtDBus og KDE virker med D-Bus version 0.62, samt med 0.92 og opefter. Versionerne 0.60 og 0.61 virker muligvis også, men er ikke testet. Dog virker version 0.90 og 0.91 ikke. Vi anbefaler at bruge udgivelsesversioner højere end 1.0 (mindst 0.94), så overvej at opgradere hvis du ikke har gjort det.

Du kan springe dette trin over hvis du har en ny version af D-Bus, eller ikke ønsker at opgradere.

Før du bruger den følgende "opskrift", tjek da venligst at X11 headers og libraries er installeret. {{path|configure}}-programmet fortæller dig dette på linje 5:
Building X11 code: yes

=== Opskriften ===

{{tip|Tjek venligst at du har opsat dit miljø korrekt som beskrevet [[Getting_Started/Build/KDE4#Setting_up_the_environment|for oven]]. Dette er nødvendigt for at funktionerne <tt>cs</tt> og <tt>cb</tt> virker.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' er en bash-funktion, klik her for at lære mere]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
make install
dbus-uuidgen --ensure

=== Hvad sker der? ===
Efter du skifter til kildebiblioteket (linje 1), bliver kildekoden til D-Bus downloadet fra freedesktop.org (linje 2) og udpakket (linje 3). Når du er inde i dit nye D-Bus bibliotek (linje 4), bliver kildekoden konfigureret med det medfølgende {{path|configure}}-program (linje 5). Efter kompileringen (linje 6) og installationen (linje 7) af D-Bus, bruger vi programmet <tt>dbus-uuidgen</tt> til at generere en identifikationsfil, der tillader programmet at starte op sammen med din desktop-session (linje 8).

Bemærk venligst at du skal have skriveadgang til {{path|/var}} for at køre de to sidste kommandoer. Hvis dit system ikke bruger sudo, kan du bruge <tt>su</tt>-kommandoen i stedet, f.eks. <tt>su -c "make install"</tt>.

=== Fejl? ===

Hvis du får fejlen '''makeobj: command not found''', mangler dit system med stor sandsynlighed kommandoen <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu(feisty:Qt4.3 beta), openSUSE, Fedora, Gentoo, Debian experimental). You should use the copy in the KDE Subversion servers.

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== TroubleShooting ===
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

== kdelibs ==

With Qt4, Strigi, and Soprano built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== The Recipe ===

cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (ru)

2008-01-09T20:41:18Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

=== Ark Linux ===
В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

=== Arch Linux ===

В Arch Linux необходимо установить следующие пакеты:
<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Если Вы хотите использовать qt4 из репозитория Arch Linux, то его можно установить с помощью следующей команды:
<code bash>
pacman -Sy qt4
</code>

=== Fedora ===

Чтобы установить большинство необходимых для сборки KDE4 в Fedora 7 (и выше), выполните:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

DCH-10/15/07: Примечание: возможно, что проще собрать RPM-ки. Можно отредактировать переменные в /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

Секция сборки (build stage) должна выглядеть примерно так:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Я сумел достичь лучших результатов, собирая kdesupport rpm, что означает, что Вам не потребуется устанавливать RPM-пакеты soprano или strigi. YMMV (непереводимый смайл или восклицание :) ).

=== Kubuntu и Debian ===
В Kubuntu 7.04 (Feisty) и Debian (Testing/Unstable) необходимое программное обеспечение можно установить следующей командой:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

В Kubuntu 7.10 (Gutsy) и Debian unstable следует добавить:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev libxkbfile-dev
</code>

Для того чтобы задействовать всю функциональность системы документации (API documentation framework), также выполните:
<code>
sudo aptitude install graphviz
</code>

В Kubuntu Gutsy и Debian unstable нет никакой необходимости компилировать qt или kdesupport. Все необходимые пакеты доступны после процедуры описанной в настоящем разделе, потому переходите сразу к [[#kdelibs|сборке kdelibs]], перед этим только [[#Создание пользователя для разработки KDE 4|создав отдельного пользователя в системе для запуска программ KDE4]].

{{Note|При возникновении проблем при компиляции KDE4 Beta4 или выше в Kubuntu 7.10, похожих на:

Soprano version is too low

strigi xxx.h not found...

Необходимо обновить и собрать соответствующую часть исходного кода kdesupport.
Это описано в разделе о сборке kdesupport.

Также удалите пакет soprano: sudo apt-get remove libsoprano4 libsoprano-dev (этот пакет мы соберём из исходников самостоятельно)

If you still get an error in the kdelibs section about soprano like:
CMake Error: Error in cmake code at
$src/KDE/kdelibs/cmake/modules/FindSoprano.cmake:78:
FILE Internal CMake error when trying to open file: /usr/include/soprano/version.h for reading.

then delete kdelibs/CMakeCache.txt
}}

=== openSUSE ===
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

=== Gentoo ===

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Fedora ===

Для сборки KDE4 вам необходимо иметь установленную Fedora 7 или выше. Необходимые пакеты можно установить, выполнив от пользователя с правами root'a, следующую команду:

<code bash>
yum install cmake clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

=== Mandriva ===

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
cd # qt-copy находится в $HOME/qt-copy. Посмотрите значение $QTDIR в [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас боступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2008-01-09T20:40:47Z

Powerfox: /* openSUSE */

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[[../kdesvn-build|kdesvn-build: The KDE From Subversion Build Tool]] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. There are also tutorials for [[Getting_Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting_Started/Build/KDE4/Mac OS X|Mac OS X]] and [http://solaris.kde.org/ Solaris]. Throughout the tutorial the bash shell is used.

{{warning|Expect a higher risk of build failure '''on Mondays''' when most kdelibs changes are committed. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Software Requirements ==

The following needs to be installed to successfully use this tutorial:
* gcc and g++, preferably version 4.2 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is included in kdesdk. You can install it from kdesdk (kdesdk-scripts on Debian) or similar packages, or download at [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], is the freedesktop MIME standard now used in KDE
* [http://boost.org/ boost], used by kdebase; after build and/or install, in order to make cmake aware about its location (FindBoost), add the boost directory (which contains the include subdirectory) to CMAKE_INCLUDE_PATH or set a environment variable called BOOST_ROOT that points to the boost directory.

=== Ark Linux ===
In Ark Linux, the build dependencies you need are installed with:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mission Control.

This includes installation of CMake, DBus and Qt - you can skip steps 5, 6 and 7.

=== Arch Linux ===
In Arch Linux you need to install the following packages:

<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib clucene
</code>

If you want to use qt4 from the Arch Linux repository you can install it with:
<code bash>
pacman -Sy qt4
</code>
("pacman -Sy qt" if you are running bleeding-edge Arch Testing)

<s>For clucene libraries you need the [http://aur.archlinux.org/packages.php?do_Details=1&ID=5968 PKGBUILD] from AUR.</s>
(No longer needed since clucene has been put into the extra-repo.)

=== Fedora ===

Some of the required packages for building KDE4 on Fedora 7 or higher:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

Some optional packages for koffice support:
<code bash>
yum install qca2-devel gsl-devel freeglut-devel \
GraphicsMagick-c++-devel GraphicsMagick-devel
</code>

This includes installation of D-Bus and CMake -- you can skip steps 5 and 6.

DCH-10/15/07: Note - It may be simpler to spin RPMs. Note that you can edit the variables in /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

The build stage then looks like:
(but in what directory?)
%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

I have had better results with creating a kdesupport rpm which means that you should not install the soprano and strigi rpms. YMMV

telsh: On a Fedora 8 System I had to install "qt4-devel" too to have qmake.

=== Kubuntu and Debian ===

In Kubuntu 7.04 (Feisty) and Debian (Testing/Unstable) the build dependencies you need are installed with:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

In Kubuntu 7.10 (Gutsy) and Debian unstable you also have to add:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev libxkbfile-dev
</code>

For a fully functional API documentation framework you also need:
<code>
sudo aptitude install graphviz
</code>

There is no need to compile qt or kdesupport on kubuntu gutsy. All required packages are provided by installing the above. Setup the kde4 user etc as explained in the next section, but skip over compiling qt, hal and kdesupport.

{{Note|
If you get something trouble on compile KDE4
Beta4 or above in Kubuntu 7.10, such as :

Soprano version is too low

strigi xxx.h not found...

You may need to checkout, and compile the relevant part of
kdesupport source code in the SVN server of KDE4. (svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano/)

This is covered when you get to the section on compiling kdesupport.

You might also have to remove any installed soprano package : sudo apt-get remove libsoprano4 libsoprano-dev

If you still get an error in the kdelibs section about soprano like:
CMake Error: Error in cmake code at
$src/KDE/kdelibs/cmake/modules/FindSoprano.cmake:78:
FILE Internal CMake error when trying to open file: /usr/include/soprano/version.h for reading.

then delete kdelibs/CMakeCache.txt
}}

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Optional Packages'''

You can skip the manual and painful installation kdesupport and its dependencies ( Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi,
Soprano and other Nepomuk dependencies) by adding the KDE:KDE4 repository from
the [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

There are a lot more packages that are needed to satisfy the config-check, such as libusb-devel, bison etc., so look out for the config notifications and install accordingly. Please remember to skip any instructions that refer to kdesupport below. Start to compile with kdelibs.

And for fully functional apidox framework you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from the KDE:KDE4 repository as well as from the [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Install by hand ====

You can use stable ebuilds just remember to sync your portage before you begin.

Remember: All commands are executed as root.

Required:

We need to allow the following keyword masked ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Make sure you have set the berkdb USE flag for redland, otherwise nepomuk won't work.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
echo 'x11-libs/qt accessibility' >> /etc/portage/package.use
</code>

These are the packages you will need to emerge, I included the update option into the emerge command so you will not re-emerge anything that you might already have installed.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

You will also need to emerge either 'kde-base/kdesdk' or kde-base/kdesdk-scripts'.

If you emerged DBUS, CMAKE, QT or HAL you may skip those sections respectively.
Good luck!

==== Install via portage ====

Also you can install the KDE 4 packages directly via
<code bash>
emerge -a <packagename>
</code>

To get the things you need, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] and then pull in the "kde" overlay (which contains experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
After this you need to adjust some USE-flags for KDE 4 and tell portage to use the testing KDE 4 ebuilds instead of the stable KDE 3 ones.

That way portage will do the dependency tracking for you.

Detailed instructions on building KDE 4 in Gentoo via portage can be found in the [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. They are discussed in the forum thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds], which is continued [http://forums.gentoo.org/viewtopic-p-4359581.html#4359581 here]

=== Mandriva ===
In Mandriva the build dependencies you need are installed with:

<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel libxine-devel
</code>

If you're running 64-bit environment you should replace all packages starting with "lib..." to "lib64...".

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mandriva Linux Control Center.

This includes installation of CMake, DBus - you can skip steps 5 and 6.

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

{{Warning|
The new kde-devel user will not be added automatically to all the user groups, which will result in not having sound, not being able to sudo, etc. Edit your /etc/groups file to add the kde-devel user to all the groups that you need (probably the groups that your usual username is already assigned to).
}}

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. Also if you want to use KDevelop to develop KDE 4 applications you may pass the ''-GKDevelop3'' flag to the ''cmake'' command (to make CMake generate KDevelop project files, it will help to avoid rebuilding in the future, see [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|this]]).
To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|
If the ssh command fails, check out the [[Getting_Started/Set_up_KDE_4_for_development#Launching_KDE_4_apps|Launching KDE 4 apps]] section of the [[Getting_Started/Set_up_KDE_4_for_development|KDE4 development guide]].
}}

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.
On Ark Linux and Fedora, you can skip this step - {{path|/bin/sh}} is {{path|bash}}.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash kde-devel</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade. You probably want to skip building the bindings until/unless you know you will be building HAL (see below).

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 of the following instructions should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

The steps for building the glib bindings are similar to the above.

When these two packages are done building, we must fix the file ownership because 'sudo make install' has created root owned files and directories in ~kde-devel/kde.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get Qt4. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work.

If your distribution has a recent version of Qt4, that should work. Most distros backport bugfixes, and some distros, like Debian or openSUSE, even use the patches from KDE svn. In other cases, using the recipe below will give you a more stable Qt than your distro. Refer to the distribution specific sections above for more information.

As for now Qt3 compatibility layer in Qt 4 is mandatory, so please avoid using "-no-qt3support" option when building Qt4 from sources.

=== The Recipe ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# if we don't install, we'll just clear obj files to
# save disk space
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-6). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 7) and install (line 10) Qt. If install dir is the same as the current dir (line 8), then we just free some space (line 9) instead. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|Don't forget to read the [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] section first.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, QImageBlitz for image manipulation needed in kdebase, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (>=0.9.16a but watch out: version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

Please remember that if you use openSUSE, you can install the needed packages from the KDE:KDE4 buildservice repository and do not have to bother with fiddling the details below. Skip to the kdelibs section.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manually into the kdesupport directory in ~ and execute the command cmakekde. if this still doesn't work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? ($QTDIR and $PATH are used to get the QT installation path)
Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

If you get a message related to
target libQtTest.so not found
you may need to recompile qt-copy. This time you should take out
-nomake demos -nomake examples
from the configure command, so that Qt generates library QtTest.

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Software_Requirements|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If qmake wasn't found and you are using Debian packages, /usr/bin/qmake probably points to a wrong qmake version. To fix this run as root:
update-alternatives --config qmake
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)
* if none of the errors above match yours, you might just try a quick'n'dirty <code>make clean</code> in kdelibs.

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the recipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
svn checkout svn://anonsvn.kde.org/home/kde/branches/KDE/4.0/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so

* if you get messages as "KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK." then, either find the files containing the offending line and comment it out manually, or run the following script in ~/kde/src/KDE/kdebase: [http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. It will just REMOVE the line that has "kde4_create_handbook" in it from all the found files.
*If you get an error (in ubuntu) concerning libxtst.so install the libxtst-dev package
* If you get the message "kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared", you might need to install libxklavier development packages.
* If you get "/home/kde-devel/kde/lib/libkio.so: undefined reference to `Strigi::AnalysisResult::AnalysisResult(std::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, long, Strigi::IndexWriter&, Strigi::StreamAnalyzer&)'" you probably have an outdated version of strigi installed by your distro.

== Running KDE 4 programs ==

You can now run KDE 4 programs (e.g. kwrite) by typing:
ssh -X kde-devel@localhost
kwrite

=== Troubleshooting ===

* If you get
KUniqueApplication: Cannot find the D-Bus session server
check if you can access the display, e.g. type
xclock
and see if a clock appears on the screen.

* If you get something like
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped)
You need to install kdebase - see above. It is enough to install the "runtime" directory from kdebase.

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

Note: it is not necessary to run cmakekde for updates.

== Installing a subset of a module ==

Many modules in KDE contain a large number of programs which could take a long time to download and compile. In cases where you want to work only on a particular program or programs in a module, it is possible to download and compile particular folders. In some cases, certain folders are required for any build of the module. This is determined in the CMakeLists.txt file of the module. For example the [http://websvn.kde.org/branches/KDE/4.0/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt file] lists:

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

So, the libkdegames and libkmahjongg directories are required to build any of kdegames. The cmake directory will also usually be required. All the other directories (doc, katomic etc) are optional. They will be built if present on your machine. In this example, we build kmahjongg and kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

=== Locked sessions ===
When installing KDE 4 as a user, one will not be able to unlock a locked session. To work around this issue you can either:
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
or
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Also you have to add a "kde" service in /etc/pam.d/ folder

For example for RH/Fedora based distros:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (ru)

2008-01-09T12:36:46Z

Powerfox: /* Fedora */ Update

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Сборка KDE4 из исходного кода|

pre=[[../../Sources/Anonymous_SVN|Краткое пособие по анонимному использованию SVN (Anonymous SVN Quickstart Guide)]]|

next=[[../../Set_up_KDE_4_for_development_(ru)|Подготовка KDE4 для разработки]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: утилита для сборки KDE из Subversion-репозитория] [[../../Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]] [[Development/Tutorials/CMake |Введение в CMake]] [[../KDE4/FreeBSD|Инструкции для FreeBSD]] [[../KDE4/Mac OS X|Инструкции для Mac OS X]] [[../KDE4/Windows|Инструкции для MS Windows]]|
}}

== Введение ==
В данной статье показано, как собрать KDE на системах Linux/BSD. Также есть следующие статьи: [[Getting Started/Build/KDE4/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]] и [http://solaris.kde.org/ Solaris]. В листингах команд везде используется bash.

{{warning|По '''понедельникам''' высока вероятность проблем со сборкой. Это связано с тем, что большинство изменений в kdelibs вносятся в этот день. [http://developer.kde.org/~dirk/dashboard/ Dashboard] сообщает о неожиданных сбоях. Приветствуется самостоятельное исправление нерабочих модулей.
}}

== Необходимое программное обеспечение ==

Следующие пакеты должны быть установлены для успешной сборки:
* gcc и g++, предпочтительно версии 4.2 и выше
* svn, клиет контроля за версиями (the subversion revision control client)
* pkg-config
* Заголовочные файлы и библиотеки для разработки X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 и libxslt
* Скрипт <tt>makeobj</tt>, являющийся частью kdesdk. Его можно установить вместе с kdesdk (в Debian пакет kdesdk-scripts) или идентичным пакетом, или же скачать отдельно с [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* [http://freedesktop.org/wiki/Software/shared-mime-info пакет shared-mime-info], используемый сейчас в KDE в качестве стандарта freedesktop MIME (the freedesktop MIME standard)
* [http://boost.org/ boost], требуется для kdebase; после компиляции и/или установки boost, для работоспособности cmake (FindBoost) следует добавить каталог с boost (содержащий подкаталог с заголовочными файлами) в CMAKE_INCLUDE_PATH, или же задать переменную окружения BOOST_ROOT, указывающую на каталог с boost.

=== Ark Linux ===
В Ark Linux все необходимые для сборки пакеты можно установить следующим способом:
<code bash>
pacman -Sy install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-core-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

Если вы предпочитаете графический интерфейс, то можете установить вышеперечисленные пакеты с помощью утилиты «Install Software» из Mission Control.
После этого CMake, DBus и Qt будут установлены - пункты 5,6 и 7 можно пропустить.

=== Arch Linux ===

В Arch Linux необходимо установить следующие пакеты:
<code bash>
pacman -Sy subversion bzip2 libxslt libxml2 \
shared-mime-info mesa boost dbus openssl \
pkgconfig xine-lib
</code>

Если Вы хотите использовать qt4 из репозитория Arch Linux, то его можно установить с помощью следующей команды:
<code bash>
pacman -Sy qt4
</code>

=== Fedora ===

Чтобы установить большинство необходимых для сборки KDE4 в Fedora 7 (и выше), выполните:

<code bash>
yum install clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel gcc-c++ libXext-devel cmake subversion giflib-devel \
libpng-devel libXdamage-devel libXcomposite-devel libXrender-devel \
fontconfig-devel libXft-devel libXcursor-devel libXfixes-devel \
ruby-devel libXScrnSaver-devel libkdcraw-devel exiv2-devel \
lcms-devel libtiff-devel sqlite-devel libxkbfile-devel \
imlib2-devel patch gstreamer-plugins-base-devel gsl-devel
</code>

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

DCH-10/15/07: Примечание: возможно, что проще собрать RPM-ки. Можно отредактировать переменные в /etc/rpm/macros.kde4 (which is provided by Rawhide kde-filesystem).

Секция сборки (build stage) должна выглядеть примерно так:

%build

mkdir -p %{_target_platform}

pushd %{_target_platform}

%{cmake_kde4} ..

popd

make %{?_smp_mflags} -C %{_target_platform}

Я сумел достичь лучших результатов, собирая kdesupport rpm, что означает, что Вам не потребуется устанавливать RPM-пакеты soprano или strigi. YMMV (непереводимый смайл или восклицание :) ).

=== Kubuntu и Debian ===
В Kubuntu 7.04 (Feisty) и Debian (Testing/Unstable) необходимое программное обеспечение можно установить следующей командой:
<code>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng12-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev libjasper-dev \
ssh libxine-dev libqimageblitz-dev libqimageblitz4 libglib2.0-dev \
libxkbfile-dev libenchant-dev libbluetooth-dev network-manager-dev \
libsmbclient-dev libxcb1-dev libcaptury-dev libxcomposite-dev \
libxdamage-dev libusb-dev libgpgme11-dev libldap2-dev
</code>

В Kubuntu 7.10 (Gutsy) и Debian unstable следует добавить:
<code>
sudo aptitude install dbus-x11 libqt4-dev libqca2-dev libeigen-dev \
libstreamanalyzer-dev libsoprano-dev libstrigiqtdbusclient-dev \
libxklavier11-dev libxml2-utils libdbus-1-dev libxslt1-dev cmake libbz2-dev \
libungif4-dev libgpgme11-dev libboost-dev libxine-dev libxkbfile-dev
</code>

Для того чтобы задействовать всю функциональность системы документации (API documentation framework), также выполните:
<code>
sudo aptitude install graphviz
</code>

В Kubuntu Gutsy и Debian unstable нет никакой необходимости компилировать qt или kdesupport. Все необходимые пакеты доступны после процедуры описанной в настоящем разделе, потому переходите сразу к [[#kdelibs|сборке kdelibs]], перед этим только [[#Создание пользователя для разработки KDE 4|создав отдельного пользователя в системе для запуска программ KDE4]].

{{Note|При возникновении проблем при компиляции KDE4 Beta4 или выше в Kubuntu 7.10, похожих на:

Soprano version is too low

strigi xxx.h not found...

Необходимо обновить и собрать соответствующую часть исходного кода kdesupport.
Это описано в разделе о сборке kdesupport.

Также удалите пакет soprano: sudo apt-get remove libsoprano4 libsoprano-dev (этот пакет мы соберём из исходников самостоятельно)

If you still get an error in the kdelibs section about soprano like:
CMake Error: Error in cmake code at
$src/KDE/kdelibs/cmake/modules/FindSoprano.cmake:78:
FILE Internal CMake error when trying to open file: /usr/include/soprano/version.h for reading.

then delete kdelibs/CMakeCache.txt
}}

=== openSUSE ===
В openSUSE 10.2 и новее пакеты можно установить, используя [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

В более старых релизах можно использовать YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Необходимые пакеты'''

Пакеты, которые нужно установить:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (необходимо для сборки kdesupport)
gpgme-devel (необходимо для сборки kdepimlibs)
libxine1-devel
</code>

'''Необязательные (Optional) пакеты'''

Ручную и мучительную установку kdesupport с её многочисленными зависимостями (Qt 4.3, CMake 2.4.6, DBus, Hal, clucene-core, Strigi, Soprano и другие пакеты из состава Nepomuk) можно пропустить, добавив репозиторий KDE:KDE4 из [http://download.opensuse.org/repositories/KDE:/KDE4/ openSUSE Build Service] в список источников установки.

Для openSUSE 10.2 и выше сделайте:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Для более старых версий SUSE Linux выполните:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Теперь установите следующие пакеты:
<code>
cmake
dbus-1-devel
libqt4-devel
libqca2-devel
libsoprano-devel
libqimageblitz-devel
strigi
strigi-ui
</code>

Для удовлетворения зависимостей проверки конфигурации (config-check) необходимо намного больше пакетов, таких как libusb-devel, bison и т.д. Установите их в соответствии с конфигом. Не забудьте, что все инструкции ниже, относящиеся к kdesupport, необходимо пропустить. Продолжите сборку с kdelibs.
Чтобы задействовать всю функциональность системы apidox (apidox framework), вам нужен
<code>
graphviz
</code>

Бинарные пакеты CMake для openSUSE доступны в репозитории KDE:KDE4, так же как и в [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service]

=== Gentoo ===

==== Ручная установка ====
Используя стабильные сборочные файлы (ebuilds), не забудьте обновить дерево портежей («синькнуться»), прежде чем приступить к установке.

Нам нужно разрешить следующие сборочные файлы, замаскированные ключами:
<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Удостоверьтесь, что для redland установлен USE-флаг berkdb, в противном случае nepomuk не будет работать.
<code bash>
# echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

Далее приведён список необходимых пакетов, некоторые из которых могут быть уже установлены (их можно пропустить, добавив флаг обновления в emerge).

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal' \
'x11-libs/qt'
</code>

Также может потребоваться выполнить emerge либо для 'kde-base/kdesdk', либо для kde-base/kdesdk-scripts'.

Если вы установили DBUS, CMAKE, QT и (возможно) HAL, то соответствующие секции можно пропустить.

Удачи!

==== Установка с помощью portage ====
Также пакеты KDE 4 можно установить напрямую с помощью
<code bash>
emerge -a <packagename>
</code>

Получите всё необходимое на [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] и положите в оверлей "kde" (содержащий экспериментальные сборочные файлы)
<code bash>
layman -a kde
</code>
После этого следует настроить USE-флаги, необходимые для KDE 4, и задать portage использование тестовых (экспериментальных) сборочных файлов вместо стабильных для KDE 3.

Таким образом, система портежей отследит все зависимости.

Подробная инструкция по сборке KDE 4 в Gentoo находится в статье [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. Обсуждение ebuilds находится в теме о [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

=== Fedora ===

Для сборки KDE4 вам необходимо иметь установленную Fedora 7 или выше. Необходимые пакеты можно установить, выполнив от пользователя с правами root'a, следующую команду:

<code bash>
yum install cmake clucene-core-devel libxml-devel libxslt-devel \
dbus-devel boost-devel bzip2-devel openssl-devel alsa-lib-devel \
redland-devel rasqal-devel raptor-devel hspell-devel aspell-devel \
cups-devel xine-lib-devel avahi-devel gamin-devel OpenEXR-devel \
enchant-devel jasper-devel ilmbase-devel pcre-devel gpgme-devel \
libxklavier-devel glib-devel libusb-devel libsmbclient-devel \
libxcb-devel NetworkManager-devel lm_sensors-devel libraw1394-devel \
bluez-libs-devel
</code>

=== Mandriva ===

В Mandriva необходимые для сборки пакеты устанавливаются с помощью:
<code bash>
urpmi gcc-c++ cmake libxml2-devel libbzip2_1-devel \
libclucene0-devel liblrdf2-devel libmesagl1-devel \
subversion doxygen libdbus-1_3-devel libopenssl0.9.8-devel \
libalsa2-devel libgpgme-devel libboost1-devel
</code>

При использовании 64-х битной сборки необходимо заменить все префиксы "lib..." на "lib64...".

Если Вы предпочитаете использовать графический интерфейс, то выберите перечисленные выше пакеты в утилите "Install Software" из Mandriva Linux Control Center.

После этого CMake и DBus будут установлены - пункты 5 и 6 можно пропустить.

== Создание пользователя для разработки KDE 4 ==

{{Note|
Некоторые люди предпочитают создавать отдельного пользователя для KDE 4 (например, из-за старого бага, по ошибке удалявшего файлы) - инструкция, приведённая ниже, была написана исходя из этого.

Однако намного эффективнее делать всё из-под одного пользователя, см.
[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|ППовышение производительности вашего труда при разработке KDE4 при использовании скриптов]]
, чтобы узнать больше.

Тем не менее, можно следовать инструкции, приведённой ниже, но тогда не включайте никаких переменных окружения в <tt>.bashrc</tt> - задавайте их в отдельном файле, используемом при переключении к KDE 4.
}}

=== Способ 1: Командная строка ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Способ 2: Использование KControl ===
Вместо выполнения команд, приведённых выше, можно использовать модуль управления пользователями в Центре управления KDE, если уже установлен KDE3.

=== Настройка окружения ===
Скопируйте файл {{path|~/.bashrc}} обычного пользователя в домашний каталог пользователя kde-devel. Затем вставьте в {{path|~kde-devel/.bashrc}} содержимое из [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|примера файла .bashrc]]. Если у вас недоступна команда <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt>, то закомментируйте строку <tt>alias make=makeobj</tt>. Наверняка вам потребуется изменить путь, чтобы удостовериться, что он не содержит kde3. Также, если вы планируете заниматься разработкой приложений для KDE 4 с помощью KDevelop, к команде ''cmake'' вы можете добавить параметр ''GKDevelop3'' (чтобы CMake генерировала файлы проекта KDevelop, это поможет в будущем избежать пересборки; подробности [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Setting_up_the_environment|здесь]]). Чтобы выполнить данный скрипт, можно открыть новый сеанс bash или выполнить
<code bash>
source ~/.bashrc
</code>

Это обеспечит доступ к таким командам, как <tt>cmakekde</tt>, которые использованы в данном обзоре, а также гарантирует правильность путей для исполняемых файлов Qt, KDE и CMake.

Для получения большей информации посмотрите обзор [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Повышение производительности вашего труда при разработке KDE4 при использовании скриптов]].

=== Переключение к новому пользователя ===
Чтобы стать пользователем kde-devel, наберите (не забудьте дефис!):
<code bash>
ssh -X kde-devel@localhost
</code>

{{Note|Если возникают проблемы с ssh, проверьте раздел [[Getting_Started/Set_up_KDE_4_for_development_(ru)#Запуск приложений KDE 4|Запуск приложений KDE 4]] из [[Getting_Started/Set_up_KDE_4_for_development_(ru)|руководства по разработке KDE4]].
}}

== Настройка командной оболочки для разработки ==

В некоторых системах новый пользователь по умолчанию использует {{path|/bin/sh}}. Данный раздел можно пропустить, если к вашей системе это не относится. Работа с {{path|/bin/sh}} может быть довольно неудобной, поэтому может потребоваться поменять оболочку на {{path|/bin/bash}} или любую другую.
В Ark Linux и Fedora {{path|/bin/sh}} по умолчанию установлен {{path|bash}}, поэтому пользователям Ark этот шаг можно пропустить.

=== Способ 1: Пользователь kde-devel ===

Если невозможно изменить оболочку пользователя с помощью утилиты <tt>chsh</tt> (отсутствуют необходимые привилегии суперпользователя), то можно попробовать изменить оболочку на {{path|/bin/bash}}, выполнив:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Способ 2: Суперпользователь ===

Если в системе присутствует приложение <tt>usermod</tt>, то нужно выполнить от имени суперпользователя следующую команду: <tt>usermod -s /bin/bash kde-devel</tt>.

Другой вариант - использовать утилиту <tt>vipw</tt>, чтобы, обладая привелегиями суперпользователя, отредактировать файл {{path|/etc/passwd}}. В конце файла 'kde-devel' нужно поменять строку '{{path|/bin/sh}}' на '{{path|/bin/bash}}', сохранить изменения и выйти.

Новая командная оболочка будет автоматически запущена, когда пользователь kde-devel снова войдёт в систему.

== D-Bus ==

QtDBus и KDE работают с D-Bus версий 0.62 и >= 0.92. Версии 0.60 и 0.61 могут работать, но правильность их работы не гарантируется. Известно, что версии 0.90 и 0.91 не поддерживаются. Рекомендуется использовать версии старше 1.0 (по крайней мере 0.94), так что следует обновиться, если установленная версия не соответствует требуемой.

Данный раздел можно пропустить, если установлена свежая версия D-Bus, или если обновление невозможно. Также, наверное, стоит пропустить секцию, в которой описано построение привязок (bindings), если вы не собираетесь собирать HAL (см. ниже)

Перед началом выполнения инструкций удостоверьтесь, что установлены заголовочные файлы и библиотеки X11. Конфигурационный скрипт (строка 5 нижеприведённых инструкций) должен вывести:
Building X11 code: yes

=== Инструкция ===

{{tip|Удостоверьтесь, что системное окружение настроено так, как было описано [[Getting_Started/Build/KDE4#Setting_up_the_environment|выше]]. Это необходимо для работы функций <tt>cs</tt> и <tt>cb</tt>.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' явдяется функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install
cd
sudo chown -R kde-devel:kde-devel *

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt> (строка 1); c freedesktop.org был скачан (строка 2) и распакован (строка 3) исходный код D-Bus. Затем после входа в появившийся каталог (строка 4) с помощью скрипта {{path|configure}} были настроены параметры сборки (строка 5).
После сборки (строка 6) и установки (строка 7) D-Bus с помощью утилиты <tt>dbus-uuidgen</tt> был установлен файл идентификации машины (machine identification file), позволяющий автоматически запускать D-Bus одновременно с сессией рабочего стола (строка 8).

При выполнении последних двух команд требуются права на запись в {{path|/var}}. Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.
Сбока привязки к glib аналогична вышеописанной.

После сборки этих двух пакетов необходимо изменить владельца файлов, так как в результате выполнения 'sudo make install' владельцем файлов и каталогов в ~kde-devel/kde является root.
== CMake ==

Раздел можно пропустить при наличии установленной версии [http://cmake.org/ CMake] >=2.4.5
Можно использовать бинарные пакеты с [http://www.cmake.org/HTML/Download.html сайта CMake]. Также доступны пакеты для различных дистрибутивов.

=== Инструкция ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите сюда, чтобы узнать больше]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, скачать (строка 2) и распаковать (строка 3) исходники Cmake. Для сборки CMake нужно создать каталог (строка 4), войти в него (строка 5), запустить скрипт пересборки CMake (CMake bootstrap script) для настройки параметров сборки (строка 6) и затем выполнить сборку (строка 7) и установку (строка 8) с правами суперпользователя.

Если в системе отсутствует команда sudo, то можно использовать <tt>su</tt>, например, <tt>su -c "make install"</tt>.

== Qt ==
Теперь необходимо собрать Qt4 из репозитория исходных кодов (source repository) KDE4. KDE можно собрать с помощью Qt 4.3. Qt 4.2 и более ранние версии не поддерживаются. Следует использовать копию с серверов KDE Subversion (копия от KDE - это официальный пакет Qt плюс срочно исправленные баги).
В некоторых дистрибутивах, таких, как Debian или openSUSE, имеется версия Qt с патчами из svn-репозитория KDE. Поэтому можно схитрить и использовать Qt из вашего дистрибутива, так как. KDE старается гарантировать, что исходники можно собирать с обычным, непропатченным Qt 4.3.0. Но Вы, наверное, захотите получить некоторые багфиксы, используя qt-copy (однако, обычно дистрибутивы вносят необходимые багфиксы, так что, если дистрибутив свежий, то, наверняка, Вам будет удобнее использовать "родной" qt). Обратитесь к разделам выше, посвящённым дистрибутивам, чтобы получить дополнительную информацию.

На данный момент модуль совместимости с Qt3 в Qt4 является обязательным, поэтому при сборке Qt4 из исходников не используйте опцию "-no-qt3support".

=== Инструкция ===
cd # Note: qt-copy lives in $HOME/qt-copy. See $QTDIR in [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
cd # qt-copy находится в $HOME/qt-copy. Посмотрите значение $QTDIR в [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# если не требуется установка, то следует просто удалить объектные файлы
# для экономии дискового пространства
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== Что же происходит? ===

Сначала нужно войти в каталог с исходными кодами, принадлежащий пользователю <tt>kde-devel</tt>, (строка 1) и скачать исходный код из репозитория KDE, используя svn (строка 2). Затем перейти в каталог {{path|qt-copy}} (строка 3) и запустить скрипт, устанавливающий патчи, скачанные вместе с <tt>qt-copy</tt> (строка 4).

После установки патчей следует настроить параметры сборки с помощью скрипта <tt>configure</tt> (строки 5-6). Объяснение различных опций (параметров к ./configure) можно найти в файле {{path|qt-copy/README.qt-copy}}. Наконец, осуществляется сборка (строка 7). Примеры и демонстрационные приложения можно собрать отдельно.

Обратите внимание, что установка не требует прав суперпользователя, так как Qt устанавливается локально в {{path|$QTDIR}}. В любом случае установка требуется, только если {{path|$QTDIR}} отличается от {{path|$HOME/qt-copy}}, что не имеет значения, если чётко придерживаться приведённых инструкций.

=== Устранение неполадок ===

Если появляется ошибка «X11/Xlib.h: No such file or directory», то следует установить пакет <tt>xorg</tt> (название в различных системах может незначительно различаться, например, в Kubuntu этот пакет называется <tt>xorg-dev</tt>)

Если во время конфигурирования появляется ошибка, связанная с отсутствием определений (missing defines), нужно проверить значение <tt>$QMAKESPEC</tt>. Некоторые дистрибутивы настраивают переменную так, чтобы она указывала на установленный системой Qt. Если <tt>unset QMAKESPEC</tt> решает проблему, то это следует прописать в скрипт <tt>~/.bashrc</tt>

Ошибка «.pch/debug-shared/QtCore» связана с тем, что Qt-4.3 разрешает системе использование прекомпилированных заголовочных файлов, если gcc поддерживает их, но по неизвестной причине это не работает. При использовании distcc нужно сконфигурировать qt с параметром -no-pch. При использовании icecream следует обновить приложение через svn.

Попробуйте запустить любую Qt-программу, например, {{program|assistant}}. '''Учтите:''' может потребоваться запуск <tt>xhost +local:kde-devel</tt> от имени обычного пользователя kde3 для запуска этого приложения. Если оно падает на QSpanData::adjustSpanMethods, то проблема связана со стилем oxygen. Для решения проблемы следует удалить {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} и {{path|lib/kde4/plugins/styles/oxygen.so}}, если они находятся в префиксе установки KDE (KDE install prefix).

== HAL ==
{{tip|Чтобы проверить, установлен ли org.freedesktop.hal, можно использовать qdbusviewer. Если его нет, то нужна более свежая версия hal. Если org.freedesktop.hal всё же есть, то наверняка вам не нужно и ''не захочется'' переустанавливать hal. }}

Если вам требуется собрать новую версию HAL, то велик шанс, что потребуется собрать некоторое другое ПО, что может оказаться непростой задачей. Так как это касается только старых дистрибутивов, инструкции вынесены в [[Getting_Started/Build/HAL| отдельную статью]]

== kdesupport ==

{{warning|Не забудьте сперва ознакомиться со статьёй [[Getting_Started/Build/KDE4#Setting_up_the_environment|Настройка окружения]].}}

Есть несколько библиотек, требуемых модулем kdesupport: Strigi и Soprano нужны для метаданных файлов (file metadata) и поиска, QImageBlitz используется kdebase для обработки изображений, eigen - для визуальных эффектов в таких приложениях, как Kalzium, taglib - для музыкальных проигрывателей, и qca - для выполнения некоторых криптографических задач.

Strigi имеет несколько своих зависимостей: для установки понадобятся библиотеки и заголовки libz, libbz2, openssl (libcrypto или libssl), libclucene (>=0.9.16a; заметьте, версия 0.9.17 '''не работает''') и libxml2 ( либо libexpat).

Учтите, что если Вы используете openSUSE, то все необходимые пакеты можно установить из репозитория KDE:KDE4 buildservice и не возиться с приведёнными ниже инструкциями. Продолжите с раздела kdelibs.

=== Инструкция ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Что же происходит? ===
Сначала нужно войти в каталог с исходными кодами (строка 1). Затем скачать с помощью svn исходный код kdesupport (строка 2), войти в созданный каталог {{path|~/kde/src/kdesupport}} (строка 3) и начать сборку (строка 4). По окончании будет выполнен вход в каталог <tt>kdesupport</tt>.

=== Устранение неполадок ===
При возникновении ошибки
cmakekde: command not found
следует вручную запустить команду cmake внутри каталога kdesupport. Если это не помогло, то ошибку надо искать в bashrc.

При возникновении ошибки
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
следует установить пакеты разработки libxml2.

При возникновении ошибки
CMake Error: Could NOT find REDLAND
нужно поставить librdf из Redland.
Если в дистрибутив не включён пакет librdf, его можно загрузить с [http://download.librdf.org/source/ http://download.librdf.org/source/] и установить.
((Пользователям Gentoo: сборочный файл для librdf - dev-libs/redland).

При возникновении ошибки
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
см. статью [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Работа с Subversion-репозиторием KDE]

При возникновении ошибки
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.

make: *** [install] Error 255
следует проверить корректность путей, прописанных в файле .bashrc ($QTDIR и $PATH используются для нахождения каталога установки Qt). Также подобная ошибка может возникать при использовании уже установленной в системе версии qt4 (и пропуске раздела об установке Qt). Либо установите qt-copy, либо выполните "sudo make install". После "sudo make install" следует сменить владельца на вас для некоторых подкаталогов ~/kde, измененённых при использовании sudo (например, "sudo chown -R kde-devel:kde-devel ~/kde").

При получении ошибки, похожей на:
target libQtTest.so not found
Вам необходимо пересобрать qt-copy, используя при конфигурации
-nomake demos -nomake examples
чтобы получить QtTest.

== kdelibs ==

Теперь можно приступить к сборке основных библиотек KDE

=== Инструкция ===

cd
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; перейдите по ссылке, чтобы узнать больше]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Что же происходит? ===

Сначала мы входим в каталог с исходными кодами (строка 1) и создаём каталог KDE, сразу же входя в него (строка 2). Затем с помощью subversion загружаются текущие исходники kdelibs (строка 3). Входим в появившийся каталог {{path|~/kde/src/KDE/kdelibs}} (строка 4) и запускаем сборку (строка 5). По окончании будет выполнен вход в каталог сборки <tt>kdelibs</tt>.

{{tip|В вашей системе могут отсутствовать некоторые заголовочные файлы и/или соответствующие им библиотеки. Конкретные список неудовлетворённых зависимостей можно найти в выводе <tt>cmakekde</tt>. Перед сборкой компонентов KDE можно предварительно выполнить <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt>.)}}

=== Дополнительные модули CMake для KDE ===
В {{path|kdelibs/cmake/modules/}} находятся дополнительные модули CMake, необходимые для сборки приложений из KDE4. Они будут автоматически установлены после инсталляции kdelibs.

=== Устранение неполадок ===
При наличии проблем во время сборки kdelibs в первую очередь необходимо проверить наличие и работоспособность [[Getting_Started/Build/KDE4#Required_Software|необходимого программного обеспечения]]. Другие рекомендации по устранению неполадок:
* Если <tt>cmakekde</tt> завершается сообщая, о том, что требуется выходной каталог для сборки (CMake requires an out of source build directory), нужно удалить
{{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}} и перезапуситить сборку.

Если эта же ошибка <tt>cmakekde</tt> опять повторяется, можно попробовать исправить её так:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* При получении ошибки «Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.» следует перейти в директорию сборки до запуска cmakekde (например, <tt>cs KDE/kdelibs && cb && cmakekde</tt>). Если ошибка повторилась, запустите 'svn status' в каталоге kdelibs и удалите все файлы, помеченные '?'.
* Если не найден Qt, или найдена его неподдерживаемая версия, убедитесь, что qmake от нужной версии Qt является первым в PATH.
* Если не найден qmake и Вы используете пакеты Debian, то, возможно, что /usr/bin/qmake указывает не та ту версию qmake. Чтобы это исправить выполните из-под рута:
update-alternatives --config qmake
* Если ошибка продолжает появляться, можно попробовать запустить CMake c опцией <tt>--keep-going</tt>.
* Ошибка «<tt>Could NOT find GIF</tt>» означает, что нужно установить библиотеку libungif.
* Изменение настроек Qt-4.3: при получении ошибки компоновки kjsembed, связанной с QScriptEngine, отредактируйте CMakeCache.txt в kdelibs: удалите строки, в которых есть QT_QTUITOOLS_LIBRARY, а затем снова выполните make (эта статическая библиотека имеет новую зависимость, в результате чего выполняется код cmake, который её обрабатывает).
* При получении ошибки <code>CMake Error: KDE Requires Qt to be built with SSL support
</code> следует установить пакет openssl-devel, удалить файл CMakeCache.txt и пересобрать Qt.
* Ошибка <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> означает, что Qt скомпилирован без поддержки Qt3 (компоновка с установленным Qt3 не сработает)

== kdepimlibs ==

После установки <tt>kdelibs</tt> и перед сборкой ''kdebase'' следует установить ''kdepimlibs''.

=== Инструкция ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Что же происходит? ===
Нужно перейти в каталог с исходными кодами KDE (строка 1), скачать исходники kdepimlibs с помощью subversion (строка 2) и потом перейти в появившийся каталог {{path|~/kde/src/KDE/kdepimlibs}} (строка 3). Затем запустить сборку (строка 4). По окончании будет выполнен вход в каталог сборки <tt>kdepimlibs</tt>.

=== Устранение неполадок ===

При наличии проблем компиляции kdepimlibs:
* Утилита cmakekde может требовать более позднюю версию библиотеки gpgme. Она доступна на сайте
http://www.gnupg.org/(en)/download/index.html - учтите, что для сборки gpgme также потребуется libgpg-error, доступная на том же сайте. Обе библиотеки устанавливаются с помощью "./configure" (для gpgme следует выполнить с параметром -with-gpg-error-prefix), "make" и "sudo make install". Может потребоваться перезаписать уже существующий файл "/usr/bin/gpgme-config" для более новой версии, чтобы kdepimlibs нашёл более новую версию библиотеки.
* При получении от /usr/bin/ld ошибки «cannot find -lpth» удостоверьтесь, что в вашей системе есть GNU Portable Threads (libpth-dev в Debian).
* Ошибка «cannot find -lpth», сгенерированная /usr/bin/ld, может быть связана с отсутствием GNU Portable Threads (libpth-dev в Debian).
== kdebase ==

kdebase состоит из трёх частей:
* '''apps (приложения)'''
:Эта часть содержит приложения, например Dolphin и KWrite.
* '''runtime (среда выполнения)'''
:Содержит всё необходимое для приложений во время исполнения (например, значки). Эта часть необходима для работы любого приложения KDE, поэтому её необходимо обязательно собрать и установить.
* '''workspace (рабочая среда)'''
:Включает в себя ПО, специфичное для KDE, например Plasma и оконный менеджер. Большая часть зависит от X11. Требуется только для того, чтобы собрать полный рабочий стол KDE.

=== Инструкция ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Устранение неполадок ===

При наличии проблем компиляции kdebase:
* Проверьте наличие заголовочных файлов <tt>libxss headers</tt>. (Обычно появляется ошибка «undefined references on xscreensaver objects», связанная с отсутствием заголовков для данной библиотеки).
* Команда <tt>which meinproc</tt> должна возвращать {{path|/home/kde-devel/kde/bin/meinproc}}
* Если cmakekde не находит kdepimlibs, отредактируйте файл {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}}, вручную прописав <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* При получении ошибки «Please set the following variables: X11_XTest_LIB (ADVANCED)» установите пакеты разработки для <tt>Xtst</tt>. В некоторых системах этот пакет отделён от <tt>xext</tt> и называется <tt>x11proto-xext-dev</tt> или <tt>libxtst-dev</tt>. Также может потребоваться удалить CMakeCache.txt в каталоге сборке после установки пакета.
* То же самое касается и «X11_Xinerama_LIB (ADVANCED)», но в данном случае следует установить пакет разработки для <tt>xinerama</tt>.
* При наличии ошибки, связанной с отсутствием X11_Xrandr_LIB, нужно установить пакет разработки для libxrandr (libxrandr-devel в дистрибутивах Ubuntu)
* Если появляется ошибка «Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)», нужно установить заголовочные файлы libfontconfig.
* При наличии ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES» следует установить soprano из kdesupport и пересобрать kdelibs.
* При получении ошибки «‘XserverRegion’ does not name a type» удостоверьтесь, что установлены заголовочные файлы libxcomposite (<tt>libxcomposite-dev</tt> в Ubuntu).
* Для устранения ошибки «CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) » попробуйте отредактировать CMakeCache.txt и переменную QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so
* Получив ошибку «KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK», либо найдите файлы, содержащие строку, вызывающую ошибку, и закомментируйте её вручную, либо из каталога ~/kde/src/KDE/kdebase запустите скрипт
[http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. Он удалит строки, содержащие «kde4_create_handbook» из всех файлов, в которых они встречаются.
* При получении ошибки (в Ubuntu), связанной с libxtst.so, установите пакет libxtst-dev.
* При получении сообщения «"kdebase/workspace/kcontrol/kxkb/x11helper.cpp:131: error: ‘KGlobal’ has not been declared», возможно, требуется установить пакеты разработки libxklavier.
== Запуск приложений KDE 4 ==
Теперь вы можете запускать приложения KDE 4 (например, kwrite), напечатав:

ssh -X kde-devel@localhost
kwrite

=== Устранение неполадок ===
* Если появляется сообщение
«KUniqueApplication: Cannot find the D-Bus session server»,
проверьте, есть ли у вас боступ к дисплею, например, напечатав
xclock
Проверьте, появятся ли часы на экране.

* При получение ошибки, похожей на
Error: standard icon theme "oxygen" not found!

ASSERT: "!isEmpty()" in file /home/kde-devel/qt-copy/include/QtCore/../../src/corelib/tools/qlist.h, line 245
Aborted (core dumped),
необходимо установить kdebase (см. выше). Достаточно установить каталог "runtime" из kdebase.

== Получение локальной документации по API ==
Хотя документация по API KDE доступна на [http://api.kde.org api.kde.org], иногда удобно иметь её на своём компьютере, например, чтобы использовать [[Getting_Started/Set_up_KDE_4_for_development_(ru)#KDevelop|KDevelop]] для просмотра документации, или если невозможно постоянно находиться в сети.

Учтите, что загрузка документации по API может занять несколько часов, а сама документации занимает почти полгигабайта дискового пространства.

=== Инструкция ===

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Повторите для всех модулей: 
cd <имя модуля>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Другой и, наверное, более простой способ, - загрузить [[Doxyfile]]. Затем перейти в каталог, куда следует поместить документацию и выполнить команду:

<code bash>
% doxygen /path/to/Doxyfile
</code>
Затем проверить содержимое файла {{path|doxygen.log}} на наличие ошибок и предупреждений. Документация будет установлена в подкаталог {{path|apidocs}}

== Не забывайте обновляться ==

Чтобы иметь последние обновления kde4, нужно периодически обновлять все установленные модули. Так как понедельник - день внесения множества изменений в kdelibs, то вторник является лучшим днём для этого. Для каждого модуля следует выполнить <tt>svn up</tt> и <tt>make</tt>.

Например:
<code bash>
cs kdesupport # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' является функцией bash; пройдите по ссылке, чтобы узнать больше]]
svn up
cb # cb - не опечатка
make -j2 VERBOSE=1 && make install
</code>

==Частичная установка модулей (установка отдельных приложений) ==

Многие модули KDE4 включают в себя огромное число приложений, поэтому для установки всего модуля может потребоваться много времени, чтобы всё скачать и собрать. В случае, если нужно всего несколько определённых приложений из состава модуля, возможно скачивать и компилировать только отдельные каталоги. В некоторых случаях, для сборки любого приложения необходимо иметь несколько "главных" каталогов. Они задаются в файле CMakeLists.txt каждого модуля. Например, в [http://websvn.kde.org/trunk/KDE/kdegames/CMakeLists.txt?view=markup kdegames CMakeLists.txt файле для kdegames перечислены:]

<code>
add_subdirectory(libkdegames)
add_subdirectory(libkmahjongg)

macro_optional_add_subdirectory(doc)
macro_optional_add_subdirectory(lskat)
macro_optional_add_subdirectory(katomic)
</code>

Таким образом, каталоги libkdegames и libkmahjongg необходимы для сборки любого приложения из kdegames. Обычно также необходим каталог cmake. Ниже приведён пример сборки kmahjongg и kbattleship:

<code bash>
cs KDE
svn co -N kdegames # The -N switch performs a non-recursive checkout
cd kdegames
svn up libkdegames # Get required directories
svn up libkmahjongg
svn up cmake
svn up kbattleship # Get optional directories
svn up kmahjongg
cmakekde
</code>

== Общий способ устранения неполадок ==

С течением времени, после нескольких выполнений команды <tt>svn up</tt> может оказаться, что некоторые утилиты, используемые в системе сборки KDE, изменили формат вывода. Например, файлы <tt>kcfg</tt> используются <tt>kconfig_compiler</tt> для создания конфигурационных диалогов. CMake не в состоянии отследить подобные изменения, что приводит к сбою компиляции. Обходной путь - использование приндительного обновления всех подобных файлов:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
То же самое касается <tt>ui</tt>-файлов, созданных Qt Designer.

=== Заблокированный сеанс ===
При установке KDE 4 в качестве пользователя нельзя будет разблокировать заблокированную сессию. Чтобы решить эту проблему необходимо:
su
su chown root.root $KDEDIR/lib/kde4/libexec/kcheckpass
или
chmod 755 $KDEDIR/lib/kde4/libexec/kcheckpass

Помимо этого необходимо добавить в каталог /etc/pam.d/ службу "kde".

Пример для дистрибутивов, основанных на RH/Fedora:
<code>
#%PAM-1.0
auth include system-auth
account include system-auth
password include system-auth
session include system-auth
</code>

== Готово! ==

Теперь Вы готовы к сборке других модулей из svn (выполняется абсолютно аналогично), запуску и тестированию KDE4 или написанию собственных патчей и приложений.

Чтобы узнать, как запускать приложения KDE4 и использовать KDevelop для работы с ними, см. обзор [[Getting Started/Set up KDE 4 for development_(ru)|Подготовка KDE4 для разработки]]

[[Category:Build KDE]]
[[Category:KDE4]]