173
177
Install the required libs and tools
174
178
-----------------------------------
175
Install CMake from http://cmake.org/ and allow the installer to create symlinks
176
the to command line tools
178
Install KDE binaries available from http://mac.kde.org/
179
You need at least kdebase-runtime and all its dependencies.
181
Setup the build environment
182
---------------------------
183
These packages install KDE-4 in /opt/kde4, Qt-4 in /opt/qt4 and all the unix
184
dependencies in /opt/kde4-deps. These paths need to become part of your
187
$ export PATH="/opt/qt4/bin:/opt/kde4/bin:/opt/kde4-deps/bin:$PATH"
188
$ export CMAKE_LIBRARY_PATH="/opt/kde4-deps/lib"
189
$ export CMAKE_INCLUDE_PATH="/opt/kde4-deps/include"
190
$ export PKG_CONFIG_PATH="/opt/qt4/lib/"
179
Install MacPorts from http://www.macports.org/
180
Since Mac OS X doesn't ship a compiler by default any more, you have to
181
install Apple's XCode to get gcc. All this is described in the MacPorts
182
Guide at http://guide.macports.org/
184
At the time of this writing MacPorts does not install Qt4 with ssl support
185
by default. A ticket for this is already filed at
186
http://trac.macports.org/ticket/17730
187
For now, you have to install Qt4 manualy with ssl:
188
$ sudo port install qt4-mac +ssl
190
Now you can install KDE-4's libraries and all it's dependencies with a
192
$ sudo port install kdelibs4
194
If you don't want to do all the compiling, you can see if there are recent
195
binaries at http://mac.kde.org/ The kde-4.1.3 release as also build with
192
199
Build Krusader using GNU make
193
200
-----------------------------
241
249
Installation on Windows®
242
250
========================
243
It's the first time that Krusader compiles on Windows®,
244
some work is needs to be done to make it usable on the Windows® platform.
251
Krusader compiles on Windows®,
252
but some development work needs to be done to make it more usable on the Windows® platform.
245
253
All feedback is welcome!
247
- Install the KDE installer http://winkde.org/pub/kde/ports/win32/installer/
248
(tested with version 0.9.2). See also http://windows.kde.org/
249
During install, choose the following option:
250
+ installation path in this example was c:\kde4
255
- Install KDE for Windows with the kdewin-installer from
256
http://winkde.org/pub/kde/ports/win32/installer/
257
We have used kdewin-installer-gui-0.9.3-3.exe
258
See also at http://windows.kde.org/ if needed
260
During the kdewin installation, choose the following options:
261
+ installation path c:\kde4
263
(We have encountered Krusader compile troubles with KDE 4.1.3 ,
264
but AFAIK they are not caused by the Krusader sourcecode)
251
265
+ install mode: developer installation
252
266
+ compiler mode: mingw
253
267
+ select installation of binary and developement files of the following
263
* automoc4 (including the source package - because of the file Automoc4Config.cmake)
264
- at the moment (time of KDE 4.1.x) because of KDE bug (probably) it is necessary
265
to get even the source package and copy files
266
Automoc4Config.cmake, Automoc4Version.cmake and automoc4.files.in
267
(but NOT the file kde4automoc.cpp)
268
to a new directory c:\kde4\lib\automoc4
277
* automoc4 (including the source package - because of a automoc4 bug at this moment)
271
- In order to have the icon in the krusader executable and if the file is not already
272
installed with the package kdewin32 (kdelibs depends on that package), download
273
png2ico (from http://winterdrache.de/freeware/png2ico/) and put
274
png2ico.exe to c:\kde4\bin (If you skip this step, krusader will
275
compile fine it will only miss the application icon )
277
- Create the source directory for krusader and checked out svn
278
(you can use TortoiseSVN for that http://tortoisesvn.net/)
279
In this example, c:/kde4/src/krusader_kde4 was used.
281
- Create the directory for generated files and cd to it
282
In this example, c:/kde4/build/krusader_kde4 was used
284
- Open the windows terminal (cmd.exe) and go to the build directory
280
- When KDE 4.1.2 is installed png2ico.exe should be already installed in c:\kde4\bin
281
In the case that png2ico.exe is not installed, than install it manually in c:\kde4\bin
282
http://winterdrache.de/freeware/png2ico/
283
This programs is needed for icons
284
If png2ico.exe is not installed, Krusader will compile fine but it will miss the application icon.
286
- Download the Krusader sourcecode
287
To download the SVN trunk taball, use the next url in your webbrowser
288
http://krusader.svn.sourceforge.net/viewvc/krusader/trunk.tar.gz?view=tar
290
You can also acces the Krusader SVN repository with TortoiseSVN
291
http://tortoisesvn.net/
293
- Unpack the sourcecode into c:/kde4/src/krusader_kde4
295
- Create a Krusader build directory in c:/kde4/build/krusader_kde4
296
Unpack the source code (again) into this directory
297
This directory will be used to compile Krusader and to create all the
298
compiled files and the krusader.exe file.
300
- Because of a bug (at least in the KDE 4.1.2 and KDE 4.1.3 installation)
301
you need to edit some files, otherwise Krusader will fail to compile.
302
In the next files you need to replace "d:/kderoot" into "c:/kde4" when KDE4 is installed in c:\kde4
303
The problem is that the kde4 directory is wrong hardcoded in several files.
304
c:\KDE4\share\apps\cmake\modules\KDELibsDependencies.cmake
305
c:\KDE4\share\apps\cmake\modules\KDELibsDependenciesInternal.cmake
306
c:\KDE4\share\apps\cmake\modules\KDELibsDependenciesInternal.cmake.template
307
c:\KDE4\share\apps\cmake\modules\KDEPimLibsDependencies.cmake
308
c:\KDE4\share\apps\cmake\modules\KDEPimLibsDependencies.cmake.template
309
The bug is also explained in:
310
http://mail.kde.org/pipermail/kde-windows/2008-January/002000.html
311
http://www.cmake.org/pipermail/cmake/2008-January/018971.html
313
- Because of an Automoc4 installation bug (at least in the KDE 4.1.2 and KDE 4.1.3 installation)
314
you need to todo the next, otherwise Krusader will fail to compile.
315
- Create directory c:\kde4\lib\automoc4
316
- Install the automoc4 source package if it's not installed (with the kdewin-installer)
317
The automoc4 source package will be installed in c:\kde\src\
318
- Copy Automoc4Config.cmake, Automoc4Version.cmake and automoc4.files.in (but NOT the file kde4automoc.cpp)
319
into the new directory c:\kde4\lib\automoc4
321
- Open the Windows terminal (cmd.exe) and go to the build directory
286
323
cd \kde4\build\krusader_kde4
288
- So as to avoid a cmake error, that it can't find some kde library which is for sure installed,
289
it is necessary to make the following fix:
290
There is a strange problem, that in cmake modules
291
c:\kde4\share\apps\cmake\modules\KDELibsDependencies.cmake
292
c:\kde4\share\apps\cmake\modules\KDELibsDependenciesInternal.cmake
294
c:\kde4\share\apps\cmake\modules\KDEPimLibsDependencies.cmake
295
there are wrong hardcoded paths to the installation directory (D:/kde/kde-mingw),
296
it is necessary to replace it manually to c:/kde4.
298
- Run cmake in the build directory with the following parameters:
325
- Run "cmake" in the Krusader build directory c:\kde4\build\krusader_kde4 with the following parameters:
299
326
c:\kde4\bin\cmake.exe -G "MinGW Makefiles" c:/kde4/src/krusader_kde4 -DCMAKE_INSTALL_PREFIX=c:/kde4 -DCMAKE_INCLUDE_PATH=c:/kde4/include -DCMAKE_LIBRARY_PATH=c:/kde4/lib -DKDEWIN_DIR:PATH=c:/kde4 -DCMAKE_PREFIX_PATH=c:/kde4;c:/MinGW -DKDE4_INSTALL_DIR=c:/kde4 -DQT_INSTALL_DIR=c:/kde4 -DCMAKE_BUILD_TYPE=Release
301
329
If you want to use eclipse IDE, you may want to run instead:
302
330
c:\kde4\bin\cmake.exe -G "Eclipse CDT4 - MinGW Makefiles" c:/krusader/src/krusader_kde4 -DCMAKE_INSTALL_PREFIX=c:/kde4 -DCMAKE_INCLUDE_PATH=c:/kde4/include -DCMAKE_LIBRARY_PATH=c:/kde4/lib -DKDEWIN_DIR:PATH=c:/kde4 -DCMAKE_PREFIX_PATH=c:/kde4;c:/MinGW -DKDE4_INSTALL_DIR=c:/kde4 -DQT_INSTALL_DIR=c:/kde4 -DCMAKE_BUILD_TYPE=debugfull
303
331
and in Eclipse with C++ development tools 4 rigth click in the Project Explorer, choose Import...,
304
332
select "General->Existing projects into workspace" and choose the c:/kde4/build/krusader_kde4 directory.
306
- Run make from mingw:
334
- Run "make install" in the Krusader build directory c:\kde4\build\krusader_kde4
307
335
C:\MinGW\bin\mingw32-make.exe install
336
Krusader will now be compiled, if compilation is succesfully the exe file will be installed in c:\kde4\bin\krusader.exe
309
338
- Run krusader.exe (or choose it from the start menu) and enjoy!
311
- Known problems on windows at the moment (22 Oct 2008):
340
- If Krusader-Windows compilation fails please read the next url for more information
341
http://groups.google.com/group/krusader-devel/browse_thread/thread/fd28022291291333
343
- Known problems on Windows at the moment (22 Oct 2008):
312
344
+ Archives don't work
313
345
+ The media button does not work (seems to be a problem in KDEwin libraries, it used to work)
314
346
+ Most external tools don't work