[PRODUCTNAME] SDK
 
SDK home
Installation guide
 

The [PRODUCTNAME] SDK comes with a set of development tools, base libraries and jar files which can be used to develop Java/C++ components, to embed the [PRODUCTNAME] application in your own programs, or to use the API (scripting or remote control the office). For a complete working environment, we have some additional requirements:

[PRODUCTNAME] installation
The SDK works on top of an existing office installation and uses the same libraries as the office installation.
JDK (1.4.1_01 or higher)
A JDK is necessary for developing Java components or applications. An appropriate Java SDK can be found on http://java.sun.com/products.
C++ compiler
A C++ compiler is necessary for developing C++ components or applications. UNO depends on a compiler dependent language binding so that we use the appropriate compiler where a language binding exists:
Solaris, Sun WorkShop 6 update 1 C++ 5.2 2000/09/11
Linux, GNU C++ compiler, gcc version 3.0.1
Windows, Microsoft C++ Compiler, Microsoft Developer Studio 6.0 (cl, version 12.00.8168)
GNU make (3.79.1 or higher)
GNU make is used to build the examples of the SDK. GNU make is available from http://www.gnu.org, it can be ftped via ftp://ftp.gnu.org/gnu/make
NOTE: Windows user can find an executable of gnu make under http://www.nextgeneration.dk/gnu/make.zip. It is not recommended to use the Cygwin make, because it does not work well.

The SDK provides a configure script (Unix and WindowsNT/2000/XP) that asks for relevant directories (SDK, StarOffice, GNU make, Java, C++). After completing the configure script a new script will be created (WindowsNT//2000/XP and UNIX) to set the necessary environment variables for using the SDK and the required tools.

  • configure  -> for Unix
  • configureWindowsNT.bat  -> for WindowsNT/2000/XP

Other versions of the operating system Windows should use the batch program <OO_SDK_HOME>setsdkenv_windows.bat directly and adopt it to their local environment.

The first time you use the batch program, you must prepare it for your environment. Edit the script and set the following variables:

OFFICE_HOME path to an existing StarOffice™ or OpenOffice.org installation, e.g. "/usr/local/StarOffice6.0"
OO_SDK_HOME path to the SDK root directory, e.g. "/usr/local/StarOffice6.0SDK"
OO_SDK_JAVA_HOME path to the JDK
OO_SDK_CPP_HOME path to the C++ compiler (under windows the directory where the vcvar32.bat file can be found). The C++ compiler is optional and only necessary for building the C++ examples.
OO_SDK_MAKE_HOME path to GNU make.
SDK_AUTO_DEPLOYMENT if this variable is set, the component examples will be automatically deployed into the Office installation referenced by OFFICE_HOME. See also chapter "UNO Package installation" from the Developer's Guide.

If you do not want to use the script to set your working environment, you must set the appropriate environment variables by yourself. The script sets the following environment variables:

Environment variables for UNIX

Solaris

OFFICE_PROGRAM_PATH =$OFFICE_HOME/program
This variable is used to register example components automatically in your Office installation. If you do not want automatic registration, please comment this variable out in the script.
LD_LIBRARY_PATH =$OFFICE_PROGRAM_PATH:$OO_SDK_HOME/solsparc/lib:$LD_LIBRARY_PATH
The LD_LIBRARY_PATH will be set or will be extended by the office program path, the platform dependent lib directory for some additional libraries.
PATH =$OO_SDK_HOME/solsparc/bin:$OO_SDK_MAKE_HOME:$OO_SDK_CPP_HOME:$OO_SDK_JAVA_HOME/bin: $PATH
The PATH variable will be extended by the paths for the SDK development tools, the compiler, the JDK and GNU make.

Linux

OFFICE_PROGRAM_PATH =$OFFICE_HOME/program
This variable is used to register example components automatically in your Office installation. If you do not want automatic registration, comment this variable out in the script.
LD_LIBRARY_PATH =$OFFICE_PROGRAM_PATH:$SDK_HOM/linux/lib:$LD_LIBRARY_PATH
The LD_LIBRARY_PATH will be set or will be extended by the office program path, the platform dependent lib directory for some additional libraries.
PATH =$OO_SDK_HOME/linux/bin:$OO_SDK_MAKE_HOME:$OO_SDK_CPP_HOME:$OO_SDK_JAVA_HOME/bin: $PATH
The PATH variable will be extended by the paths for the SDK development tools, the compiler, the JDK and GNU make.


Environment variables for Windows

In addition to setting these environment variables, the script calls the "vcvar32.bat" batch file, which is provided by the Microsoft Developer Studio to set the necessary environment variables for the compiler.
OFFICE_PROGRAM_PATH =%OFFICE_HOME%\program
This variable is used to register example components automatically in your Office installation. If you don't want automatic registration, please comment this variable out in the script.
PATH =%OO_SDK_HOME%\windows\bin;%OO_SDK_MAKE_HOME%;%OO_SDK_CPP_HOME%;%OO_SDK_JAVA_HOME% \bin;%OFFICE_PROGRAM_PATH%;%PATH%
The PATH variable will be extended by the paths for the SDK development tools, the compiler, the JDK, GNU make and the <OFFICE_PROGRAM_PATH>.
LIB =%OO_SDK_HOME%\windows\lib;%LIB%
The LIB variable will be extended by the path to the import libraries which are necessary for windows.
Additionally to setting these environment variables the script calls the "vcvar32.bat" batch file which is provided by the Microsoft Developer Studio to set the necessary environment variables for the compiler.

 
 

Copyright 2003 Sun Microsystems, Inc.