install.html (99eb6ac2) install.html (907636ef)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2<!--
3#**************************************************************
4#
5# Licensed to the Apache Software Foundation (ASF) under one
6# or more contributor license agreements. See the NOTICE file
7# distributed with this work for additional information
8# regarding copyright ownership. The ASF licenses this file

--- 27 unchanged lines hidden (view full) ---

36 </tr>
37 <tr>
38 <td colspan="3"><img class="nothing10" src="images/nada.gif"></td>
39 </tr>
40 <tr>
41 <td class="content1"><img class="nothing8" src="images/nada.gif"></td>
42 <td>
43 <table class="table2">
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2<!--
3#**************************************************************
4#
5# Licensed to the Apache Software Foundation (ASF) under one
6# or more contributor license agreements. See the NOTICE file
7# distributed with this work for additional information
8# regarding copyright ownership. The ASF licenses this file

--- 27 unchanged lines hidden (view full) ---

36 </tr>
37 <tr>
38 <td colspan="3"><img class="nothing10" src="images/nada.gif"></td>
39 </tr>
40 <tr>
41 <td class="content1"><img class="nothing8" src="images/nada.gif"></td>
42 <td>
43 <table class="table2">
44 <tr>
45 <td colspan="3"><img class="nothing1" src="images/nada.gif"></td>
44 <tr>
45 <td colspan="3"><img class="nothing1" src="images/nada.gif"></td>
46 </tr>
47 <tr>
46 </tr>
47 <tr>
48 <td>
49 <table class="table3">
50 <tr>
51 <td colspan="2" class="head1">Installation Guide</td>
52 <td align="right"><a href="../index.html" title="link to the SDK start page"><img class="navigate" src="images/nav_home.png"></a></td>
53 </tr>
54 </table>
55 </td>
48 <td>
49 <table class="table3">
50 <tr>
51 <td colspan="2" class="head1">Installation Guide</td>
52 <td align="right"><a href="../index.html" title="link to the SDK start page"><img class="navigate" src="images/nav_home.png"></a></td>
53 </tr>
54 </table>
55 </td>
56 </tr>
56 </tr>
57 <tr>
57 <tr>
58 <td>
58 <td>
59 <table class="table3">
60 <tr>
61 <td colspan="2">
59 <table class="table3">
60 <tr>
61 <td colspan="2">
62 <p>The Apache OpenOffice %PRODUCT_RELEASE% SDK comes with a set of development tools, base
63 libraries, header files and helper class files that can be used to
64 develop Java/C++ components, to embed the Apache OpenOffice %PRODUCT_RELEASE% application in
62 <p>The Apache OpenOffice %PRODUCT_RELEASE% SDK comes with a set of development tools, base
63 libraries, header files and helper class files that can be used to
64 develop Java/C++ components, to embed the Apache OpenOffice %PRODUCT_RELEASE% application in
65 your own programs, or to use the API (scripting or remote control the
65 your own programs, or to use the API (scripting or remote control the
66 office). For a complete working environment, we have some additional
67 requirements:</p>
66 office). For a complete working environment, we have some additional
67 requirements:</p>
68 </td>
69 </tr>
70 <tr valign="top">
68 </td>
69 </tr>
70 <tr valign="top">
71 <td><b>Apache OpenOffice %PRODUCT_RELEASE% installation</b></td>
72 <td class="content80">The SDK works on top of an existing office
73 installation and uses the same libraries as the office installation.</td>
74 </tr>
75 </tr>
76 <tr valign="middle">
77 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
78 </tr>

--- 11 unchanged lines hidden (view full) ---

90 <td><b>C++ compiler</b></td>
91 <td class="content80">A C++ compiler is necessary for developing C++
92 components or applications. UNO depends on a compiler dependent language
93 binding, so that we use the appropriate compiler where a language binding
94 exists:
95 <table class="table4">
96 <tr>
97 <td class="cell15">Solaris</td>
71 <td><b>Apache OpenOffice %PRODUCT_RELEASE% installation</b></td>
72 <td class="content80">The SDK works on top of an existing office
73 installation and uses the same libraries as the office installation.</td>
74 </tr>
75 </tr>
76 <tr valign="middle">
77 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
78 </tr>

