summaryrefslogtreecommitdiff
path: root/odk/README.md
blob: c6499cf6801ddcca9469f903aaa890c29cd51558 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# Office Development Kit (odk)

Office development kit (`odk`) - implements the first step on the way to the LibreOffice SDK
tarball.

Part of the SDK; to build you need to add `--enable-odk`.


## Testing the Examples:

* The easiest way on Linux and macOS is to run `make odk.subsequentcheck`

* The way that also works on Windows is to go to `instdir/sdk` (don't try directly in `odk/`)

* See <https://api.libreoffice.org/docs/install.html> how to set up the SDK.

    * When asked about it during configuration, tell the SDK to do automatic
      deployment of the example extensions that get built.

* In a shell set up for SDK development, build (calling `make`) and test
  (following the instructions given at the end of each `make` invocation) each
  of the SDK's `examples/` sub-directories.

    * An example script to build (though not test) the various examples in batch
      mode is

        `find examples \( -type d -name nativelib -prune \) -o \`
        `\( -name Makefile -a -print -a \( -execdir make \; -o -quit \) \)`

        (Note that one of the example extensions asks you to accept an example
        license on stdin during deployment.)