Build and deployment
After generating the local build output, QV2QS deploys the converted app to Qlik Cloud through a series of automated steps.
When running a conversion without --unbuildOnly, QV2QS performs the following steps after generating the local build output:
- Create or reuse a Qlik Sense app on the tenant. QV2QS uses the
.qv2qs_sourcemarker in the output folder to locate the correct project for the source QVW file. For details, see Reusing an existing app. - Export a no-data QVF backup of the existing app (when reusing an existing app). Use
--noBackupto skip. - Upload sheet backgrounds, object background images, and button images to the app media library.
- Prepare sheets (when reusing an existing app). QV2QS records the publish state and rank of each existing sheet, removes the old sheets from the cloud app, and patches the local build output with the original cloud sheet IDs.
- Build the app on the tenant.
- Restore sheets (when reusing an existing app). QV2QS re-publishes sheets that were previously published and restores the original rank.
- Publish all converted sheets as base sheets (new apps only).
Sheet publishing
After building the app, QV2QS publishes every converted sheet as a base sheet. Base sheets are visible to all users who have access to the app. Without publishing, sheets remain personal objects that only the app owner can see.
Sheet publishing runs automatically in both Build to Qlik Cloud and Export QVF modes. In Export QVF mode, the published status is preserved inside the exported QVF file.
To skip sheet publishing, pass --noPublishSheets on the command line or disable Publish sheets in the wizard. When disabled, sheets remain unpublished and the app owner must publish them manually in Qlik Cloud.
When reusing an existing app (--reuseAppId or --appId), the standard publish step is replaced by an automatic restore step. QV2QS records the publish state of each sheet before the build, then re-publishes previously published sheets after the build completes. New sheets added in the current conversion are published as base sheets when the Publish sheets setting is enabled. Pass --noPublishSheets to leave new sheets unpublished.
Deployment arguments include --qsAppName, --spaceId, --reload, --noData, --noPublishSheets, and --unbuildOnly. For the full list, see Argument reference.