Members of the KDE Community are recommended to subscribe to the kde-community mailing list at https://mail.kde.org/mailman/listinfo/kde-community to allow them to participate in important discussions and receive other important announcements

INSTALL 2.22 KB
Newer Older
Michael Reeves's avatar
Michael Reeves committed
1 2
Building KDiff3 requires the fallowing minimium versions:
 1)Qt 5.6 or later
Michael Reeves's avatar
Michael Reeves committed
3
 2)KF5 5.27+
Michael Reeves's avatar
Michael Reeves committed
4 5 6 7
 3)CMake 3.1
 4)ECM 1.8
 Support compilers:
 5)MSVC 2015+, gcc 5.0+, clang 3.3+
Michael Reeves's avatar
Michael Reeves committed
8

Michael Reeves's avatar
Michael Reeves committed
9
*nix:
Michael Reeves's avatar
Michael Reeves committed
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

On debian based systems you needed to install the fallowing.
gettext, qtbase5-dev, extra-cmake-modules libkf5i18n-dev, libkf5coreaddons-dev, libkf5iconthemes-dev libkf5parts-dev, libkf5doctools-dev, libkf5crash-dev, cmake, (gcc or clang)
These should aviable as part of the standard repos.
To build KDiff3 run:
  cmake && make
  sudo make install
cmake will automacticly verify that the requirements are met before attempting to build.

Windows:

For windows the build should be done via. craft. Although other methods may work they are not
tested.

Craft requires python 3.6 or later to be installed it can be downloaded here:
https://www.python.org/downloads/windows/
This should be automacticly installed by craft.

You will also need to start a power shell envirionment as administrator instruction for that are at:
https://docs.microsoft.com/en-us/powershell/scripting/getting-started/starting-windows-powershell?view=powershell-6

On windows 10 this will be the default shell.
Run the fallowing.
1)Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
2)iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/KDE/craft/master/setup/install_craft.ps1'))

Michael Reeves's avatar
Michael Reeves committed
36
You may also have to exempt your craft directory from virus scans as these can interefer with the build process.
Michael Reeves's avatar
Michael Reeves committed
37 38 39 40

1)cd to your craft root
Run:
2)C:\CraftRoot\craft\craftenv.ps1
Michael Reeves's avatar
Michael Reeves committed
41 42
3)craft png2ico
4)craft kdiff3
43 44 45 46 47
If you what to build 1.8x than use:
4) craft --target 1.8 kdiff3

Otherwise craft will use master which is the developement branch and therefor more likely to experiance breakage.

Michael Reeves's avatar
Michael Reeves committed
48
At this point you can run kdiff3 itself via the following:
49 50 51 52
cb kdiff3
bin/kdiff3

If you want to create an install package you would run:
Michael Reeves's avatar
Michael Reeves committed
53 54
5)craft nsis

55
6)craft --package kdiff3 or craft --target 1.8 --package kdiff3
Michael Reeves's avatar
Michael Reeves committed
56

Michael Reeves's avatar
Michael Reeves committed
57
This will be a time consuming process on first run as craft will have to download all dependencies.
58
KDiff3 does not require special configuration for craft. 
Michael Reeves's avatar
Michael Reeves committed
59

Michael Reeves's avatar
Michael Reeves committed
60
There should be an installer package generated in CraftRoot/tmp
Michael Reeves's avatar
Michael Reeves committed
61

Michael Reeves's avatar
Michael Reeves committed
62
Please contact kde-windows@kde.org before filing a bug report regarding this process.