summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorArttu Tarkiainen <arttu.tarkiainen@qt.io>2021-11-23 17:23:26 +0200
committerArttu Tarkiainen <arttu.tarkiainen@qt.io>2022-01-06 11:26:29 +0200
commit403e610e6b867dc840c4e78a344cac52bbe751c2 (patch)
tree746f263da474c1603ce14820d164cd37c97e95bc /doc
parent8985801a4e61fad34914ed04480d0240ece53c15 (diff)
Add support for moving child components with <TreeName>
Add new optional "moveChildren" attribute to <TreeName> element. Children of components declaring "moveChildren=true" attribute are calculated a value for an automatic tree name element. Multiple components in a single tree branch can declare a tree name, the order which the relocation happens is from leaf components to root components. Components may be moved under another tree name target. Components may be moved to an existing identifier part that does not have a component, for example in the following repository structure: rootA.childA rootB rootB.childB the "rootB" component can legally declare a "rootA" tree name. The tree names of components become static after installed. If a repository declares a new tree name for a component that is installed, it is only applied after updating in maintenance tool. Child components, which have an automatic tree name, are moved if the parent component is updated with a new tree name, however. Task-number: QTIFW-2380 Change-Id: I9c44a114d3c1248b7e2dd4f0b5cda0739af102f3 Reviewed-by: Katja Marttila <katja.marttila@qt.io>
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/package.xml2
-rw-r--r--doc/installerfw.qdoc8
2 files changed, 9 insertions, 1 deletions
diff --git a/doc/examples/package.xml b/doc/examples/package.xml
index 81792416c..216ccadb9 100644
--- a/doc/examples/package.xml
+++ b/doc/examples/package.xml
@@ -42,5 +42,5 @@
<Argument>@TargetDir@/Folder2</Argument>
</Operation>
</Operations>
- <TreeName>com.vendor.subcomponent</TreeName>
+ <TreeName moveChildren="true">com.vendor.subcomponent</TreeName>
</Package>
diff --git a/doc/installerfw.qdoc b/doc/installerfw.qdoc
index 14554f05a..043789722 100644
--- a/doc/installerfw.qdoc
+++ b/doc/installerfw.qdoc
@@ -976,6 +976,14 @@
location which is calculated from component name. Component names and tree names
must be unique. Optional.
+ Specifying \c{moveChildren="true"} attribute will also change the location of any
+ child components this component has. Children will move to the overwritten tree name,
+ keeping the relative location to their parent component.
+
+ One component branch in the install tree view can have multiple components
+ specifying a tree name. The order in which the location of components is changed
+ is from leaf to root components.
+
\endtable
\section2 Component Dependencies