Guidelines and HOWTOs/Build from source/Windows: Difference between revisions

From KDE Community Wiki
(fix svn uri)
(note about using alternative checkout program and issues that come when checked-out sources use UNIX line endings)
Line 1: Line 1:
emerge / emerge.py is a tool to build the kde sources and its third party requirements on MS Windows.  
emerge / emerge.py is a tool to build the kde sources and its third party requirements on MS Windows.  


To start an emerge based install, checkout the sources from the svn-directory of emerge with the following command:  
To start an emerge based install, checkout the sources from the svn-directory of emerge into a new directory, which we will call '''kderoot'''.
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>  
 
into a new kderoot directory. Copy the file '''kdesettings-environment.bat''' into the folder '''kderoot\etc''', rename it to '''kdesettings.bat''' and change it according to your needs.
This can be accomplished 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.
Copy the file '''kdesettings-environment.bat''' into the folder '''kderoot\etc''', rename it to '''kdesettings.bat''' and change it according to your needs.


You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>
You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Revision as of 09:06, 24 October 2007

emerge / emerge.py is a tool to build the kde sources and its third party requirements on MS Windows.

To start an emerge based install, checkout the sources from the svn-directory of emerge into a new directory, which we will call kderoot.

This can be accomplished with the following command:

svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge

Alternatively, you can checkout the sources using a program like 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.

Copy the file kdesettings-environment.bat into the folder kderoot\etc, rename it to kdesettings.bat and change it according to your needs.

You can get 'some' help if you run:

C:\kderoot\emerge\bin>emerge --help

Below the directory kderoot\emerge\portage you have the categories as subdirectories which contain individual packages.

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.

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. To use emerge with the installer, you have to change the directory_layout in the kdesettings.bat to installer (see that file for more detailed information).