odk/README.md

   1 # Office Development Kit (odk)
   2
   3 Office development kit (`odk`) - implements the first step on the way to the LibreOffice SDK
   4 tarball.
   5
   6 Part of the SDK; to build you need to add `--enable-odk`.
   7
   8
   9 ## Testing the Examples:
  10
  11 * The easiest way on Linux and macOS is to run `make odk.subsequentcheck`
  12
  13 * The way that also works on Windows is to go to `instdir/sdk` (don't try directly in `odk/`)
  14
  15 * See <https://api.libreoffice.org/docs/install.html> how to set up the SDK.
  16
  17     * When asked about it during configuration, tell the SDK to do automatic
  18       deployment of the example extensions that get built.
  19
  20 * In a shell set up for SDK development, build (calling `make`) and test
  21   (following the instructions given at the end of each `make` invocation) each
  22   of the SDK's `examples/` sub-directories.
  23
  24     * An example script to build (though not test) the various examples in batch
  25       mode is
  26
  27         `find examples \( -type d -name nativelib -prune \) -o \`
  28         `\( -name Makefile -a -print -a \( -execdir make \; -o -quit \) \)`
  29
  30         (Note that one of the example extensions asks you to accept an example
  31         license on stdin during deployment.)