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

From KDE Community Wiki
(Redirect to https://community.kde.org/Get_Involved/development/Windows)
Tag: New redirect
 
(45 intermediate revisions by 16 users not shown)
Line 1: Line 1:
''Craft'' is a tool to build the sources and its third-party requirements. It is the '''easy''' way to build software.
#REDIRECT [[Get_Involved/development/Windows]]
 
== Setting up craft ==
=== Installing python ===
While Craft is capable of installing a embedded Python version sufficient for most packages, we recommend a full installation of Python. The current version is 3.6. [https://www.python.org/downloads/ Download Python 3.6+]
 
=== Setting up a powershell ===
Powershell is required to be at least version 5.0.
If you're running Windows 10 you most probably won't need to update Powershell.
 
You can check the version with <tt>$PSVersionTable.PSVersion</tt> .
 
[https://www.microsoft.com/en-us/download/details.aspx?id=50395 Download Powershell]
 
=== Setting up a compiler ===
Currently Craft supports both the MinGW and Microsoft Visual Studio (msvc) compiler.
While MinGW can be installed by Craft, [https://www.visualstudio.com/ Visual Studio] must be installed independently by the user.
 
=== Direct X SDK ===
If you are using the MinGW compiler, in order to compile the Qt5 ''qtbase'' package 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 for the environment variables to be set.
 
=== Installing Craft===
* Start a powershell environment.
* Allow execution of powershell scripts.
  Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
* Install Craft and folow the instructions
iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/KDE/craft/master/setup/install_craft.ps1'))
 
== Using Craft ==
To use Craft you need to start a Powershell window, point that to <tt>KDEROOT\craft </tt> and run the initalization script. For example:
 
C:\KDEROOT\craft\craftenv.ps1
 
This tells Craft about your environment settings (e.g. paths). It will load your configuration from <tt>CraftRoot\etc\CraftSettings.ini</tt>. If there are any error messages Craft will not work as expected. The output should look similar to this one (of course with your paths):
 
PS C:\kderoot\craft>.\craftenv.ps1
Craft Root          : C:\CraftRoot
Craft              : R:\
Version            : master
ABI                : windows-msvc2017_64-cl
Svn directory      : C:\CraftRoot\download\svn
Git directory      : Q:\
Download directory  : C:\CraftRoot\download
 
==Using Craft with Qt Creator==
To compile from within Qt Creator, I need to set up a kit.
This is an example for mingw64.
* Add a cmake if none is set: R:\dev-utils\cmake\bin\cmake.exe
* Add a debugger: R:\mingw64\bin\gdb.exe
* Add a C++ compiler and a C compiler. Both: R:\mingw64\bin\gcc.exe
** Ensure that the ABI is correctly set
* Add a Qt: R:\bin\qmake.exe
* Add a kit with all of the above
* Use the kit on a project

Latest revision as of 18:53, 7 September 2022