← Guidelines and HOWTOs/Build from source/Windows You do not have permission to edit this page, for the following reason: The action you have requested is limited to users in one of the groups: Users, Administrators, trusted, KDEDevelopers. You can view and copy the source of this page. ''Craft'' is a tool to build the sources and its third-party requirements. It is the '''easy''' way to build software. == Setting up craft == == Installing python?== While Craft is capable of installing a embedded Python version we recommend to install Python yourself. The embedded version is completely sufficient for most packages, some may require a full installation of Python. [https://www.python.org/downloads/ Download Python 3.6+] === Setting up a powershell === Powershell is required to be at least version 3.0. You can check the version with $PSVersionTable.PSVersion . === 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 as administrator. * Allow execution of powershell scripts. Set-ExecutionPolicy RemoteSigned * Exit the administrator powershell instance. * Start a powershell environment as a user. * 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\kdeenv.ps1 This tells Craft 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 Craft will not work as expected. The output should look similar to this one (of course with your paths): PS C:\kderoot\craft>.\kdeenv.ps1 KDEROOT : C:\kderoot\ KDECOMPILER : msvc2015 KDESVNDIR : C:\kderoot\download\svn KDEGITDIR : C:\kderoot\download\git DOWNLOADDIR : C:\kderoot\download PYTHONPATH : C:\kderoot\python PS C:\kderoot\> === Common Craft commands === * '''Installing a package and its dependencies''': Simply run <syntaxhighlight lang="text">craft packagename</syntaxhighlight> * '''Updating an installed package''': Once you have ''packagename'' built, type <syntaxhighlight lang="text">craft -i packagename</syntaxhighlight> to update <tt>packagename</tt>. == Troubleshooting == If a package fails to build, you'll be greeted with something like: ... craft warning: while running make cmd: jom craft warning: Action: compile for libs/qt5/qtbase FAILED *** Craft all failed: all of libs/qtbase failed after 0:07:25 *** craft error: fatal error: package libs/qtbase all failed In order to figure out ''what'' failed, grep the command line output ''above'' for errors. Or have a look at the log file located in <tt> %USERPROFILE%\.craft</tt> which will contain much more details. Search for "error", or "error:" in the file. Return to Guidelines and HOWTOs/Build from source/Windows. Retrieved from "https://community.kde.org/Guidelines_and_HOWTOs/Build_from_source/Windows"