mir/libreoffice
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Re-indent (no change to content)

Browse Source 
Change-Id: I72fa9b85e8544ea7bf1c1dea8ff3358835959f55
This commit is contained in:
Stephan Bergmann
2014-11-24 17:05:51 +01:00
parent 2052ea7439
commit 0d2befdaea
1 changed files with 544 additions and 423 deletions
Download Patch File Download Diff File Expand all files Collapse all files

967
odk/docs/install.html
View File

@@ -22,429 +22,550 @@
<link rel="stylesheet" type="text/css" href="sdk_styles.css"/> <link rel="stylesheet" type="text/css" href="sdk_styles.css"/>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/>
</head> </head>
<body> <body>
<div id="BgContainer"> <div id="BgContainer">
<div id="Container"> <div id="Container">
<div id="TopHeader"> <div id="TopHeader">
<a id="Logo" href="http://www.libreoffice.org/" title="Go to the Home of LibreOffice and the LibreOffice Community page"></a> <a id="Logo" href="http://www.libreoffice.org/"
<p id="HeaderTagLine"> title="Go to the Home of LibreOffice and the LibreOffice Community page"></a>
Software Development Kit %PRODUCT_RELEASE% <p id="HeaderTagLine">
</p> Software Development Kit %PRODUCT_RELEASE%
</div> </p>
<div class="clear"> </div>
</div> <div class="clear">
<div id="Layout"> </div>
<div class="typography"> <div id="Layout">
<h1> <div class="typography">
Installation Guide <h1>Installation Guide</h1>
</h1> <table class="table1" cellpadding="0">
<table class="table1" cellpadding="0"> <tr>
<tr> <td colspan="3"><img class="nothing10" src="images/nada.gif"/></td>
<td colspan="3"><img class="nothing10" src="images/nada.gif"/></td> </tr>
</tr> <tr>
<tr> <td class="content1"><img class="nothing8" src="images/nada.gif"/></td>
<td class="content1"><img class="nothing8" src="images/nada.gif"/></td> <td>
<td> <table class="table2">
<table class="table2"> <tr>
<tr> <td colspan="3"><img class="nothing1" src="images/nada.gif"/></td>
<td colspan="3"><img class="nothing1" src="images/nada.gif"/></td> </tr>
</tr> <tr>
<tr> <td>
<td> <table class="table3">
<table class="table3"> <tr>
<tr> <td colspan="2">
<td colspan="2"> <p>The LibreOffice %PRODUCT_RELEASE% SDK comes with
<p>The LibreOffice %PRODUCT_RELEASE% SDK comes with a set of development tools, base a set of development tools, base libraries, header
libraries, header files and helper class files that can be used to files and helper class files that can be used to
develop Java/C++ components, to embed the LibreOffice %PRODUCT_RELEASE% application in develop Java/C++ components, to embed the
your own programs, or to use the API (scripting or remote control the LibreOffice %PRODUCT_RELEASE% application in your
office). For a complete working environment, we have some additional own programs, or to use the API (scripting or
requirements:</p> remote control the office). For a complete working
</td> environment, we have some additional
</tr> requirements:</p>
<tr valign="top"> </td>
<td><b>LibreOffice %PRODUCT_RELEASE% installation</b></td> </tr>
<td class="content80">The SDK works on top of an existing office <tr valign="top">
installation and uses the same libraries as the office installation.</td> <td><b>LibreOffice %PRODUCT_RELEASE%
</tr> installation</b></td>
<tr valign="middle"> <td class="content80">The SDK works on top of an
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> existing office installation and uses the same
</tr> libraries as the office installation.</td>
<tr valign="top"> </tr>
<td><b>JDK (1.5 or higher)</b></td> <tr valign="middle">
<td class="content80"> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
<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> </tr>
<p>Recommendation is to use Java 7 or later for 64bit, and Java 6 for 32bit.</p> <tr valign="top">
<p><b>Note</b>: The Java compiler is <b><u>optional</u></b>!</p></td> <td><b>JDK (1.5 or higher)</b></td>
</tr> <td class="content80">
<tr valign="middle"> <p>A JDK is necessary for developing Java components
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> or applications. An appropriate Java SDK can be
</tr> found on
<tr valign="top"> <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>
<td><b>C++ compiler</b></td> <p>Recommendation is to use Java 7 or later for
<td class="content80">A C++ compiler is necessary for developing C++ 64bit, and Java 6 for 32bit.</p>
components or applications. UNO depends on a compiler dependent language <p><b>Note</b>: The Java compiler is
binding, so that we use the appropriate compiler where a language binding <b><u>optional</u></b>!</p></td>
exists: </tr>
<table class="table4"> <tr valign="middle">
<tr> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
<td class="cell15">Linux</td> </tr>
<td class="cell80">GNU C++ compiler, gcc version 4.1 or later</td> <tr valign="top">
</tr> <td><b>C++ compiler</b></td>
<tr> <td class="content80">A C++ compiler is necessary for
<td class="cell15">Mac OS X</td> developing C++ components or applications. UNO
<td class="cell80">XCode</td> depends on a compiler dependent language binding, so
</tr> that we use the appropriate compiler where a
<tr> language binding exists:
<td class="cell15">Windows</td> <table class="table4">
<td class="cell80">Microsoft C++ Compiler, Microsoft Visual Studio 2010 or later, or the Express edition thereof</td> <tr>
</tr> <td class="cell15">Linux</td>
</table> <td class="cell80">GNU C++ compiler, gcc version
<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&amp;displaylang=en">Microsoft Visual Studio 2008 Redistributable Package</a> is also installed. You can download this package from Microsoft directly.</p></td> 4.1 or later</td>
</tr> </tr>
<tr valign="middle"> <tr>
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> <td class="cell15">Mac OS X</td>
</tr> <td class="cell80">XCode</td>
<tr valign="top"> </tr>
<td><b>Microsoft .NET Framework SDK version 1.0 or higher</b></td> <tr>
<td class="content80">The SDK is required for building CLI applications. <td class="cell15">Windows</td>
That is, programs written in languages, such as C# or VB.NET.<br/> <td class="cell80">Microsoft C++ Compiler,
<p><b>Note</b>: The .NET Framework is <b><u>optional</u></b>!</p></td> Microsoft Visual Studio 2010 or later, or the
</tr> Express edition thereof</td>
<tr valign="middle"> </tr>
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> </table>
</tr> <p><b>Note</b>: The C++ compiler is
<tr valign="top"> <b><u>optional</u></b>! If you use the Express
<td><b>GNU make (3.79.1 or higher)</b></td> edition you have to ensure that the
<td class="content80"> <a href="http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&amp;displaylang=en">Microsoft Visual Studio 2008 Redistributable Package</a>
<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> is also installed. You can download this package
<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 from Microsoft directly.</p></td>
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>.</p></td> </tr>
</tr> <tr valign="middle">
<tr valign="middle"> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> </tr>
</tr> <tr valign="top">
<tr valign="top"> <td><b>Microsoft .NET Framework SDK version 1.0 or
<td><b>zip tool (2.3 or higher)</b></td> higher</b></td>
<td class="content80">The zip tool is used to create UNO packages. zip is <td class="content80">The SDK is required for building
a new requirement to make the SDK independent of a Java SDK.<br/> CLI applications. That is, programs written in
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 languages, such as C# or VB.NET.<br/>
the 4NT shell. You have to use the native w32 version.</td> <p><b>Note</b>: The .NET Framework is
</tr> <b><u>optional</u></b>!</p></td>
<tr valign="middle"> </tr>
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td> <tr valign="middle">
</tr> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
<tr valign="top"> </tr>
<td><b>cat and sed tools<b></td> <tr valign="top">
<td class="content80">The cat and set tools are used to create some extensions. <td><b>GNU make (3.79.1 or higher)</b></td>
<p><b>Note for Windows users</b>: If you do not have these already, you can download them from <td class="content80">
<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> <p>GNU make is used to build the examples of the
</td> SDK. GNU make is available from
</tr> <a target="_blank" href="http://www.gnu.org" title="link to www.gnu.org (online)">http://www.gnu.org</a>.
<tr valign="middle"> It can be ftped via
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> <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>
</tr> <p><b>Note</b>: Windows user can find an executable
<tr valign="middle"> of gnu make under
<td colspan="2"> <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>
<p>The SDK provides an implicit configuration mechanism, which (see the mingw32-make link under &quot;Manual
configures the SDK build environment to your personal needs the first Installation&quot;). Do not use the Cygwin make,
time you use the SDK environment. This configuration step creates a because it does not work well. On Solaris gnu make
new setsdkenv_XXX script in the user's home directory:</p> can be found often under
<ul> <b><i>/usr/sfw/bin/gmake</i></b>, but keep in mind
<li><b>$HOME/$OO_SDK_NAME/setsdkenv_unix.sh</b>&nbsp;&nbsp;-&gt; for Unix</li> that you have to use <b>'gmake'</b> then. Or you
<li><b>C:\Documents and Settings\&lt;username&gt;\Application Data\%OO_SDK_NAME%\setsdkenv_windows.bat</b>&nbsp;&nbsp;-&gt; for Windows2000/XP or later</li> can find gnu make also under
</ul> <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a>.</p></td>
<p>The automatically started configure script (Unix and Windows2000/XP) </tr>
requests relevant information and directories (SDK, LibreOffice, GNU make, <tr valign="middle">
Java, C++), in order to prepare a working SDK environment. After completing the <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
configure script once, the newly created script is always used to set the </tr>
necessary environment variables for using the SDK and the required <tr valign="top">
tools.</p> <td><b>zip tool (2.3 or higher)</b></td>
<p>On UNIX operating systems, the configure script uses Perl. LINUX systems should have <td class="content80">The zip tool is used to create
installed a working Perl version, and on Solaris you can find a working UNO packages. zip is a new requirement to make the
Perl version under <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a> if SDK independent of a Java SDK.<br/>
necessary. On Windows, the configure script uses Windows Script and If you do not have these already, you can download
a JScipt. If you have problems with Windows Script, you can download a them from
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>. <a target="_blank" href="http://www.info-zip.org" title="link to www.ubfi-zip.org (online)">http://www.info-zip.org</a>.
</p> Note: The cygwin zip.exe does not work for the build
<p>On other versions of Windows, use the batch under the 4NT shell. You have to use the native w32
file template <b>&lt;OO_SDK_HOME&gt;\setsdkenv_windows.template</b>, version.</td>
rename it to *.bat, and adapt it to your local environment.</p> </tr>
<p>If you use the template batch file, edit and set <tr valign="middle">
the following variables:</p> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"></td>
<table class="table4"> </tr>
<tr valign="top"> <tr valign="top">
<td class="cell20"><b>OFFICE_HOME</b></td> <td><b>cat and sed tools<b></td>
<td class="cell80">Path to an existing LibreOffice <td class="content80">The cat and set tools are used
base installation, e.g. &quot;/opt/libreoffice8&quot;. Be sure to create some extensions.
that it is not a user installation only. Exactly one of OFFICE_HOME <p><b>Note for Windows users</b>: If you do not have
and OO_SDK_URE_HOME must be set. The other should be either unset or these already, you can download them from
set to an empty value.</td> <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>
</tr> </td>
<tr> </tr>
<td class="cell20"><a name="oosdkname"/><b>OO_SDK_NAME</b></td> <tr valign="middle">
<td class="cell80">The configuration uses the <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
directory name of the SDK, but you can use another name as well. </tr>
It is important that the name does not contain spaces, because of a limitation <tr valign="middle">
of gnu make which cannot handle spaces correctly. This name is, for <td colspan="2">
example, used to create an output directory in the users home directory <p>The SDK provides an implicit configuration
for any generated output when you use the SDK build environment.</td> mechanism, which configures the SDK build
</tr> environment to your personal needs the first time
<tr> you use the SDK environment. This configuration
<td class="cell20"><b>OO_SDK_URE_HOME</b></td> step creates a new setsdkenv_XXX script in the
<td class="cell80">Path to an existing UNO Runtime Environment user's home directory:</p>
installation, e.g. &quot;/opt/libreoffice/ure&quot;. Exactly one of <ul>
OFFICE_HOME and OO_SDK_URE_HOME must be set. The other should be <li><b>$HOME/$OO_SDK_NAME/setsdkenv_unix.sh</b>&nbsp;&nbsp;-&gt;
either unset or set to an empty value.</td> for Unix</li>
</tr> <li><b>C:\Documents and Settings\&lt;username&gt;\Application Data\%OO_SDK_NAME%\setsdkenv_windows.bat</b>&nbsp;&nbsp;-&gt;
<tr> for Windows2000/XP or later</li>
<td class="cell20"><b>OO_SDK_HOME</b></td> </ul>
<td class="cell80">Path to the SDK root directory, e.g. <p>The automatically started configure script (Unix
&quot;/opt/libreoffice/sdk&quot;</td> and Windows2000/XP) requests relevant information
</tr> and directories (SDK, LibreOffice, GNU make, Java,
<tr> C++), in order to prepare a working SDK
<td class="cell20"><b>OO_SDK_JAVA_HOME</b></td> environment. After completing the configure script
<td class="cell80">Path to a JDK root directory. The JDK is once, the newly created script is always used to
<b>optional</b> and only necessary if you like to run the Java examples set the necessary environment variables for using
or if you like to use the SDK environment to develop your own Java the SDK and the required tools.</p>
solution.</td> <p>On UNIX operating systems, the configure script
</tr> uses Perl. LINUX systems should have installed a
<tr> working Perl version, and on Solaris you can find
<td class="cell20"><b>OO_SDK_CPP_HOME</b></td> a working Perl version under
<td class="cell80">Path to the C++ compiler (on Windows, the directory <a target="_blank" href="http://www.sunfreeware.com/" title="link to www.sunfreeware.com (online)">http://www.sunfreeware.com/</a>
where the &quot;<i>vcvar32.bat</i>&quot; file can be found). The C++ if necessary. On Windows, the configure script
compiler is <b>optional</b> and only necessary for building the C++ uses Windows Script and a JScipt. If you have
examples.</td> problems with Windows Script, you can download a
</tr> newer version of
<tr> <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>.</p>
<td class="cell20"><b>OO_SDK_CLI_HOME</b></td> <p>On other versions of Windows, use the batch file
<td class="cell80">Path to the C# compiler and VB.NET compiler (on template
Windows, this directory can be found under the system directory (e.g. <b>&lt;OO_SDK_HOME&gt;\setsdkenv_windows.template</b>,
c:\WINXP\Microsoft.NET\Framework\v1.0.3705). The compilers are rename it to *.bat, and adapt it to your local
<b>optional</b> and only necessary for building the CLI examples.<br/> environment.</p>
<b>Note: Windows only!</b></td> <p>If you use the template batch file, edit and set
</tr> the following variables:</p>
<tr> <table class="table4">
<td class="cell20"><b>OO_SDK_MAKE_HOME</b></td> <tr valign="top">
<td class="cell80">Path to GNU make.</td> <td class="cell20"><b>OFFICE_HOME</b></td>
</tr> <td class="cell80">Path to an existing
<tr> LibreOffice base installation, e.g.
<td class="cell20"><b>OO_SDK_ZIP_HOME</b></td> &quot;/opt/libreoffice8&quot;. Be sure that it
<td class="cell80">Path to the 'zip' tool.</td> is not a user installation only. Exactly one
</tr> of OFFICE_HOME and OO_SDK_URE_HOME must be
<tr> set. The other should be either unset or set
<td class="cell20"><b>OO_SDK_CAT_HOME</b></td> to an empty value.</td>
<td class="cell80">Path to the 'cat' tool.</td> </tr>
</tr> <tr>
<tr> <td class="cell20"><a name="oosdkname"/><b>OO_SDK_NAME</b></td>
<td class="cell20"><b>OO_SDK_SED_HOME</b></td> <td class="cell80">The configuration uses the
<td class="cell80">Path to the 'sed' tool.</td> directory name of the SDK, but you can use
</tr> another name as well. It is important that the
<tr> name does not contain spaces, because of a
<td class="cell20"><b>OO_SDK_OUTPUT_DIR</b></td> limitation of gnu make which cannot handle
<td class="cell80">Path to an existing directory where the example output spaces correctly. This name is, for example,
is generated. The output directory is <b>optional</b>, by default used to create an output directory in the
the output is generated in the SDK directory itself. If an output users home directory for any generated output
directory is specified, the output is generated in a SDK dependent when you use the SDK build environment.</td>
subdirectory in this directory (e.g. &lt;OO_SDK_OUTPUT_DIR&gt; </tr>
/LibreOffice %PRODUCT_RELEASE%/LINUXExample.out)</td> <tr>
</tr> <td class="cell20"><b>OO_SDK_URE_HOME</b></td>
<tr> <td class="cell80">Path to an existing UNO
<td class="cell20"><b>SDK_AUTO_DEPLOYMENT</b></td> Runtime Environment installation, e.g.
<td class="cell80">If this variable is set, the component examples are automatically deployed into the Office installation referenced by &quot;/opt/libreoffice/ure&quot;. Exactly one
OFFICE_HOME. See also chapter <a href="http://wiki.openoffice.org/wiki/Documentation/DevGuide/Extensions/unopkg" title="link to the &quot;Extension Manager - unopkg&quot; chapter in the Developer's Guide">&quot;Extension Manager - unopkg&quot;</a> from the Developer's Guide. of OFFICE_HOME and OO_SDK_URE_HOME must be
This variable is only relevant when OFFICE_HOME is set.</td> set. The other should be either unset or set
</tr> to an empty value.</td>
</table> </tr>
<p>You must run the <b>setsdkenv_XXX</b> script every time you want to <tr>
use the configured SDK environment. The settings are local for the current <td class="cell20"><b>OO_SDK_HOME</b></td>
shell on Windows or the new started shell on UNIX. On UNIX you <td class="cell80">Path to the SDK root
can now source the prepared environment directory, e.g.
script file (&quot;setsdkenv_unix.sh&quot;) to prepare &quot;/opt/libreoffice/sdk&quot;</td>
your current shell instead of starting a new shell.</p> </tr>
</td> <tr>
</tr> <td class="cell20"><b>OO_SDK_JAVA_HOME</b></td>
<tr valign="middle"> <td class="cell80">Path to a JDK root directory.
<td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td> The JDK is <b>optional</b> and only necessary
</tr> if you like to run the Java examples or if you
<tr> like to use the SDK environment to develop
<td colspan="2"> your own Java solution.</td>
<p class="head2">Manual Setting</p> </tr>
<p>If you do not want to use the script to set your working <tr>
environment, you must set the appropriate environment variables <td class="cell20"><b>OO_SDK_CPP_HOME</b></td>
yourself. The script sets the following environment variables:</p> <td class="cell80">Path to the C++ compiler (on
<p class="head3">Common Environment Variables</p> Windows, the directory where the
<table class="table4"> &quot;<i>vcvar32.bat</i>&quot; file can be
<tr valign="top"> found). The C++ compiler is <b>optional</b>
<td class="cell20">OO_SDK_NAME</td> and only necessary for building the C++
<td class="cell80">See description <a href="#oosdkname" title="link to the description of the environment variable OO_SDK_NAME">above</a>.</td> examples.</td>
</tr> </tr>
<tr valign="top"> <tr>
<td class="cell20">OO_SDK_URE_BIN_DIR</td> <td class="cell20"><b>OO_SDK_CLI_HOME</b></td>
<td class="cell80">The path within the chosen office or URE <td class="cell80">Path to the C# compiler and
installation where binary executables are located (e.g., VB.NET compiler (on Windows, this directory
<i>$OFFICE_HOME/program</i> for an office installation, or can be found under the system directory (e.g.
<i>$OO_SDK_URE_HOME/bin</i> for a Unix URE installation).</td> c:\WINXP\Microsoft.NET\Framework\v1.0.3705).
</tr> The compilers are <b>optional</b> and only
<tr valign="top"> necessary for building the CLI examples.<br/>
<td class="cell20">OO_SDK_URE_LIB_DIR</td> <b>Note: Windows only!</b></td>
<td class="cell80">The path within the chosen office or URE </tr>
installation where dynamic libraries are located (e.g., <tr>
<i>$OFFICE_HOME/program</i> for an office installation, or <td class="cell20"><b>OO_SDK_MAKE_HOME</b></td>
<i>$OO_SDK_URE_HOME/lib</i> for a Unix URE installation).</td> <td class="cell80">Path to GNU make.</td>
</tr> </tr>
<tr valign="top"> <tr>
<td class="cell20">OO_SDK_URE_JAVA_DIR</td> <td class="cell20"><b>OO_SDK_ZIP_HOME</b></td>
<td class="cell80">The path within the chosen office or URE <td class="cell80">Path to the 'zip' tool.</td>
installation where Java JARs are located (e.g., </tr>
<i>$OFFICE_HOME/program/classes</i> for an office installation, or <tr>
<i>$OO_SDK_URE_HOME/share/java</i> for a Unix URE installation).</td> <td class="cell20"><b>OO_SDK_CAT_HOME</b></td>
</tr> <td class="cell80">Path to the 'cat' tool.</td>
<tr valign="top"> </tr>
<td class="cell20">CLASSPATH</td> <tr>
<td class="cell80"> <td class="cell20"><b>OO_SDK_SED_HOME</b></td>
=<i>$OO_SDK_URE_JAVA_DIR/juh.jar; <td class="cell80">Path to the 'sed' tool.</td>
$OO_SDK_URE_JAVA_DIR/jurt.jar; </tr>
$OO_SDK_URE_JAVA_DIR/ridl.jar; <tr>
$OO_SDK_URE_JAVA_DIR/unoloader.jar; <td class="cell20"><b>OO_SDK_OUTPUT_DIR</b></td>
[$OO_SDK_URE_JAVA_DIR/unoil.jar;] <td class="cell80">Path to an existing directory
$CLASSPATH</i><br/> where the example output is generated. The
<p>The classpath will be set or extended to the necessary jar files of output directory is <b>optional</b>, by
the specified office installation. (<i>unoil.jar</i> is only included default the output is generated in the SDK
when OFFICE_HOME is set.)</p> directory itself. If an output directory is
</td> specified, the output is generated in a SDK
</tr> dependent subdirectory in this directory (e.g.
<tr valign="top"> &lt;OO_SDK_OUTPUT_DIR&gt; /LibreOffice
<td class="cell20">OFFICE_PROGRAM_PATH</td> %PRODUCT_RELEASE%/LINUXExample.out)</td>
<td class="cell80">=<i>$OFFICE_HOME/program</i><br/> </tr>
<p>This variable is used to find, for example, the office type library and <tr>
the UNO package deployment tool. This variable is only relevant when <td class="cell20"><b>SDK_AUTO_DEPLOYMENT</b></td>
OFFICE_HOME is set.</p> <td class="cell80">If this variable is set, the
</td> component examples are automatically deployed
</tr> into the Office installation referenced by
<tr valign="top"> OFFICE_HOME. See also chapter
<td class="cell20">UNO_PATH</td> <a href="http://wiki.openoffice.org/wiki/Documentation/DevGuide/Extensions/unopkg" title="link to the &quot;Extension Manager - unopkg&quot; chapter in the Developer's Guide">&quot;Extension Manager - unopkg&quot;</a>
<td class="cell80">=<i>$OFFICE_PROGRAM_PATH</i><br/> from the Developer's Guide. This variable is
<p>This variable is used to ensure that the new C++ UNO bootstrap only relevant when OFFICE_HOME is set.</td>
mechanism uses the configured office installation of the SDK. Normally </tr>
the bootstrap mechanism finds the default office installation for the </table>
user on the system. This variable is optional but is set from the scripts <p>You must run the <b>setsdkenv_XXX</b> script
to ensure a homogeneous environment. Especially useful during development every time you want to use the configured SDK
where you might have more than one office installation installed. This environment. The settings are local for the
variable is only relevant when OFFICE_HOME is set.</p> current shell on Windows or the new started shell
</td> on UNIX. On UNIX you can now source the prepared
</tr> environment script file
</table> (&quot;setsdkenv_unix.sh&quot;) to prepare your
<p class="head3">Environment Variables for UNIX</p> current shell instead of starting a new shell.</p>
<p class="head4">Solaris</p> </td>
<table class="table4"> </tr>
<tr valign="top"> <tr valign="middle">
<td class="cell20">LD_LIBRARY_PATH</td> <td colspan="2"><img class="line" src="images/sdk_line-1.gif"/></td>
<td class="cell80">=<i>$OO_SDK_URE_LIB_DIR: $OO_SDK_HOME/(solsparc|solintel)/lib: $LD_LIBRARY_PATH</i><br/> </tr>
<p>The LD_LIBRARY_PATH will be set or will be extended by the office/URE <tr>
library path, the platform dependent lib directory for several additional <td colspan="2">
libraries.</p> <p class="head2">Manual Setting</p>
</td> <p>If you do not want to use the script to set your
</tr> working environment, you must set the appropriate
<tr valign="top"> environment variables yourself. The script sets
<td class="cell20">PATH</td> the following environment variables:</p>
<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_URE_BIN_DIR: $PATH</i><br/> <p class="head3">Common Environment Variables</p>
<p>The PATH variable will be extended by the paths for the SDK development <table class="table4">
tools, the compiler, the JDK, GNU make, the zip tool and the <tr valign="top">
OO_SDK_URE_BIN_DIR, where the compiler or the JDK are <td class="cell20">OO_SDK_NAME</td>
optional.</p> <td class="cell80">See description
</td> <a href="#oosdkname" title="link to the description of the environment variable OO_SDK_NAME">above</a>.</td>
</tr> </tr>
<tr> <tr valign="top">
<td colspan="2" class="cell80">When OO_SDK_URE_HOME is set, the script <td class="cell20">OO_SDK_URE_BIN_DIR</td>
additionally creates symbolic links to the public dynamic libraries of <td class="cell80">The path within the chosen
the URE in <i>$OO_SDK_HOME/(solsparc|solintel)/lib</i>, which are office or URE installation where binary
needed for linking.</td> executables are located (e.g.,
</tr> <i>$OFFICE_HOME/program</i> for an office
</table> installation, or <i>$OO_SDK_URE_HOME/bin</i>
<p class="head4">Linux</p> for a Unix URE installation).</td>
<table class="table4"> </tr>
<tr valign="top"> <tr valign="top">
<td class="cell20">LD_LIBRARY_PATH</td> <td class="cell20">OO_SDK_URE_LIB_DIR</td>
<td class="cell80">=<i>$OO_SDK_URE_LIB_DIR: $SDK_HOME/linux/lib: $LD_LIBRARY_PATH</i><br/> <td class="cell80">The path within the chosen
<p>The LD_LIBRARY_PATH will be set or will be extended by the office/URE office or URE installation where dynamic
library path, the platform dependent lib directory for some additional libraries are located (e.g.,
libraries.</p> <i>$OFFICE_HOME/program</i> for an office
</td> installation, or <i>$OO_SDK_URE_HOME/lib</i>
</tr> for a Unix URE installation).</td>
<tr valign="top"> </tr>
<td class="cell20">PATH</td> <tr valign="top">
<td class="cell80">=<i>$OO_SDK_HOME/linux/bin:$OO_SDK_MAKE_HOME: $OO_SDK_ZIP_HOME: [$OO_SDK_CPP_HOME:] [$OO_SDK_JAVA_HOME/bin:] $OO_SDK_URE_BIN_DIR: $PATH</i><br/> <td class="cell20">OO_SDK_URE_JAVA_DIR</td>
<p>The PATH variable will be extended by the paths for the SDK development <td class="cell80">The path within the chosen
tools, the compiler, the JDK, GNU make, the zip tool and the office or URE installation where Java JARs are
OO_SDK_URE_BIN_DIR, where the compiler and the JDK are located (e.g.,
optional.</p> <i>$OFFICE_HOME/program/classes</i> for an
</td> office installation, or
</tr> <i>$OO_SDK_URE_HOME/share/java</i> for a Unix
<tr> URE installation).</td>
<td colspan="2" class="cell80">When OO_SDK_URE_HOME is set, the script </tr>
additionally creates symbolic links to the public dynamic libraries of <tr valign="top">
the URE in <i>$OO_SDK_HOME/linux/lib</i>, which are needed for <td class="cell20">CLASSPATH</td>
linking.</td> <td class="cell80">=<i>$OO_SDK_URE_JAVA_DIR/juh.jar;
</tr> $OO_SDK_URE_JAVA_DIR/jurt.jar;
</table> $OO_SDK_URE_JAVA_DIR/ridl.jar;
<p class="head3">Environment Variables for Windows</p> $OO_SDK_URE_JAVA_DIR/unoloader.jar;
<table class="table4"> [$OO_SDK_URE_JAVA_DIR/unoil.jar;]
<tr valign="top"> $CLASSPATH</i><br/>
<td class="cell20">PATH</td> <p>The classpath will be set or extended to
<td class="cell80">=<i>%OO_SDK_HOME%\windows\bin; %OO_SDK_MAKE_HOME%; %OO_SDK_ZIP_HOME%; [%OO_SDK_CLI_HOME%;] [%OO_SDK_CPP_HOME%;] [%OO_SDK_JAVA_HOME%\bin;] %OO_SDK_URE_BIN_DIR%; %PATH%</i><br/> the necessary jar files of the specified
<p>The PATH variable will be extended by the paths for the SDK development office installation. (<i>unoil.jar</i> is
tools, the compiler, the JDK, GNU make, the zip tool and the only included when OFFICE_HOME is set.)</p>
OO_SDK_URE_BIN_DIR.</p> </td>
</td> </tr>
</tr> <tr valign="top">
<tr valign="top"> <td class="cell20">OFFICE_PROGRAM_PATH</td>
<td class="cell20">LIB</td> <td class="cell80">=<i>$OFFICE_HOME/program</i><br/>
<td class="cell80">=<i>%OO_SDK_HOME%\windows\lib; %LIB%</i><br/> <p>This variable is used to find, for example,
<p>The LIB variable will be extended by the path to the import libraries the office type library and the UNO package
that are necessary for Windows.</p> deployment tool. This variable is only
</td> relevant when OFFICE_HOME is set.</p>
</tr> </td>
<tr valign="top"> </tr>
<td colspan="2" class="cell80">In addition to setting these environment <tr valign="top">
variables, the script calls the &quot;<i>vcvar32.bat</i>&quot; batch file <td class="cell20">UNO_PATH</td>
which is provided by the Microsoft Developer Studio to set the necessary <td class="cell80">=<i>$OFFICE_PROGRAM_PATH</i><br/>
environment variables for the compiler.</td> <p>This variable is used to ensure that the
</tr> new C++ UNO bootstrap mechanism uses the
</table> configured office installation of the SDK.
</td> Normally the bootstrap mechanism finds the
</tr> default office installation for the user on
</table> the system. This variable is optional but is
</td> set from the scripts to ensure a homogeneous
</tr> environment. Especially useful during
</table> development where you might have more than
</td> one office installation installed. This
</tr> variable is only relevant when OFFICE_HOME
</table> is set.</p>
</div> </td>
<div id="Footer"> </tr>
<div id="FooterText"> </table>
<p> <p class="head3">Environment Variables for UNIX</p>
Copyright © 2000, 2014 LibreOffice contributors. All rights reserved. <p class="head4">Solaris</p>
<br/> <table class="table4">
LibreOffice was created by The Document Foundation, <tr valign="top">
based on Apache OpenOffice, which is Copyright 2011 <td class="cell20">LD_LIBRARY_PATH</td>
The Apache Software Foundation. <td class="cell80">=<i>$OO_SDK_URE_LIB_DIR:
<br/> $OO_SDK_HOME/(solsparc|solintel)/lib:
The Document Foundation acknowledges all community members, please find more info <a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>. $LD_LIBRARY_PATH</i><br/>
</p> <p>The LD_LIBRARY_PATH will be set or will be
<p> extended by the office/URE library path, the
&nbsp; platform dependent lib directory for several
</p> additional libraries.</p>
<p> </td>
<a href="http://www.documentfoundation.org/privacy" target="_blank">Privacy Policy</a> | <a href="http://www.documentfoundation.org/imprint" target="_blank">Impressum (Legal Info)</a> </tr>
| Copyright information: The source code of LibreOffice is licensed under the Mozilla Public License v2.0 (<a href="http://www.libreoffice.org/download/license/" target="_blank">MPLv2</a>). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our <a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>. <tr valign="top">
</p> <td class="cell20">PATH</td>
</div> <td class="cell80">=<i>$OO_SDK_HOME/(solsparc|solintel)/bin:$OO_SDK_MAKE_HOME:
</div> $OO_SDK_ZIP_HOME: [$OO_SDK_CPP_HOME:]
</div> [$OO_SDK_JAVA_HOME/bin:]
$OO_SDK_URE_BIN_DIR: $PATH</i><br/>
<p>The PATH variable will be extended by the
paths for the SDK development tools, the
compiler, the JDK, GNU make, the zip tool
and the OO_SDK_URE_BIN_DIR, where the
compiler or the JDK are optional.</p>
</td>
</tr>
<tr>
<td colspan="2" class="cell80">When
OO_SDK_URE_HOME is set, the script
additionally creates symbolic links to the
public dynamic libraries of the URE in
<i>$OO_SDK_HOME/(solsparc|solintel)/lib</i>,
which are needed for linking.</td>
</tr>
</table>
<p class="head4">Linux</p>
<table class="table4">
<tr valign="top">
<td class="cell20">LD_LIBRARY_PATH</td>
<td class="cell80">=<i>$OO_SDK_URE_LIB_DIR:
$SDK_HOME/linux/lib:
$LD_LIBRARY_PATH</i><br/>
<p>The LD_LIBRARY_PATH will be set or will be
extended by the office/URE library path, the
platform dependent lib directory for some
additional libraries.</p>
</td>
</tr>
<tr valign="top">
<td class="cell20">PATH</td>
<td class="cell80">=<i>$OO_SDK_HOME/linux/bin:$OO_SDK_MAKE_HOME:
$OO_SDK_ZIP_HOME: [$OO_SDK_CPP_HOME:]
[$OO_SDK_JAVA_HOME/bin:]
$OO_SDK_URE_BIN_DIR: $PATH</i><br/>
<p>The PATH variable will be extended by the
paths for the SDK development tools, the
compiler, the JDK, GNU make, the zip tool
and the OO_SDK_URE_BIN_DIR, where the
compiler and the JDK are optional.</p>
</td>
</tr>
<tr>
<td colspan="2" class="cell80">When
OO_SDK_URE_HOME is set, the script
additionally creates symbolic links to the
public dynamic libraries of the URE in
<i>$OO_SDK_HOME/linux/lib</i>, which are
needed for linking.</td>
</tr>
</table>
<p class="head3">Environment Variables for Windows</p>
<table class="table4">
<tr valign="top">
<td class="cell20">PATH</td>
<td class="cell80">=<i>%OO_SDK_HOME%\windows\bin;
%OO_SDK_MAKE_HOME%; %OO_SDK_ZIP_HOME%;
[%OO_SDK_CLI_HOME%;] [%OO_SDK_CPP_HOME%;]
[%OO_SDK_JAVA_HOME%\bin;]
%OO_SDK_URE_BIN_DIR%; %PATH%</i><br/>
<p>The PATH variable will be extended by the
paths for the SDK development tools, the
compiler, the JDK, GNU make, the zip tool
and the OO_SDK_URE_BIN_DIR.</p>
</td>
</tr>
<tr valign="top">
<td class="cell20">LIB</td>
<td class="cell80">=<i>%OO_SDK_HOME%\windows\lib;
%LIB%</i><br/>
<p>The LIB variable will be extended by the
path to the import libraries that are
necessary for Windows.</p>
</td>
</tr>
<tr valign="top">
<td colspan="2" class="cell80">In addition to
setting these environment variables, the
script calls the
&quot;<i>vcvar32.bat</i>&quot; batch file
which is provided by the Microsoft Developer
Studio to set the necessary environment
variables for the compiler.</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
</div> </div>
<div id="Footer">
<div id="FooterText">
<p>Copyright © 2000, 2014 LibreOffice contributors. All rights
reserved.<br/>
LibreOffice was created by The Document Foundation, based on
Apache OpenOffice, which is Copyright 2011 The Apache Software
Foundation.<br/>
The Document Foundation acknowledges all community members, please
find more info
<a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>.</p>
<p>&nbsp;</p>
<p><a href="http://www.documentfoundation.org/privacy" target="_blank">Privacy Policy</a>
|
<a href="http://www.documentfoundation.org/imprint" target="_blank">Impressum (Legal Info)</a>
| Copyright information: The source code of LibreOffice is
licensed under the Mozilla Public License v2.0
(<a href="http://www.libreoffice.org/download/license/" target="_blank">MPLv2</a>).
"LibreOffice" and "The Document Foundation" are registered
trademarks of their corresponding registered owners or are in
actual use as trademarks in one or more countries. Their
respective logos and icons are also subject to international
copyright laws. Use thereof is explained in our
<a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>.</p>
</div>
</div> </div>
</body> </div>
</div>
</div>
</body>
</html> </html>