Difference between revisions of "Getting Started/Build/Windows/emerge"

(Replaced content with "{{Moved To Community|Guidelines and HOWTOs/Build from source/Windows}}")
(228 intermediate revisions by 29 users not shown)
Line 1: Line 1:
emerge is a tool to build the KDE sources and its third party requirements on MS Windows. It is the ''easy'' way to build KDE on MS Windows.
{{Moved To Community|Guidelines and HOWTOs/Build from source/Windows}}
== Set up ==
Create directory in your hard drive's root e.g. C:\kderoot or D:\kderoot (You will need this PATH later)
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].
The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.
Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have  [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>
Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].
Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings.  If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.
After checkout you need to have directory ''kderoot\emerge'' else you can copy your emerge directory to that location.
Create the directory kderoot\etc.  Copy the file '''kderoot\emerge\kdesettings-example.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. 
Then run it.
'''Be sure that you neither have the msys/bin nor the cygwin/bin in your path. If so you have to definitely remove it.'''
=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or one of the Microsoft Compilers (> Visual Studio 2003).
Currently, there is no dependency on the compilers in any of the packages.  So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke.  If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.
If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' (in command line set PATH=%PATH%;path\to\directory) variable or copy the contents of this directory to MinGW's ''bin'' directory.  The prior is preferred.
Everything applies to MS Visual Studio Compilers in a similar manner.
In vista, the mingw directory may need to be moved to c:\ in order to compile properly.
== Running emerge ==
Start a console window and run
Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.
You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help
Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).
To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.
Start with '''emerge qt''' and when that completes successfully, run '''emerge kdelibs'''.
== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.
Then emerge compiles the Qt libraries, this takes hours.
'''emerge ''package'' ''' performs the separate actions <tt>--fetch</tt>, <tt>--unpack</tt>, <tt>--compile</tt>, <tt>--install</tt>, <tt>--manifest</tt>, and <tt>--qmerge</tt>.
== emerge commandline options / emerge settings ==
There are some options that can be used when building with emerge.
{| border="0" cellpadding="2"
|This option augments the verbosity level - currently the highest verbosity level is 3 (<tt>-v -v -v</tt>). A verbosity level of 0 should give no output and equals to <tt>-q</tt>
|This very useful option suppresses copying the sources from the local subversion tree to a directory within the build directory. It shouldn't be used while packaging; in the other cases it reduces the amount of harddisk used though and removes the copying time.
|This option suppresses the update step of the local tree - which needs some time.
You can set all options in the kdesettings.bat file.
== Notes ==
emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).
emerge creates lots of files in '''\kderoot\tmp''' during build.
After a package is successfully installed
(check '''\kderoot\etc\portage\installed'''), you can delete its temporary directory.
emerge is derived from the Gentoo portage system,
that has documentation for the portage format and emerge program.
[[Category:MS Windows]]

Latest revision as of 19:13, 10 March 2016

This page is now on the community wiki.

This page was last edited on 10 March 2016, at 19:13. Content is available under Creative Commons License SA 4.0 unless otherwise noted.