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.