--- 11 unchanged lines hidden (view full) ---

90 <td><b>C++ compiler</b></td>
91 <td class="content80">A C++ compiler is necessary for developing C++
92 components or applications. UNO depends on a compiler dependent language
93 binding, so that we use the appropriate compiler where a language binding
94 exists:
95 <table class="table4">
96 <tr>
97 <td class="cell15">Solaris</td>
98 <td class="cell85">Sun Studion 8 (20070730)</td>
98 <td class="cell85">Sun Studio 8 (20070730)</td>
99 </tr>
100 <tr>
101 <td class="cell15">Linux</td>
102 <td class="cell80">GNU C++ compiler, gcc version 4.0.1</td>
103 </tr>
104 <tr>
105 <td class="cell15">Windows</td>
106 <td class="cell80">Microsoft C++ Compiler, Microsoft Visual Studio 2008 or the Express version (cl, version 15.00.21022)</td>

--- 11 unchanged lines hidden (view full) ---

118 <p><b>Note</b>: The .NET Framework is <b><u>optional</u></b>!</p></td>
119 </tr>
120 <tr valign="middle">
121 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
122 </tr>
123 <tr valign="top">
124 <td><b>GNU make (3.79.1 or higher)</b></td>
125 <td class="content80">
99 </tr>
100 <tr>
101 <td class="cell15">Linux</td>
102 <td class="cell80">GNU C++ compiler, gcc version 4.0.1</td>
103 </tr>
104 <tr>
105 <td class="cell15">Windows</td>
106 <td class="cell80">Microsoft C++ Compiler, Microsoft Visual Studio 2008 or the Express version (cl, version 15.00.21022)</td>

--- 11 unchanged lines hidden (view full) ---

118 <p><b>Note</b>: The .NET Framework is <b><u>optional</u></b>!</p></td>
119 </tr>
120 <tr valign="middle">
121 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
122 </tr>
123 <tr valign="top">
124 <td><b>GNU make (3.79.1 or higher)</b></td>
125 <td class="content80">
126 <p>GNU make is used to build the examples of the SDK. GNU make is available from <a target="_blank" href="http://www.gnu.org" title="link to www.gnu.org (online)">http://www.gnu.org</a>. It can be ftped via <a target="_blank" href="ftp://ftp.gnu.org/gnu/make" title="link to gnumake on www.gnu.org (online)">ftp://ftp.gnu.org/gnu/make</a></p>
126 <p>GNU make is used to build the examples of the SDK. GNU make is available from <a target="_blank" href="http://www.gnu.org" title="link to www.gnu.org (online)">http://www.gnu.org</a>. It can be downloaded via FTP from <a target="_blank" href="ftp://ftp.gnu.org/gnu/make" title="link to gnumake on www.gnu.org (online)">ftp://ftp.gnu.org/gnu/make</a></p>
127 <p><b>Note</b>: Windows user can find an executable of gnu make under <a target="_blank" href="http://www.mingw.org/wiki/Getting_Started" title="link to the MinGW Getting Started wiki (online)">http://www.mingw.org/wiki/Getting_Started</a> (see the mingw32-make link under &quot;Manual Installation&quot;). Do not use the Cygwin make, because it does not
128 work well. On Solaris gnu make can be found often under <b><i>/usr/sfw/bin/gmake</i></b>, but keep in mind that you have to use <b>'gmake'</b> then. Or you can find gnu make also under <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a>.</td>
129 </tr>
130 <tr valign="middle">
131 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
132 </tr>
133 <tr valign="top">
134 <td><b>zip tool (2.3 or higher)</b></td>

--- 4 unchanged lines hidden (view full) ---

