desktop/test/deployment/dependencies/readme.txt

   1 #
   2 # This file is part of the LibreOffice project.
   3 #
   4 # This Source Code Form is subject to the terms of the Mozilla Public
   5 # License, v. 2.0. If a copy of the MPL was not distributed with this
   6 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   7 #
   8 # This file incorporates work covered by the following license notice:
   9 #
  10 #   Licensed to the Apache Software Foundation (ASF) under one or more
  11 #   contributor license agreements. See the NOTICE file distributed
  12 #   with this work for additional information regarding copyright
  13 #   ownership. The ASF licenses this file to you under the Apache
  14 #   License, Version 2.0 (the "License"); you may not use this file
  15 #   except in compliance with the License. You may obtain a copy of
  16 #   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  17 #
  18
  19 no-description.oxt, no-dependencies.oxt, empty-dependencies.oxt effectively have
  20 no dependencies and should thus install successfully.
  21
  22 broken-dependencies.oxt contains a malformed description.xml and should thus
  23 display an error and not install.
  24
  25 double-dependencies.oxt contains a description.xml with two dependencies
  26 elements.  This is not allowed by the spec but behaviour is unspecified.  In the
  27 current implementation, it combines the two elements, and thus finds two
  28 unsatisfied dependencies, displays the Unsatisfied Dependencies dialog and does
  29 not install.
  30
  31 version21.oxt contains a dependency on OOo 2.1 (and should thus only install in
  32 OOo 2.1 or later); version21ns.oxt is the same, but with a different way of
  33 using XML namespaces; version21other.oxt additionally contains an unsatisfied
  34 dependency (and should thus not install in any OOo version).  version22.oxt
  35 contains a dependency on OOo 2.2 (and should thus only install in OOo 2.2 or
  36 later).  version23.oxt contains a dependency on OOo 2.3 (and should thus only
  37 install in OOo 2.3 or later).  version10000.oxt contains a dependency on the
  38 hypothetical OOo version 10000 (and should thus not install in any OOo version).
  39 versionempty.oxt contains an empty value attribute and versionnone.oxt lacks the
  40 value attribute; neither is allowed by the spec, but the current implementation
  41 treats both as pre OOo 2.1 versions (and the extensions should thus install in
  42 OOo 2.1 or later).
  43
  44 maxversion30.oxt contains a maximal version dependency on OOo 3.0 (and should
  45 thus only install in OOo 3.0 or earlier, back to OOo 2.3, thanks to the
  46 additionally specified OpenOffice.org-minimal-version attribute).
  47 maxversion10000.oxt contains a maximal version dependency on the hypothetical
  48 OOo version 10000 (and should thus install in any OOo version 3.1 or later;
  49 OpenOffice.org-maximal-version was introduced in OOo 3.1, and no OpenOffice.org-
  50 minimal-version attribute is specified).  bad-minmaxversion.oxt contains a
  51 minimal version dependency on OOo 3.2 and a maximal version dependency on
  52 OOo 3.1 (and should thus not install in any OOo version).
  53
  54 minattr22.oxt contains a (hypothetical, most probably never satisfied)
  55 UNSATISFIED dependency with an OpenOffice.org-minimal-version attribute of
  56 "2.2" (and should thus install in OOo 2.3 or later); minattr23.oxt is similar,
  57 but with an OpenOffice.org-minimal-version attribute of "2.3" (and should thus
  58 also install in OOo 2.3 or later); minattr24.oxt is similar, but with an
  59 OpenOffice.org-minimal-version attribute of "2.4" (and should thus only install
  60 in OOo 2.4 or later).
  61
  62 All of the following testcases should result in the Unsatisfied Dependencies
  63 dialog being displayed and the extension not being installed:
  64
  65 unknown-dependency.oxt contains a dependency without a name attribute, and
  66 should thus display "Unknown" (localized).
  67
  68 funny-dependency.oxt, many-dependencies.oxt contain somewhat extreme input.
  69
  70 license-dependency.oxt contains both a license to be accepted by the user and
  71 dependencies.  What is important here is that the Unsatisfied Dependencies
  72 dialog is displayed, but not the license (as installation aborts as soon as
  73 unsatisfied dependencies are found).