Warning, /graphics/kst-plot/INSTALL.qmake is written in an unsupported language. File is not indexed.

0001 
0002 Installation Notes for Kst 2.0.0 beta 3
0003 
0004 *********************************************
0005 Linux
0006 *********************************************
0007 Preliminaries:
0008 1. Download or otherwise install Qt 4.5 or greater.
0009 2. Make sure your QTDIR is set to that Qt installation.
0010 3. Optionally update your ./config.pri (you probably don't need to do this).
0011 
0012 Globally installed build/install:
0013 Follow Linux build steps 1-3 (Preliminaries)
0014 4. ./install-kst [release|debug [INSTALL_PREFIX [INSTALL_LIBDIR]]]
0015 5. kst2
0016 
0017 Locally installed debug build:
0018 Follow Linux build steps 1-3 (Preliminaries)
0019 4. ./build-kst 
0020 5. ./run-kst
0021 kst2 will be installed into ./build
0022 
0023 Create a package staged in /tmp/package/ for later installation in /usr:
0024 Follow Linux build steps 1-3 (Preliminaries)
0025 4. ./install-kst release /tmp/package/usr
0026 
0027 Command line options for install-kst (all optional)
0028     INSTALL_PREFIX - Installation location - Defaults to '/usr'
0029     INSTALL_LIBDIR - Library Installation Directory name - Defaults to 'lib'
0030     release        - optimized build (eg, -O2) for release (default)
0031     debug          - debug build (eg, -g, no optimizations)
0032 
0033 Note:  It is recommended that all installable builds be "release", since
0034   release mode does not set the RPATH directories.  Setting RPATH can
0035   result in a security hole.  The default for ./install-kst is release
0036 Note: build-kst and install-kst both build in ./build, so ./build should
0037   be [re-]moved before running ./install-kst if a debug build from
0038   ./build-kst already exists.
0039 Note: installation likely requires root privilidges.  You can separate the
0040   build and install steps (only if you really want to) by, eg:
0041     ./build-kst release
0042     sudo ./install-kst release
0043 
0044 Examples:
0045 Build and run debug version.
0046 
0047 1. Follow Linux build steps 1 - 3.
0048 2. ./build-kst 
0049 3. ./run-kst
0050 
0051 Build and install to /usr/bin /usr/lib
0052 1. Follow Linux build steps 1 - 3.
0053 2. ./install-kst
0054 
0055 Build and install to specific location (/usr/local/bin /usr/local/libXX)
0056 
0057 1. Follow Linux build steps 1 - 3.
0058 2. ./install-kst release /usr/local libXX
0059 
0060 
0061 *********************************************
0062 Mac OS
0063 *********************************************
0064 Building without Xcode (out-of-source):
0065   qmake ../kst/kst.pro  -spec macx-g++ -config release
0066   make
0067 
0068 Fixing the link paths (installs kst frameworks to /Library/Frameworks)
0069   ../kst/misc/macdeploykst
0070 
0071 Starting Kst from command line:
0072   ./build/bin/kst2.app/Contents/MacOS/kst2
0073 
0074 Creating a dmg in /build/bin:
0075   ../kst/misc/macdeploykst -dmg 
0076 
0077 
0078 
0079 *********************************************
0080 Windows
0081 *********************************************
0082 Using Qt Creator Bundle (Prefered method)
0083 1. Download or otherwise install the Qt Creator bundle including mingw
0084 2. Open Kst.pro
0085 3. Verify build settings
0086 4. Click Build
0087 
0088 -------------------------------------------------------------
0089 
0090 The following methods are not being activly tested, but might work.
0091 Windows using mingw
0092 
0093 Note:  This process must be done using the windows shell directly.  It
0094        cannot be done within cygwin or msys and neither can be included
0095        in the path.
0096 
0097 1. Download or otherwise install Qt 4.5 or greater.
0098 2. Update environment variables for build.
0099   a. This can be done using the Qt command line as installed in the
0100      Qt Creator bundle.
0101   b. This can be done using qtvars.bat generated by Qt and included below.
0102   c. This can be done manually following these steps.
0103     i. Make sure your QTDIR is set to that Qt installation.
0104     ii. Update your path to include ..\mingw\bin and %QTDIR%\bin
0105     iii. set QMAKESPEC environmental variable to %QTDIR%\mkspecs\win32-g++ 
0106 3. mkdir build && cd build
0107 4. qmake -r ../kst.pro
0108 5. mingw32-make
0109 
0110 Notes:  Be careful to ensure there's nothing else in path that might
0111         interfere.  Cygwin, msys and various other things all have
0112         individual make and sh executables that are slightly incompatible.
0113 
0114 qtvars.bat - mingw - Update directories to match machine configuration.
0115 
0116 @echo off
0117 rem
0118 rem This file is generated
0119 rem
0120 
0121 echo Setting up a MinGW/Qt only environment...
0122 echo -- QTDIR set to C:\Qt\4.5.1
0123 echo -- PATH set to C:\Qt\4.5.1\bin
0124 echo -- Adding C:\Qt\MinGW\bin to PATH
0125 echo -- Adding %SystemRoot%\System32 to PATH
0126 echo -- QMAKESPEC set to win32-g++
0127 
0128 set QTDIR=C:\Qt\4.5.1
0129 set PATH=C:\Qt\4.5.1\bin
0130 set PATH=%PATH%;C:\Qt\MinGW\bin
0131 set PATH=%PATH%;%SystemRoot%\System32
0132 set QMAKESPEC=win32-g++
0133 
0134 -------------------------------------------------------------
0135 Windows using Visual Studio
0136 
0137 Use a Qt build with Visual Studio.
0138 
0139 - open a Visual Studio console command promt
0140 - add path to qmake.exe to the PATH environment variable:
0141     set PATH=<path to qmake>;%PATH% 
0142 - to build Visual Studio project files call in kst:
0143     qmake -tp vc -recursive
0144 - open kst.sln from this console (e.g. vcexpress kst.sln)
0145 - build, run, and debug kst in Visual Studio
0146 
0147 
0148 
0149 -------------------------------------------------------------
0150 Windows using Visual Studio & Cygwin
0151 
0152 Note:  This has only been build using Visual Studio & Cygwin.  The following
0153        steps are used on the current Windows build machine used for testing,
0154        but may vary.
0155 
0156 1. Download or otherwise install Qt 4.5 or greater.
0157 2. Make sure your QTDIR is set to that Qt installation.
0158 3. Make sure your ./config.pri has the appropriate settings for you machine.
0159 4. Start up Cygwin's bash shell - Required due to command line length limit
0160    in cmd.exe.
0161 4a.Setup environment variables in Cygwin to link against Visual Studio -
0162    See qtvars.bat at end of file. It can be run as qtvars.bat vsbash to
0163    setup variables and start the shell.
0164 5. mkdir build && cd build
0165 6. qmake -r ../kst.pro
0166 7. nmake
0167 7a.If an error occurs, you may need to update Makefile.debug and replace
0168    "CXX  = @echo compiling $< && cl" with "CXX=cl"
0169 7b.  If libkstapp fails to build the following steps should circumvent the error.
0170   1) run nmake >makelog
0171   2) locate the cl.exe command line including application.cpp and copy it
0172   3) Replace all \ with \\ in the command
0173   4) Starting in the build directory, cd src\libkstapp, paste the command
0174      line, return to the build directory
0175   5) rerun nmake.
0176 8. ../run-kst
0177 
0178 
0179 qtvars.bat - Visual Studio - Update directories to match machine configuration.
0180 
0181 @echo off
0182 rem
0183 rem This file is generated
0184 rem
0185 
0186 echo Setting up a Qt environment...
0187 echo -- QTDIR set to C:\Qt\4.5.0
0188 echo -- Added C:\Qt\4.5.0\bin to PATH
0189 echo -- QMAKESPEC set to win32-msvc2005
0190 
0191 set QTDIR=C:\Qt\4.5.0
0192 set PATH=C:\Qt\4.5.0\bin;%PATH%
0193 set QMAKESPEC=win32-msvc2005
0194 
0195 if not "%1"=="vsvars" goto END
0196 call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
0197 :END
0198 
0199 if not "%1"=="vsstart" goto ENDSTARTVS
0200 call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
0201 devenv /useenv
0202 :ENDSTARTVS
0203 
0204 if not "%1"=="vsbash" goto ENDBASH
0205 call "C:\Program Files\Microsoft Visual Studio 8\\Common7\Tools\vsvars32.bat"
0206 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
0207 call "C:\cygwin\Cygwin.bat" -i
0208 :ENDBASH
0209 
0210 
0211 -------------------------------------------------------------
0212 Windows Installation
0213 
0214 No installer exists for windows currently.  To distribute / move locations.
0215 
0216 1. Use the build directory with kst/bin and kst/plugin only
0217 2. Copy mingwm10.dll libgcc_s_dw2-1 QtCore4.dll QtGui4.dll QtOpenGL4.dll QtSvg4.dll QtXml4.dll into kst/bin
0218 4. Package the build directory or use from this location.