139 </tr>
140 <tr valign="middle">
141 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
142 </tr>
143 <tr valign="top">
144 <td><b>cat and sed tools</b></td>
145 <td class="content80">The cat and set tools are used to create some extensions.
146 <p><b>Note for Windows users</b>: If you do not have these already, you can download them from
127 <p><b>Note</b>: Windows user can find an executable of gnu make under <a target="_blank" href="http://www.mingw.org/wiki/Getting_Started" title="link to the MinGW Getting Started wiki (online)">http://www.mingw.org/wiki/Getting_Started</a> (see the mingw32-make link under &quot;Manual Installation&quot;). Do not use the Cygwin make, because it does not
128 work well. On Solaris gnu make can be found often under <b><i>/usr/sfw/bin/gmake</i></b>, but keep in mind that you have to use <b>'gmake'</b> then. Or you can find gnu make also under <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a>.</td>
129 </tr>
130 <tr valign="middle">
131 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
132 </tr>
133 <tr valign="top">
134 <td><b>zip tool (2.3 or higher)</b></td>

--- 4 unchanged lines hidden (view full) ---

139 </tr>
140 <tr valign="middle">
141 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
142 </tr>
143 <tr valign="top">
144 <td><b>cat and sed tools</b></td>
145 <td class="content80">The cat and set tools are used to create some extensions.
146 <p><b>Note for Windows users</b>: If you do not have these already, you can download them from
147 <a target="_blank" href="https://sourceforge.net/projects/unxutils/files/latest/downloadg" title="link to UnxUtils (online)">https://sourceforge.net/projects/unxutils/files/latest/download</a>.</p>
147 <a target="_blank" href="https://sourceforge.net/projects/unxutils/files/latest/download" title="link to UnxUtils (online)">https://sourceforge.net/projects/unxutils/files/latest/download</a>.</p>
148 </td>
149 </tr>
150 <tr valign="middle">
151 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
152 </tr>
153 <td><b>Boost (<b>Unix only</b> and optional)</b></td>
154 <td class="content80">The boost library is used today on Unix systems as replacement for the stlport library. The stlport library is removed and replaced by either the compiler stl (on Windows) or the boost stl on all Unix based systems. We are planning to switch to the compiler stl completely as soon as possible. The boost headers/library are <b>optional</b> and for C++ development only if stl containers are used.
155 <p><b>Download:</b> <a target="_blank" href="https://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download" title="link to boost version 1.48.0 (online)">https://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download</a>.</p>

--- 7 unchanged lines hidden (view full) ---

163 <a href="#install" title="link to the top of this page"><img class="navigate" src="images/nav_up.png"></a>
164 <a href="../index.html" title="link to the SDK start page"><img class="navigate" src="images/nav_home.png"></a></td>
165 </tr>
166 <tr valign="middle">
167 <td colspan="2">
168 <p>The SDK provides an implicit configuration mechanism, which
169 configures the SDK build environment to your personal needs the first
170 time you use the SDK environment. This configuration step creates a
148 </td>
149 </tr>
150 <tr valign="middle">
151 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
152 </tr>
153 <td><b>Boost (<b>Unix only</b> and optional)</b></td>
154 <td class="content80">The boost library is used today on Unix systems as replacement for the stlport library. The stlport library is removed and replaced by either the compiler stl (on Windows) or the boost stl on all Unix based systems. We are planning to switch to the compiler stl completely as soon as possible. The boost headers/library are <b>optional</b> and for C++ development only if stl containers are used.
155 <p><b>Download:</b> <a target="_blank" href="https://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download" title="link to boost version 1.48.0 (online)">https://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download</a>.</p>

--- 7 unchanged lines hidden (view full) ---

163 <a href="#install" title="link to the top of this page"><img class="navigate" src="images/nav_up.png"></a>
164 <a href="../index.html" title="link to the SDK start page"><img class="navigate" src="images/nav_home.png"></a></td>
165 </tr>
166 <tr valign="middle">
167 <td colspan="2">
168 <p>The SDK provides an implicit configuration mechanism, which
169 configures the SDK build environment to your personal needs the first
170 time you use the SDK environment. This configuration step creates a
171 new setsdkenv_XXX script in the user's home directory:</P>
171 new setsdkenv_XXX script in the user's home directory:</p>
172 <ul>
173 <li><b>$HOME/$OO_SDK_NAME/setsdkenv_unix.sh</b>&nbsp;&nbsp;-> for Unix
174 <li><b>C:\Documents and Settings\&lt;username&gt;\Application Data\%OO_SDK_NAME%\setsdkenv_windows.bat</b>&nbsp;&nbsp;-> for Windows2000/XP or later
175 </ul>
176 <p>The automatically started configure script (Unix and Windows2000/XP)
177 requests relevant information and directories (SDK, the Office, GNU make,
178 Java, C++), in order to prepare a working SDK environment. After completing the
179 configure script once, the newly created script is always used to set the

