forked from KDAB/KDSoap
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
139 lines (99 loc) · 4.5 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
KD SOAP 1.x requires a Qt version >= 4.6 with Network and XML support enabled.
The same source code compiles with either Qt 4 or Qt 5.
If you are using sources from github (via a git clone or a generated zip file), jump
to section 1-bis). Commercial users, start at section 1).
1) From the top directory of your KD SOAP installation run the "configure" scripts.
On Windows use depending on the kind of build one of the following;
configure.bat -shared -debug
configure.bat -shared -release
configure.bat -static -debug
configure.bat -static -release
On Unix use depending on the kind of build one of the following;
./configure.sh -shared -debug
./configure.sh -shared -release
./configure.sh -static -debug
./configure.sh -static -release
To define the install-location use for example;
configure.bat -shared -debug -prefix c:/kdsoap
./configure.sh -shared -debug -prefix /opt/kdsoap
If this succeeded, jump to step 2.
1-bis) If you are building KD Soap from a github clone rather than a release tarball,
the configure.bat/configure.sh script doesn't exist (it's generated at release time),
you need to do this instead:
First, a working Python (version2) is required and must be found in your
execute path. Either a 32-bit or 64-bit version of Python is fine, but run
python --version to make sure it is found and is python2 before continuing.
Next, you need to checkout the autogen submodule from the git repository.
like so:
git submodule update --init
And now run autogen.py to create the configure tool.
On Windows:
python autogen.py [options]
On Linux:
./autogen.py [options]
Pass the same options to autogen.py as you would for configure.sh/configure.bat
as shown above in step 1).
After running autogen.py, a configure.sh/configure.bat script will exist and
you can use that to re-configure later, as needed. Then you can continue on
to the platform-specific setup instructions in step 2, 3 or 4.
2) Unix
set your LD_LIBRARY_PATH to point to your KD SOAP installation lib directory.
If you do not have LD_LIBRARY_PATH set already then use this line:
LD_LIBRARY_PATH=/path/to/kdsoap/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
The above has to be added into your .bashrc or similar to remain. It may also of course be run from a shell just before building software using KD SOAP, but in this case your settings will only be available for this shell.
3) MacOS
Proceed as described above, but using DYLD_LIBRARY_PATH instead
of LD_LIBRARY_PATH
4) Windows
Add the path to KD SOAP lib into your LIB environment variable and the path
to KD SOAP bin into your PATH environment variable.
Or run:
set PATH=\path\to\kdsoap\bin;%PATH%
set LIB=\path\to\kdsoap\lib;%LIB%
5) Build everything by typing:
make # Unix,
nmake # Windows
6) (optionally:) Install KD SOAP:
From your top-level KD SOAP directory just type
make install # Unix,
nmake install # Windows
This will copy the necessary files into the sub-directories of
your installation path:
For Unix/Linux, Mac: /usr/local/KDAB/KDSoap-VERSION/
For Windows that is: C:\KDAB\KDSoap-VERSION\
7) Symbian (Qt4 only)
Here is a step by step introduction how to compile KD Soap with the Symbian-Toolchain on Windows.
1. Open a command prompt.
2. Setup environment
set QTDIR=c:\Qt\NokiaQtSDK_1_0_2\Symbian\SDK\
set PATH=c:\Qt\NokiaQtSDK_1_0_2\Symbian\SDK\bin\;%PATH%
set QMAKESPEC=symbian-abld
3. Change to your KD Soap source-directory
cd c:\src\kdsoap\
4. Run configuration
configure.bat -static -debug
5. Compile with
make release-gcce
make installer_sis
6. Depending on the Qt and Symbian^3 version you are using you maybe
get an error like
BLDMAKE ERROR: Can't find any RVCT installation.
This is a known qmake@Symbian^3 bug. You can workaround that bug
by installing python, saving following script in a file like e.g.
c:\fix.py and executing that script using "c:\fix.py c:\src\kdsoap\"
import os, sys, re
for root, subFolders, files in os.walk(sys.argv[1]):
for file in files:
if file == 'bld.inf':
path = os.path.join(root,file)
i = open(path).read()
o = open(path,"w")
o.write( re.sub("WINSCW GCCE ARMV5 ARMV6","WINSCW GCCE",i) )
o.close()
This will replace in all generated bld.inf files the line
WINSCW GCCE ARMV5 ARMV6
with
WINSCW GCCE
to workaround that known qmake+Symbian^3 bug.
7) Have a look at the examples applications. They will get you started with KD SOAP.