Installing Files

To install your project, specify the necessary information in the project file:

 Application {
     Group {
         name: "Runtime resources"
         files: "*.qml"
         qbs.install: true
         qbs.installDir: "share/myproject"
     }
     Group {
         name: "The App itself"
         fileTagsFilter: "application"
         qbs.install: true
         qbs.installDir: "bin"
     }
 }

In this example, we want to install a couple of QML files and an executable.

When building, Qbs installs artifacts into the default root folder, namely <build root>/install-root. The qbs.installPrefix and qbs.installDir properties are appended to the root folder.

 qbs build qbs.installPrefix:/usr

In this example, the executable will be installed into the <build root>/install-root/usr/bin folder and the QML files will be installed into the <build root>/install-root/usr/share/myproject folder.

To skip installation during the build, use the --no-install option.

To override the default location, use the --install-root option of the qbs install command:

 qbs build --no-install qbs.installPrefix:/usr
 sudo qbs install --no-build --install-root /

In this example, artifacts will be installed directly into the /usr folder. Since the qbs install command implies build, we use the --no-build parameter to ensure that we do not accidentally rebuild the project, thereby changing the artifacts' owner to root.

Sometimes, it makes sense to install the application into a temporary root folder, keeping the same folder structure within that root folder as in the examples above; for instance, when building a Linux package such as deb or rmp. To install the application into the /tmp/myProjectRoot folder, use the following command:

 $ qbs install --install-root /tmp/myProjectRoot

In this example, the executable will be installed into the /tmp/myProjectRoot/usr/bin folder and QML files will be installed into the /tmp/myProjectRoot/usr/share/myproject folder.

To remove all files from the install root prior to installing, use the --clean-install-root parameter:

 qbs install --clean-install-root --install-root /tmp/myProjectRoot

For more information about how the installation path is constructed, see Installation Properties.