--- 173 unchanged lines hidden (view full) ---

353 <td class="cell80">=<i>$OO_SDK_OFFICE_LIB_DIR: $OO_SDK_HOME/(solsparc|solintel)/lib: $LD_LIBRARY_PATH</i><br>
354 <p>The LD_LIBRARY_PATH will be set or will be extended by the office
355 library path, the platform dependent lib directory for several additional
356 libraries.</p>
357 </td>
358 </tr>
359 <tr valign="top">
360 <td class="cell20">PATH</td>
172 <ul>
173 <li><b>$HOME/$OO_SDK_NAME/setsdkenv_unix.sh</b>&nbsp;&nbsp;-> for Unix
174 <li><b>C:\Documents and Settings\&lt;username&gt;\Application Data\%OO_SDK_NAME%\setsdkenv_windows.bat</b>&nbsp;&nbsp;-> for Windows2000/XP or later
175 </ul>
176 <p>The automatically started configure script (Unix and Windows2000/XP)
177 requests relevant information and directories (SDK, the Office, GNU make,
178 Java, C++), in order to prepare a working SDK environment. After completing the
179 configure script once, the newly created script is always used to set the

--- 173 unchanged lines hidden (view full) ---

353 <td class="cell80">=<i>$OO_SDK_OFFICE_LIB_DIR: $OO_SDK_HOME/(solsparc|solintel)/lib: $LD_LIBRARY_PATH</i><br>
354 <p>The LD_LIBRARY_PATH will be set or will be extended by the office
355 library path, the platform dependent lib directory for several additional
356 libraries.</p>
357 </td>
358 </tr>
359 <tr valign="top">
360 <td class="cell20">PATH</td>
361 <td class="cell80">=<i>$OO_SDK_HOME/(solsparc|solintel)/bin:$OO_SDK_MAKE_HOME: $OO_SDK_ZIP_HOME: [$OO_SDK_CPP_HOME:] [$OO_SDK_JAVA_HOME/bin:] $OO_SDK_OFFICE_BIN_DIR: $PATH</i></b><br>
361 <td class="cell80">=<i>$OO_SDK_HOME/(solsparc|solintel)/bin:$OO_SDK_MAKE_HOME: $OO_SDK_ZIP_HOME: [$OO_SDK_CPP_HOME:] [$OO_SDK_JAVA_HOME/bin:] $OO_SDK_OFFICE_BIN_DIR: $PATH</i><br>
362 <p>The PATH variable will be extended by the paths for the SDK development
363 tools, the compiler, the JDK, GNU make, the zip tool and the
364 OO_SDK_OFFICE_BIN_DIR, where the compiler or the JDK are
365 optional.</p>
366 </td>
367 </tr>
368 <tr>
362 <p>The PATH variable will be extended by the paths for the SDK development
363 tools, the compiler, the JDK, GNU make, the zip tool and the
364 OO_SDK_OFFICE_BIN_DIR, where the compiler or the JDK are
365 optional.</p>
366 </td>
367 </tr>
368 <tr>
369 <td colspan="2" class="cell80">Based OFFICE_HOME, the script
369 <td colspan="2" class="cell80">Based on OFFICE_HOME, the script
370 additionally creates symbolic links to the public dynamic libraries of
371 the office UNO runtime in <i>$OO_SDK_HOME/(solsparc|solintel)/lib</i>, which are
372 needed for linking.</td>
373 </tr>
374 </table>
375 <p class="head4">Linux</p>
376 <table class="table4">
377 <tr valign="top">

--- 75 unchanged lines hidden --- 		370 additionally creates symbolic links to the public dynamic libraries of
371 the office UNO runtime in <i>$OO_SDK_HOME/(solsparc|solintel)/lib</i>, which are
372 needed for linking.</td>
373 </tr>
374 </table>
375 <p class="head4">Linux</p>
376 <table class="table4">
377 <tr valign="top">

--- 75 unchanged lines hidden ---