ApplicationInstaller QML Type

(obsolete) The package installation/removal/update part of the application manager. More...

Import Statement: import QtApplicationManager.SystemUI 2.0

Signals

Methods

Detailed Description

This class is obsolete since 5.14. It is provided to keep old source code working. We strongly advise against using it in new code. Use the new PackageManager instead.

Please be aware that the new PackageManager API expects package-IDs instead of application-IDs as is the case with this class. Since the new package format adds support for more than one application per package, this legacy API here has its limits in supporting the new features. It is strongly advised to only use the PackageManager API when dealing with new-style packages.

The background tasks handling the (de)installation process are the same between the old and new API, so the documentation for the task states in PackageManager holds true for this class as well.

If possible, all function calls and signals are forwarded to and from the PackageManager API. Exceptions are documented below in the detailed function and signal descriptions.

Note: The ApplicationInstaller singleton and its corresponding DBus API are only available if you specify a base directory for installed application manifests. See Configuration for details.

Signal Documentation

taskBlockingUntilInstallationAcknowledge(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskBlockingUntilInstallationAcknowledge(taskId).

Note: The corresponding handler is onTaskBlockingUntilInstallationAcknowledge.


taskFailed(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskFailed(taskId).

Note: The corresponding handler is onTaskFailed.


taskFinished(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskFinished(taskId).

Note: The corresponding handler is onTaskFinished.


taskProgressChanged(string taskId, qreal progress)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskProgressChanged(taskId, progress).

Note: The corresponding handler is onTaskProgressChanged.


taskRequestingInstallationAcknowledge(string taskId, object application, object packageExtraMetaData, object packageExtraSignedMetaData)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskRequestingInstallationAcknowledge(taskId, package, packageExtraMetaData, packageExtraSignedMetaData).

A subset of the contents of the package's manifest file is supplied via application as a JavaScript object. This object is constructed from the replacement function's Package object parameter. Since the manifest files changed in 5.14, only the following legacy keys are reported through this object: id, version, icon, displayIcon, name, displayName, baseDir, codeDir, manifestDir and installationLocationId.

Note: The corresponding handler is onTaskRequestingInstallationAcknowledge.


taskStarted(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskStarted(taskId).

Note: The corresponding handler is onTaskStarted.


taskStateChanged(string taskId, string newState)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskStateChanged(taskId, newState).

Note: The corresponding handler is onTaskStateChanged.


Method Documentation

void acknowledgePackageInstallation(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::acknowledgePackageInstallation(taskId).


list<string> activeTaskIds()

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::activeTaskIds(), same return value.


bool cancelTask(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::cancelTask(taskId), same return value.


int compareVersions(string version1, string version2)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::compareVersions(version1, version2), same return value.


object getInstallationLocation(string installationLocationId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This function became obsolete, because the new architecture only supports one single installation location (internal-0).

Returns an empty object in case the installationLocationId is not valid.


string installationLocationIdFromApplication(string id)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This function became obsolete, because the new architecture only supports one single installation location: it now always returns internal-0 if the application identified by id is installed or an empty string otherwise.


list<string> installationLocationIds()

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This function became obsolete, because the new architecture only supports one single installation location: it now always returns internal-0.


var installedApplicationExtraMetaData(string id)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::installedPackageExtraMetaData(), same return value.

Note: The replacement function PackageManager::installedPackageExtraMetaData expects a package-ID as parameter, while this function wants an application-ID as id.


var installedApplicationExtraSignedMetaData(string id)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::installedPackageExtraSignedMetaData(), same return value.

Note: The replacement function PackageManager::installedPackageExtraSignedMetaData expects a package-ID as parameter, while this function wants an application-ID as id.


int installedApplicationSize(string id)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::installedPackageSize(), same return value.

Note: The replacement function PackageManager::installedPackageSize expects a package-ID as parameter, while this function wants an application-ID as id.


string removePackage(string id, bool keepDocuments, bool force)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::removePackage(packageId, keepDocuments, force), same return value.

Note: The replacement function PackageManager::removePackage expects a package-ID as parameter, while this function wants an application-ID as id.


string startPackageInstallation(string installationLocationId, string sourceUrl)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::startPackageInstallation(sourceUrl), same return value.

Note: The replacement function PackageManager::startPackageInstallation is missing the first parameter (installationLocationId). This became obsolete, because the new architecture only supports one single installation location.


string taskApplicationId(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskPackageId(taskId).

Note: The replacement function PackageManager::taskPackageId returns an package-ID, while this function returns an application-ID.


enumeration taskState(string taskId)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::taskState(taskId), same return value.


int validateDnsName(string name, int minimalPartCount)

This method is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use PackageManager::validateDnsName(name, minimalPartCount), same return value.


© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.