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

From KDE Community Wiki
m (→‎Using emerge: commas)
(Redirect to https://community.kde.org/Get_Involved/development/Windows)
Tag: New redirect
 
(70 intermediate revisions by 21 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.
#REDIRECT [[Get_Involved/development/Windows]]
 
== Setting up emerge ==
=== Setting up a compiler ===
Currently emerge supports both the MinGW and Microsoft Visual Studio (msvc) compiler.
While MinGW is can be installed by emerge, [https://www.visualstudio.com/ Visual Studio] must be installed independently by the user.
 
=== Direct X SDK ===
In order to compile the Qt5 ''qtbase'' package with MinGW you will also need to install the [https://www.microsoft.com/en-us/download/details.aspx?id=6812 Microsoft DirectX SDK], make sure to open a new command line window after the installation.
 
=== Installing Emerge ===
* Start a powershell environment as administrator.
* Allow execution of powershell scripts.
  Set-ExecutionPolicy RemoteSigned
* Exit the administrator powershell instance.
* Start a powershell environment as a user.
* Install emerge and folow the instructions
iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/KDE/emerge/master/setup/install_emerge.ps1'))
 
== Using emerge ==
To use emerge you need to start a Powershell window, point that to <tt>KDEROOT\emerge</tt> and run the initalization script. For example:
 
C:\KDEROOT\emerge\kdeenv.ps1
 
This tells emerge about your environment settings (e.g. paths). It will load your configuration from <tt>KDEROOT\etc\kdesettings.ini</tt>. If there are any error messages emerge will not work as expected. The output should look similar to this one (of course with your paths):
 
PS C:\kderoot\emerge>.\kdeenv.ps1
KDEROOT    : C:\kderoot\emerge
KDECOMPILER : msvc2015
KDESVNDIR  : C:\kderoot\download\svn
KDEGITDIR  : C:\kderoot\download\git
DOWNLOADDIR : C:\kderoot\download
PYTHONPATH  : C:\kderoot\python
PS C:\kderoot\emerge>
 
=== Installing the base system ===
You are now ready to start building KDE. It is recommended to do so progressively, relying on emerge to automatically resolve the required dependencies at each set step:
 
* Enter <tt>emerge qt5</tt>.  This will fetch and install Windows versions of numerous UNIX-like utilities and libraries, then checkout, compile, and install Qt.  This will take up to several hours.
* Enter <tt>emerge frameworks</tt>.  This will checkout, compile, and install the kde frameworks 5 modules.
 
You will now have successfully installed a base KDE system and can now install other KDE modules as required.
 
Every time you want to update or install a package you should first update your emerge checkout (simply run
cd C:\kderoot\emerge
git pull
to ensure you are using the latest package recipes.
 
=== Common emerge commands ===
* '''Installing a package and its dependencies''': Simply run <syntaxhighlight lang="text">emerge packagename</syntaxhighlight>
* '''Updating an installed package''': Once you have ''packagename'' built, type <syntaxhighlight lang="text">emerge -i packagename</syntaxhighlight> to update <tt>packagename</tt>.

Latest revision as of 18:53, 7 September 2022