FreeBSD OpenOffice.org porting status page : How to use SDK (OOo 2.x)

$Id: sdk2.html,v 1.4 2005/08/22 05:57:57 xxjack12xx Exp $

by OpenOffice.org porting team, NAKATA, Maho, and Jackson Low

How to use SDK (OOo 2.x series)

This page explains how to use SDK. Since OpenOffice.org 2.0 is not released at the moment, this page is based on 1.9m107 (milestone 107).

Install OpenOffice.org 2.0 for FreeBSD
You know what I mean :)
Install gmake
If you haven't installed gmake, please install it.
```
# cd /usr/ports/devel/gmake ; make install clean
```
Install Java (optional, but recommended for first try)
Ah, you don't like Java :)
```
# cd /usr/ports/java/jdk14 ; make install clean
```
Obtain SDK
You can obtain SDK here. Please make sure you obtain the SDK for the operating system you are using or make it by yourself. Instructions for builing SDK are described in the How to build section on the main page.

Setting up SDK

% make /work/tmp
% cd /work/tmp
% tar zxf <somewhere>/OOo_1.9m107_FreeBSD54Intel_sdk.tar.gz
% cd OpenOffice.org2.0_SDK/
% ./configure

 *** Configure your SDK environment ***

 Enter the Office Software Development Kit directory [/work/tmp/OpenOffice.org2. 0_SDK]:
 Enter the Office installation directory []: /usr/local/openoffice.org1.9m107/
 Enter GNU make (3.79.1 or higher) tools directory [/usr/local/bin]:
 Enter zip (2.3 or higher) tool directory [/usr/local/bin]:
 C++ compilers where for example a language binding exist:
  - Solaris, Sun WorkShop 6 update 1 C++ 5.2 2000/09/11 or higher
  - Linux, GNU C++ compiler, gcc version 3.0.1 or higher
 Enter the the location of the C++ compiler (optional) [/usr/bin]:
 Enter the Java SDK (1.4.1_01 or higher) installation directory  (optional) []: /usr /local/jdk1.4.2/
 Default output directory is the SDK directory itself.
 Enter an existing directory if you prefer a different output directory (optional) []:
 Automatic deployment of UNO components (YES/NO) [YES]:

 *********************************************************************
 * ... your SDK environment has been prepared.
 * For each time you want to use this configured SDK environment, you
 * have to run the "setsdkenv_unix" script file!
 * Alternatively can you source one of the scripts "setsdkenv_unix.sh"
 * or "setsdkenv_unix.csh" to get an environment without starting
 * a new shell.
 *********************************************************************

Just hit enter to accept the defaults, except for two points:
First,

 Enter the Openoffice installation directory []: /usr/local/openoffice.org1.9m107/

You must enter (basically from packages or ports, the installation directory is /usr/local/openoffice.org1.9m107/ )
Second,

Enter Java SDK (1.4.1_01 or higher) installation directory [/usr/local]: /usr/local/jdk1.4.2

Same as above; please input `/usr/local/jdk1.4.2'.

Use of SDK
After you have completed your SDK setup, you need to set environmental variables before it can used. Please type:
```
% ./setsdkenv_unix
Starting shell with SDK environment.
```
You can now use OpenOffice.org SDK. Congratulations!

Sample programs

You might also be interested in the sample programs. Type ./setsdkenv_unix as described above to use them.

% ./setsdkenv_unix
Starting shell with SDK environment.

Next change dir to examples/DevelopersGuide/FirstSteps/

% cd examples/DevelopersGuide/FirstSteps/

This directory contains some very basic sample programs. First, type gmake to prepare next steps.

% gmake
mkdir -p ../../../FREEBSDexample.out/class/FirstStepsExamples
mkdir -p ../../../FREEBSDexample.out/class/FirstStepsExamples
"/usr/local/jdk1.4.2//bin/javac"  -classpath "/usr/local/openoffice.org1.9m107//program/classes/jurt.jar:/usr/local/openoffice.org1.9m107//program/classes/unoil.jar:/usr/local/openoffice.org1.9m107//program/classes/ridl.jar:/usr/local/openoffice.org1.9m107//program/classes/juh.jar:../../../FREEBSDexample.out/class/FirstStepsExamples" -d ../../../FREEBSDexample.out/class/FirstStepsExamples FirstUnoContact.java
rm -f ../../../FREEBSDexample.out/class/FirstStepsExamples/FirstUnoContact.jar
mkdir -p ../../../FREEBSDexample.out/class/FirstStepsExamples
cd ../../../FREEBSDexample.out/class/FirstStepsExamples && "/usr/local/jdk1.4.2//bin/jar" cvfm FirstUnoContact.jar FirstUnoContact.mf FirstUnoContact.class
....
....
--------------------------------------------------------------------------------
Please use one of the following commands to execute the examples!
-
gmake FirstConnection.run
gmake FirstLoadComponent.run
gmake HelloTextTableShape.run
--------------------------------------------------------------------------------

Type gmake FirstConnection.run instead of typing make FirstConnection.run, since name of GNU make is gmake for (usual) FreeBSD.

% gmake FirstUnoContact.run
"/usr/local/jdk1.4.2//bin/java" -Dcom.sun.star.lib.loader.unopath="/usr/local/openoffice.org1.9m107//program" -jar ../../../FREEBSDexample.out/class/FirstStepsExamples/FirstUnoContact.jar
Connected to a running office ...
remote ServiceManager is available

Connection is established and sample program worked! Congratulations!
Next example is FirstLoadComponent. This program opens a calc sheet and insert 21 to A1, A2 cell. Do sum of them and result is written in A3 cell.

% gmake FirstLoadComponent.run
"/usr/local/jdk1.4.2//bin/java" -Dcom.sun.star.lib.loader.unopath="/usr/local/openoffice.org1.9m107//program" -jar ../../../FREEBSDexample.out/class/FirstStepsExamples/FirstLoadComponent.jar
Connected to a running office ...
com.sun.star.sheet.XSpreadsheet
Formula cell in column 0, row 2 contains =SUM(A1:A2)

HelloTextTableShape is interesting. This automatically creates Writer, Calc, and Draw!

% gmake HelloTextTableShape.run

Tips
please refer examples.html
Changes between 1.1 and 2.0
We can invoke OOo to listen on a TCP/IP port. We don't need to set it up.
Troubleshooting
N/A