Hide last authors
Thomas Mortagne 2.1 1 Extensions can define dependencies. Those will automatically be installed by Extension Manager when installing the extension. It's also a good way to make sure the extension is installed on the right version of XWiki.
2
Thomas Mortagne 3.1 3 See also [[Maven repository handler documentation>>Extension.Extension Module.Repositories.Maven]] to have more details on how exactly to define dependencies in the Maven build.
4
Thomas Mortagne 9.1 5 {{toc/}}
6
Thomas Mortagne 4.1 7 = Optional dependencies =
Thomas Mortagne 2.1 8
Thomas Mortagne 7.1 9 It's possible to indicate that a dependency is optional. This means that Extension Manager will install all of them by default but optional dependencies won't have any impact on the validity of the extension:
Thomas Mortagne 4.1 10
Thomas Mortagne 2.1 11 * if the optional dependency install plan fail the extension is installed without it
12 * if the optional dependency is uninstalled it won't uninstall the extension
13 * if the optional dependency is missing at startup it won't make the extension invalid
14
Thomas Mortagne 6.1 15 {{info}}
Thomas Mortagne 7.1 16 Since 11.7RC1, in the context of Maven repositories, this apply only to extensions using the custom Maven property ##xwiki.extension.optionalIncluded## with ##true## to avoid going against Maven default behavior (for retro compatibility reasons it's ##true## by default for grouIds prefixes known to be XWiki often be extensions: "org.xwiki" and "com.xwiki"). See [[custom Maven properties>>Extension.Extension Module.Repositories.Maven||anchor="HCustomproperties"]] for more details.
Thomas Mortagne 6.1 17 {{/info}}
Thomas Mortagne 2.1 18
Thomas Mortagne 4.1 19 = Managed dependencies =
20
Thomas Mortagne 1.1 21 Since 8.1, Extension Manager support the concept of managed dependencies.
22
23 Its the same idea than Maven's {{code}}<dependencyManagement>{{/code}} element. It allows the following:
Thomas Mortagne 4.1 24
Thomas Mortagne 1.1 25 * indicate the version or other properties associated to a dependency in managed dependencies and just indicate the id in the actual dependencies
26 * overwrite the version or other properties associated to any corresponding transitive dependency
Thomas Mortagne 8.1 27
28 = Ignored dependencies =
29
30 Since 12.2 and 11.10.4 you can force Extension Manager to ignore a set of dependencies using the property #### in ##xwiki.properties## file:
31
32 {{code language="properties"}}
33 extension.ignoredDependencies=stax:stax
34 extension.ignoredDependencies=javax.xml.stream:stax-api
35 extension.ignoredDependencies=stax:stax-api
36 extension.ignoredDependencies=xalan:xalan
37 extension.ignoredDependencies=xalan:serializer
38 {{/code}}

Get Connected