Packaging Notes For Bundled Extensions

From Apache OpenOffice Wiki
Jump to: navigation, search



(As of OOo 3.3)

Bundled extensions are installed during OOo's setup and only the setup can install or remove them. That is, they cannot be modified by the extension manager, which would change the installation. The installer copies the extensions into the extensions directory of the "share" folder. For example, C:\Program Files\OpenOffice.org 3\share\extensions on Windows XP. Contrary to versions previous to OOo 3.3, unopkg need NOT be run as a post install step. To uninstall the extensions, the installer can simply delete the directories of the respective extensions.

Extensions are packaged as directories instead of ".oxt" files. For example, there is an extension Foo.oxt containing the files f1 and f2. The installer package must then contain the "unzipped" extension, that is a directory Foo (oxt can be ommitted). After installation, the file structure must be:

+ Office/share/extensions
  + Foo
  |- f1
  |- f2

During the packaging process one must make sure that all bundled extensions have different directory names, so as to prevent overwriting other extensions. In case of a name clash, one needs to modify the directory name of the extension appropriately.

The name of the folder should still reflect the name of the original extension file. This makes it easier to locate the extension in the file system. This name will also be used by the extension manager dialog if the extension does not provide a display name. Further details can be found here: Extensions_Integration_into_Installation_Set.

Bundled extension MUST have an identifier and version, otherwise OOo cannot determine reliably if a bundled extension was removed.

Executables contained in the extension must have the executable flag set. This is usually done by the extension manager, but not in case of bundled extensions.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages