Simplify installation of applications and libraries

Add "install" and "installDir" convenience properties to our
Application, DynamicLibrary and StaticLibrary items, so users are no
longer required to write groups with file tag filters for the normal
installation case. The installDir property has a suitable default value
for the respective target platform, as does qbs.installPrefix.

[ChangeLog] The Application, DynamicLibrary and StaticLibrary items now
have properties for more convenient installation of target binaries.

Task-number: QBS-229
Change-Id: I9cfa4c02a7c555b0af637257da63967cd62cc119
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@qt.io>
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>

3 files changed, 93 insertions, 9 deletions

diff --git a/doc/reference/items/convenience/application.qdoc b/doc/reference/items/convenience/application.qdoc
index de2bbae48..3c87f51f6 100644
--- a/doc/reference/items/convenience/application.qdoc
+++ b/doc/reference/items/convenience/application.qdoc
@@ -39,9 +39,30 @@
     An Application item is a \l{Product} of the \l{Product::}{type}
     \c "application".
 
-    It exists for the convenience of project file authors.
-
     \note On Android, an Application item instead builds a shared library for
     products whose \l{Product::}{consoleApplication} property is set to
     \c false.
 */
+
+/*!
+    \qmlproperty bool Application::install
+
+    If \c{true}, the executable that is produced when building the application will be installed
+    to \l installDir.
+
+    \defaultvalue \c false
+    \since Qbs 1.13
+*/
+
+/*!
+    \qmlproperty string Application::installDir
+
+    Where to install the executable that is produced when building the application, if \l install
+    is enabled.
+
+    The value is appended to \l{qbs::installPrefix}{qbs.installPrefix}
+    when constructing the actual installation directory.
+
+    \defaultvalue \c Applications if the app is a \l{bundle::isBundle}{bundle}, \c bin otherwise.
+    \since Qbs 1.13
+*/
diff --git a/doc/reference/items/convenience/dynamiclibrary.qdoc b/doc/reference/items/convenience/dynamiclibrary.qdoc
index 27aa978d1..488aef3eb 100644
--- a/doc/reference/items/convenience/dynamiclibrary.qdoc
+++ b/doc/reference/items/convenience/dynamiclibrary.qdoc
@@ -38,7 +38,7 @@
     \brief Dynamic library.
 
     A DynamicLibrary item is a \l{Product} of the \l{Product::}{type}
-    \c "dynamiclibrary". It exists for the convenience of project file authors.
+    \c "dynamiclibrary".
 
     For Android targets, the following applies:
     \list
@@ -48,3 +48,50 @@
     \endlist
 */
 
+/*!
+    \qmlproperty bool DynamicLibrary::install
+
+    If \c{true}, the library will be installed to \l installDir.
+
+    \defaultvalue \c false
+    \since Qbs 1.13
+*/
+
+/*!
+    \qmlproperty string DynamicLibrary::installDir
+
+    Where to install the library, if \l install is enabled. On Unix, the symbolic links
+    are also installed to this location.
+
+    The value is appended to \l{qbs::installPrefix}{qbs.installPrefix}
+    when constructing the actual installation directory.
+
+    \defaultvalue \c Library/Frameworks if the library is a \l{bundle::isBundle}{bundle},
+                  otherwise \c bin for Windows and \c lib for Unix-like targets.
+    \since Qbs 1.13
+*/
+
+/*!
+    \qmlproperty bool DynamicLibrary::installImportLib
+
+    If \c{true}, the import library will be installed to \l importLibInstallDir.
+    This property is only relevant for Windows targets.
+    Enable it if you want to create a development package.
+
+    \defaultvalue \c false
+    \since Qbs 1.13
+*/
+
+/*!
+    \qmlproperty string DynamicLibrary::importLibInstallDir
+
+    Where to install the import library, if \l installImportLib is enabled.
+
+    The value is appended to \l{qbs::installPrefix}{qbs.installPrefix}
+    when constructing the actual installation directory.
+
+    This property is only relevant for Windows targets.
+
+    \defaultvalue \c lib
+    \since Qbs 1.13
+*/
diff --git a/doc/reference/items/convenience/staticlibrary.qdoc b/doc/reference/items/convenience/staticlibrary.qdoc
index a7a94cc43..cd459cf6e 100644
--- a/doc/reference/items/convenience/staticlibrary.qdoc
+++ b/doc/reference/items/convenience/staticlibrary.qdoc
@@ -37,11 +37,27 @@
     \brief Static library.
 
     A StaticLibrary item is a \l{Product}{product} of the \l{Product::}{type}
-    \c "staticlibrary" that is normally entirely equivalent to the following:
+    \c "staticlibrary".
+*/
+
+/*!
+    \qmlproperty bool StaticLibrary::install
+
+    If \c{true}, the library will be installed to \l installDir.
+
+    \defaultvalue \c false
+    \since Qbs 1.13
+*/
+
+/*!
+    \qmlproperty string StaticLibrary::installDir
+
+    Where to install the library, if \l install is enabled.
+
+    The value is appended to \l{qbs::installPrefix}{qbs.installPrefix}
+    when constructing the actual installation directory.
 
-    \code
-    Product {
-        type: "staticlibrary"
-    }
-    \endcode
+    \defaultvalue \c Library/Frameworks if the library is a \l{bundle::isBundle}{bundle},
+                  \c lib otherwise.
+    \since Qbs 1.13
 */