install.html (ed9d7cbe) install.html (d353e71e)
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

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

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
66 office). For a complete working environment, we have some additional
67 requirements:</p>
68 </td>
69 </tr>
70 <tr valign="top">
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

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

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
66 office). For a complete working environment, we have some additional
67 requirements:</p>
68 </td>
69 </tr>
70 <tr valign="top">
71 <td><b>Apache OpenOffice %PRODUCT_RELEASE% installation</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>
79 <tr valign="top">
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>
79 <tr valign="top">
80 <td><b>JDK (1.5 or higher)<b></td>
80 <td><b>JDK (1.5 or higher)</b></td>
81 <td class="content80">
82 <p>A JDK is necessary for developing Java components or applications. An appropriate Java SDK can be found on <a target="_blank" href="http://java.sun.com/products" title="link to the Java SDK download page (online)">http://java.sun.com/products</a>.</p>
83 <p>Recommendation is to use Java 6 excepting for Mac OS because initially Mac OS supported a 64bit version of Java 6 only.</p>
84 <p><b>Note</b>: The Java compiler is <b><u>optional</u></b>!</p></td>
85 </tr>
86 <tr valign="middle">
87 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
88 </tr>
89 <tr valign="top">
81 <td class="content80">
82 <p>A JDK is necessary for developing Java components or applications. An appropriate Java SDK can be found on <a target="_blank" href="http://java.sun.com/products" title="link to the Java SDK download page (online)">http://java.sun.com/products</a>.</p>
83 <p>Recommendation is to use Java 6 excepting for Mac OS because initially Mac OS supported a 64bit version of Java 6 only.</p>
84 <p><b>Note</b>: The Java compiler is <b><u>optional</u></b>!</p></td>
85 </tr>
86 <tr valign="middle">
87 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
88 </tr>
89 <tr valign="top">
90 <td><b>C++ compiler<b></td>
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>
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>
107 </tr>
108 </table>
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>
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>
107 </tr>
108 </table>
109 <p><b>Note</b>: The C++ compiler is <b><u>optional</u></b>! If you use the Express edition you have to ensure that the <a href="http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en">Microsoft Visual Studio 2008 Redistributable Package</a> is also installed. You can download this package from Microsoft directly.</a></p></td>
109 <p><b>Note</b>: The C++ compiler is <b><u>optional</u></b>! If you use the Express edition you have to ensure that the <a href="http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en">Microsoft Visual Studio 2008 Redistributable Package</a> is also installed. You can download this package from Microsoft directly.</p></td>
110 </tr>
111 <tr valign="middle">
112 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
113 </tr>
114 <tr valign="top">
110 </tr>
111 <tr valign="middle">
112 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
113 </tr>
114 <tr valign="top">
115 <td><b>Microsoft .NET Framework SDK version 1.0 or higher<b></td>
115 <td><b>Microsoft .NET Framework SDK version 1.0 or higher</b></td>
116 <td class="content80">The SDK is required for building CLI applications.
117 That is, programs written in languages, such as C# or VB.NET.<br>
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">
116 <td class="content80">The SDK is required for building CLI applications.
117 That is, programs written in languages, such as C# or VB.NET.<br>
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>
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>
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">
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>
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>
134 <td><b>zip tool (2.3 or higher)</b></td>
135 <td class="content80">The zip tool is used to create UNO packages. zip is
136 a new requirement to make the SDK independent of a Java SDK.<br>
137 If you do not have these already, you can download them from <a target="_blank" href="http://www.info-zip.org" title="link to www.ubfi-zip.org (online)">http://www.info-zip.org</a>. Note: The cygwin zip.exe does not work for the build under
138 the 4NT shell. You have to use the native w32 version.</td>
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">
135 <td class="content80">The zip tool is used to create UNO packages. zip is
136 a new requirement to make the SDK independent of a Java SDK.<br>
137 If you do not have these already, you can download them from <a target="_blank" href="http://www.info-zip.org" title="link to www.ubfi-zip.org (online)">http://www.info-zip.org</a>. Note: The cygwin zip.exe does not work for the build under
138 the 4NT shell. You have to use the native w32 version.</td>
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>
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="http://sourceforge.net/projects/unxutils/files/latest/downloadg" title="link to UnxUtils (online)">http://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>
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="http://sourceforge.net/projects/unxutils/files/latest/downloadg" title="link to UnxUtils (online)">http://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>
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="http://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)">http://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download</a>.</p>
156 </td>
157 <tr valign="middle">
158 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
159 </tr>
160 <tr>
161 <td><img class="nothing10" src="images/nada.gif"></td>

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

179 configure script once, the newly created script is always used to set the
180 necessary environment variables for using the SDK and the required
181 tools.</P>
182 <p>On UNIX operating systems, the configure script uses Perl. LINUX systems should have
183 installed a working Perl version, and on Solaris you can find a working
184 Perl version under <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a> if
185 necessary. On Windows, the configure script uses Windows Script and
186 a JScipt. If you have problems with Windows Script, you can download a
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="http://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)">http://sourceforge.net/projects/boost/files/boost/1.48.0/boost_1_48_0.tar.bz2/download</a>.</p>
156 </td>
157 <tr valign="middle">
158 <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
159 </tr>
160 <tr>
161 <td><img class="nothing10" src="images/nada.gif"></td>

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

179 configure script once, the newly created script is always used to set the
180 necessary environment variables for using the SDK and the required
181 tools.</P>
182 <p>On UNIX operating systems, the configure script uses Perl. LINUX systems should have
183 installed a working Perl version, and on Solaris you can find a working
184 Perl version under <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a> if
185 necessary. On Windows, the configure script uses Windows Script and
186 a JScipt. If you have problems with Windows Script, you can download a
187 newer version of <a href ="http://www.microsoft.com/downloads/details.aspx?FamilyId=C717D943-7E4B-4622-86EB-95A22B832CAA&displaylang=en" link"link to the download page for the Windows Script">Windows Script</a>.
187 newer version of <a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=C717D943-7E4B-4622-86EB-95A22B832CAA&amp;displaylang=en" title="link to the download page for the Windows Script">Windows Script</a>.
188 </p>
189 <p>On other versions of Windows, use the batch
190 file template <b>&lt;OO_SDK_HOME&gt;\setsdkenv_windows.template</b>,
191 rename it to *.bat, and adapt it to your local environment.</p>
192 <p>If you use the template batch file, edit and set
193 the following variables:</p>
194 <table class="table4">
195 <tr valign="top">

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

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>
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>
188 </p>
189 <p>On other versions of Windows, use the batch
190 file template <b>&lt;OO_SDK_HOME&gt;\setsdkenv_windows.template</b>,
191 rename it to *.bat, and adapt it to your local environment.</p>
192 <p>If you use the template batch file, edit and set
193 the following variables:</p>
194 <table class="table4">
195 <tr valign="top">

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

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>
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 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 ---