View source for Getting Started/Using Project Neon to contribute to KDE (ru)



{{Note | Project Neon can help you with builds current as of February 2011}}

[https://launchpad.net/project-neon Project Neon] — ночные сборки разрабатываемых версий программных пакетов KDE (из trunk). Это простой способ для новых участников разработки KDE, чтобы начать работу без необходимости собирать всё дерево KDE-SVN и обновлять рабочую копию из репозитория. Кроме того, зависимости автоматически устанавливаются и обновляются. Это подходит для новых разработчиков, переводчиков, дизайнеров пользовательского интерфейса, авторов документации, людей, занимающихся продвижением KDE, сортировщиков отчётов об ошибках и других. Этот процесс снимает необходимость выполнения шагов, описанных на [[Getting_Started/Build/KDE4|этой странице]], в том числе необходимость редактирования файла [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]].

However, for developers, it may at some point become necessary to build more components from SVN as you become more involved in the project. The [[Getting_Started/Build/kdesvn-build|kdesrc-build]] script is an easy way to build all or parts of KDE SVN.

== Требования ==

Project neon always requires the latest stable Kubuntu release or development release. Previous versions of Kubuntu are not supported. 

== Установка Project Neon ==

Чтобы использовать Project Neon, добавьте следующий PPA (Personal Package Archive) в файл <tt>sources.list</tt> любым способом:

<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:neon/ppa
</syntaxhighlight>
или
<syntaxhighlight lang="bash">
# Project neon nightly KDE4 build
deb http://ppa.launchpad.net/neon/ppa/ubuntu maverick main

#above repository is PGP signed, refer to below link for getting PGP key
https://launchpad.net/~neon/+archive/ppa
</syntaxhighlight>

After that, you can simply install the nightly package of whichever modules you want to work on. The Packages are named project-neon-<git/svn module name>.

You can install all of the packages or just the ones you are interested in, depending on what you want to use them for. For example if you want to install the KDE Workspace with the extra plasmoids, you would install the <tt>project-neon-kdeplasma-addons</tt> and <tt>project-neon-session</tt> so you get KDM support for Project Neon.

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdeplasma-addons project-neon-session
</syntaxhighlight>

If you are only interested in application development in another module, you can install just the module package.

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdepim project-neon-common
</syntaxhighlight>

That command will also install the <tt>kdelibs</tt>, <tt>kdepimlibs</tt> and other dependencies too. In your regular (stable) KDE session you can then run the nightly version of your chosen application after setting up the environment.

<syntaxhighlight lang="bash">
. /opt/project-neon/share/project-neon/environment.rc
kmail
</syntaxhighlight>

Instead of sourcing the settings by hand every time, you could add this to your .bashrc:

<syntaxhighlight lang="bash">
switchtonightly ()
{
  . /opt/project-neon/share/project-neon/environment.rc
}
</syntaxhighlight>

or use <tt>neon-env</tt> (see below), but you can't run non-Project Neon apps when you use neon-env.

You'll need to close the terminal session for the settings to be undone.

This will correctly use the nightly version of libraries instead of using the stable versions, so no other changes are necessary to your library path etc.

Note that settings for applications that you run from project neon do not conflict with your regular application settings and data. <tt>.project-neon-kde/</tt> is used instead of <tt>.kde/</tt>

== Using Project Neon for development ==

If you are joining one of the development teams in KDE, you will need a real SVN/GIT checkout in order to contribute your code back to the project and create patches easily.

Some extra tools are provided for this purpose in the package <tt>project-neon-utils</tt>:

NOTE: both neon-cmake and neonmake require neon-env to be run first!

<tt>neon-env</tt> -
sets up the necessary environment settings for project neon builds and opens a subshell.

<tt>neon-cmake</tt> -
cmake wrapper with neon environment settings for cmake, same synopsis as cmake and passes arguments to cmake

<tt>neonmake</tt> -
convenience script which will create a build folder, configure the source, build it and install it in /opt/project-neon/ so you can test your changes.

<tt>neon-clean</tt> -
This script will reset all changes you did to /opt/project-neon after installing the packages. Since this script reinstalls the packages it might require a working internet connection.



You can change the cmake and make options used by setting these variables in ~/.neonrc:

<tt>NEON_CMAKE_OPTS=""</tt> Here you can add additional cmake options that should be used together with the default neon options.

<tt>NEON_CMAKE_OVERRIDE=""</tt> If you set this variable cmake will ignore the default neon options and only use the ones in NEON_CMAKE_OVERRIDE.

<tt>NEON_MAKE_OVERRIDE=""</tt> If you set this variable make in neonmake will only use your options. By default make uses '-j CPUs+1'



Debugging Symbols:
The debugging symbols for every package are in it's corresponding -dbg package, so to install the debugging symbols for kdelibs you can use
<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdelibs-dbg
</syntaxhighlight>

If you are already using a nightly package of the module you want to develop for, you should remove that, and checkout the development version. For example:

<syntaxhighlight lang="bash">
# Remove the packaged nightly version
sudo apt-get purge project-neon-kdepim

# Add below Project Neon source code repository to sources.list if you didn't use add-apt-repository
deb-src http://ppa.launchpad.net/neon/ppa/ubuntu maverick main

# Get the dependencies for building kdepim
sudo apt-get build-dep project-neon-kdepim
cd ~
# You may choose to do your development in a different folder.
cd Development
# Gets the latest version of the kdepim module.
git clone git://anongit.kde.org/kdepim
cd kdepim
# Set up neon environment
neon-env
# Shortcut provided by Project Neon to make the module
# and install it to the prefix /opt/project-neon/
neonmake
</syntaxhighlight>

Note that you should usually checkout a module from KDE, not an application. Most modules contain libraries shared within the module and which are necessary to build the applications in the module.

Also note that when using apt-get build-dep it will always get all build-depends, so watch out that it doesn't install a component you want to build yourself as that would overwrite your changes should you install the packages after installing your build. 


== Using Project Neon for translation ==

The Project Neon nightly packages include English language strings only. Translated packages are not available. However, if you are translating KDE applications, you can install the translations from KDE SVN in your normal workflow.

<syntaxhighlight lang="bash">
cd ~
cd Translations
# The -N switch checks out only the top level directory from svn.
svn co -N svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4
cd l10n-kde4
# scripts necessary to build translations.
svn up scripts
# Get the German translations
svn up de
# Generate the build files for the German language pack
./scripts/autogen.sh de
cd de
neon-env
neonmake
</syntaxhighlight>

After building the translations it is possible to either change the language in system settings, or run applications in another language using the environment variable <tt>KDE_LANG</tt>.

<syntaxhighlight lang="bash">
switchtonightly # or neon-env
KDE_LANG=de kmail
</syntaxhighlight>

exit the shell to reset the settings.

== Using Project Neon for documentation ==

The Project Neon nightly source packages include the official KDE User Documentation in English.

TODO: How to build user docs from SVN.

== Using Project Neon for promotion ==

If you are creating screenshots or screencasts of the latest version of KDE, project Neon is a simple and fast way of getting a default KDE4 session.

The KDE Promotion team recommends using the default background, theme, icons etc when preparing official promotional materials (unless the feature you are showing is related to configuring KDE artwork). Project Neon uses the default artwork that comes with KDE4, so it is useful for creating promo materials.

Here is a shortcut to get all available modules from the PPA:

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-all
</syntaxhighlight>

The application [http://ariya.blogspot.com/2008/06/creating-fancy-screenshots-with.html screenie] is provided since Kubuntu 8.10 as <tt>screenie-qt</tt>.

<syntaxhighlight lang="bash">
sudo apt-get install screenie-qt
</syntaxhighlight>

== Contact the Team ==

You can reach the Project Neon team on IRC in 
<syntaxhighlight lang="text">
#project-neon on irc.freenode.net
</syntaxhighlight>
by mail at 
<syntaxhighlight lang="text">
neon@lists.launchpad.net
</syntaxhighlight>
or you can ask a question on [https://answers.launchpad.net/project-neon launchpad]

If you think there is a bug in our packaging of the provided software you can file a bug on [https://bugs.launchpad.net/project-neon launchpad]

[https://wiki.kubuntu.org/Kubuntu/ProjectNeon Team page in the Kubuntu Wiki]