Installation Notes for Kst 2.0 Beta

Linux

1. Download or otherwise install Qt 4.4/4.5.
2. Make sure your QTDIR is set to that Qt installation.
3. Optionally update your ./config.pri has the appropriate settings for your machine.
4. ./build-kst
5. ./run-kst

Notes:
To build in debug mode debug can be added as a parameter to build-kst
ie.  ./build-kst debug
To configure the output directory, set OUTPUT_DIR or include it after the command line argument for debug.
ie.  ./build-kst release /home/kst
To enable make install support, set INSTDIR


Mac OS

Notes:

#1.  Same as the steps for Linux with some modifications required.
#2.  The qmake command line needs to be updated to include -spec macx-g++.
#3.  An error has been observed compiling view.cpp, view.h may need to be updated to change QXmlStreamWriter to QCoreXmlStreamWriter on line 45.


Windows using mingw

Note:  This process must be done using the windows shell directly.  It cannot be done within cygwin or msys and neither can be included in the path.

1. Download or otherwise install Qt 4.4/4.5.
2. Update environment variables for build.
  a. This can be done using the Qt command line as installed in the Qt Creator bundle.
  b. This can be done using qtvars.bat generated by Qt and included below.
  c. This can be done manually following these steps.
    i. Make sure your QTDIR is set to that Qt installation.
    ii. Update your path to include ..\mingw\bin and %QTDIR%\bin
    iii. set QMAKESPEC environmental variable to %QTDIR%\mkspecs\win32-g++ 
3. mkdir build && cd build
4. qmake -r ../kst.pro
5. mingw32-make

Notes:  Be careful to ensure there's nothing else in path that might interfere.  Cygwin, msys and various other things all have individual make and sh executables that are slightly incompatible.

qtvars.bat - mingw - Update directories to match machine configuration.
-------------------------------------------------------------

@echo off
rem
rem This file is generated
rem

echo Setting up a MinGW/Qt only environment...
echo -- QTDIR set to C:\Qt\4.5.1
echo -- PATH set to C:\Qt\4.5.1\bin
echo -- Adding C:\Qt\MinGW\bin to PATH
echo -- Adding %SystemRoot%\System32 to PATH
echo -- QMAKESPEC set to win32-g++

set QTDIR=C:\Qt\4.5.1
set PATH=C:\Qt\4.5.1\bin
set PATH=%PATH%;C:\Qt\MinGW\bin
set PATH=%PATH%;%SystemRoot%\System32
set QMAKESPEC=win32-g++

-------------------------------------------------------------


Windows using Visual Studio

Note:  This has only been build using Visual Studio & Cygwin.  The following steps
are used on the current Windows build machine used for testing, but may vary.

1. Download or otherwise install Qt 4.4/4.5.
2. Make sure your QTDIR is set to that Qt installation.
3. Make sure your ./config.pri has the appropriate settings for you machine.
4. Start up Cygwin's bash shell - Required due to command line length limit in cmd.exe.
4a. Setup environment variables in Cygwin to link against Visual Studio - See qtvars.bat at end of file. It can be run as qtvars.bat vsbash to setup variables and start the shell.
5. mkdir build && cd build
6. qmake -r ../kst.pro
7. nmake
7a.  If an error occurs, you may need to update Makefile.debug and replace "CXX  = @echo compiling $< && cl" with "CXX=cl"
7b.  If libkstapp fails to build the following steps should circumvent the error.
  1) run nmake >makelog
  2) locate the cl.exe command line including application.cpp and copy it
  3) Replace all \ with \\ in the command
  4) Starting in the build directory, cd src\libkstapp, paste the command line, return to the build directory
  4) rerun nmake.
8. ../run-kst


qtvars.bat - Visual Studio - Update directories to match machine configuration.
-------------------------------------------------------------

@echo off
rem
rem This file is generated
rem

echo Setting up a Qt environment...
echo -- QTDIR set to C:\Qt\4.5.0
echo -- Added C:\Qt\4.5.0\bin to PATH
echo -- QMAKESPEC set to win32-msvc2005

set QTDIR=C:\Qt\4.5.0
set PATH=C:\Qt\4.5.0\bin;%PATH%
set QMAKESPEC=win32-msvc2005

if not "%1"=="vsvars" goto END
call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
:END

if not "%1"=="vsstart" goto ENDSTARTVS
call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
devenv /useenv
:ENDSTARTVS

if not "%1"=="vsbash" goto ENDBASH
call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
rem Don't launch batch with --login so it doesn't prepend /usr/bin to the path; this stops cygwin's bin/link for overriding Visual Studio's link.exe
call "C:\cygwin\Cygwin.bat" -i
:ENDBASH

-------------------------------------------------------------