Class PackageManager

Definition

Namespace:
Tizen.Applications
Assembly:
Tizen.Applications.PackageManager.dll

PackageManager class. This class has the methods and events of the PackageManager.

public static class PackageManager
Inheritance
object
PackageManager
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Methods

View Source

ClearAllCacheDirectory()

Clears all the application's internal and external cache directories.

Declaration
public static void ClearAllCacheDirectory()
Remarks

This method clears both the internal and external cache directories of the application. It ensures that any cached files are removed from the device storage. By calling this method, you can free up valuable space on the device and improve its performance. However, note that this operation may take some time depending on the amount of cached data present in the directories.

Exceptions
Type Condition
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.IO.IOException

Thrown when the method fails due to an internal IO error.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
System.SystemException

Thrown when the method failed due to an internal system error.
View Source

ClearCacheDirectory(string)

Clears the application's internal and external cache directories.

Declaration
public static void ClearCacheDirectory(string packageId)
Parameters
Type Name Description
string packageId

ID of the package.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.IO.IOException

Thrown when the method fails due to an internal I/O error.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
System.SystemException

Thrown when the method failed due to an internal system error.
View Source

ClearDataDirectory(string)

Clears the application's internal and external data directories.

Declaration
public static void ClearDataDirectory(string packageId)
Parameters
Type Name Description
string packageId

ID of the package.
Remarks

All files under data, shared/data, and shared/trusted in the internal storage are removed. And, if the external storage exists, then all files under data and shared/trusted in the external storage are also removed.

Exceptions
Type Condition
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.IO.IOException

Thrown when the method fails due to an internal IO error.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.SystemException

Thrown when the method fails due to an internal system error.
View Source

ClearUserData(string, string)

Removes a file or directory specified with path from user data internal storage for the application.

Declaration
public static void ClearUserData(string packageId, string path)
Parameters
Type Name Description
string packageId

ID of the package.
string path

The path of the file or directory in the package user data folder.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.IO.IOException

Thrown when the method failed due to an internal IO error.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
System.SystemException

Thrown when the method failed due to an internal system error.
View Source

CompareCertInfo(string, string)

Compares the certificate of the two packages.

Declaration
public static CertCompareResultType CompareCertInfo(string lhsPackageId, string rhsPackageId)
Parameters
Type Name Description
string lhsPackageId

Package ID to compare.
string rhsPackageId

Package ID to be compared.
Returns
Type Description
CertCompareResultType

Returns certificate comparison result.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.IO.IOException

Thrown when the method failed due to an internal I/O error.
View Source

CompareCertInfoByApplicationId(string, string)

Compares the certificate of the two packages which contain each given application ID.

Declaration
public static CertCompareResultType CompareCertInfoByApplicationId(string lhsApplicationId, string rhsApplicationId)
Parameters
Type Name Description
string lhsApplicationId

Application ID to compare.
string rhsApplicationId

Application ID to be compared.
Returns
Type Description
CertCompareResultType

Returns certificate comparison result.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.IO.IOException

Thrown when the method failed due to an internal I/O error.
View Source

GetPackage(string)

Gets the package information for the given package.

Declaration
public static Package GetPackage(string packageId)
Parameters
Type Name Description
string packageId

The ID of the package.
Returns
Type Description
Package

Returns the package information for the given package ID.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.IO.IOException

Thrown when the method fails due to an internal I/O error.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
View Source

GetPackageArchive(string)

Gets the package archive's information for the given archive path.

Declaration
public static PackageArchive GetPackageArchive(string archivePath)
Parameters
Type Name Description
string archivePath

The path of the package archive.
Returns
Type Description
PackageArchive

Returns the package archive information for the given archive path.
Remarks

Regular 3rd party apps do not need to use this API

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.IO.IOException

Thrown when the method fails due to an internal I/O error.
View Source

GetPackageIdByApplicationId(string)

Gets the package ID for the given application ID.

Declaration
public static string GetPackageIdByApplicationId(string applicationId)
Parameters
Type Name Description
string applicationId

The ID of the application.
Returns
Type Description
string

Returns the ID of the package.
Remarks

If the input is null, it returns null.

Exceptions
Type Condition
System.ArgumentException

Thrown when the input application ID does not exist.
System.OutOfMemoryException

Thrown when there is not enough memory to continue the execution of the method.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
View Source

GetPackages()

Retrieves the package information of all installed packages.

Declaration
public static IEnumerable<Package> GetPackages()
Returns
Type Description
System.Collections.Generic.IEnumerable<T><Package>

Returns the list of packages.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

View Source

GetPackages(PackageFilter)

Retrieves the package information of all the installed packages satisfying the filter conditions.

Declaration
public static IEnumerable<Package> GetPackages(PackageFilter filter)
Parameters
Type Name Description
PackageFilter filter

Optional - package filters.
Returns
Type Description
System.Collections.Generic.IEnumerable<T><Package>

Returns the list of packages.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

View Source

GetPermissionTypeByApplicationId(string)

Gets the permission type of the package which has a given application ID.

Declaration
public static PermissionType GetPermissionTypeByApplicationId(string applicationId)
Parameters
Type Name Description
string applicationId

ID of the application.
Returns
Type Description
PermissionType

Returns the permission type.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
View Source

GetTotalSizeInformationAsync()

Gets the total package size information.

Declaration
public static Task<PackageSizeInformation> GetTotalSizeInformationAsync()
Returns
Type Description
System.Threading.Tasks.Task<TResult><PackageSizeInformation>

Returns the total package size information asynchronously.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

View Source

Install(List<string>, InstallationMode)

Installs the packages located at the given path.

Declaration
public static bool Install(List<string> packagePaths, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
System.Collections.Generic.List<T><string> packagePaths

Absolute paths for the package to be installed.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(List<string>, RequestEventCallback, InstallationMode)

Installs the packages located at the given path.

Declaration
public static bool Install(List<string> packagePaths, PackageManager.RequestEventCallback eventCallback, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
System.Collections.Generic.List<T><string> packagePaths

Absolute paths for the package to be installed.
PackageManager.RequestEventCallback eventCallback

The event callback will be invoked only for the current request.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, string, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, string expansionPackagePath, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
string expansionPackagePath

Absolute path for the expansion package to be installed.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, string, RequestEventCallback, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, string expansionPackagePath, PackageManager.RequestEventCallback eventCallback, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
string expansionPackagePath

Absolute path for the expansion package to be installed.
PackageManager.RequestEventCallback eventCallback

The event callback will be invoked only for the current request.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, string, PackageType, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, string expansionPackagePath, PackageType type, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
string expansionPackagePath

Absolute path for the expansion package to be installed.
PackageType type

Package type for the package to be installed.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, string, PackageType, RequestEventCallback, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, string expansionPackagePath, PackageType type, PackageManager.RequestEventCallback eventCallback, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
string expansionPackagePath

Absolute path for the expansion package to be installed.
PackageType type

Package type for the package to be installed.
PackageManager.RequestEventCallback eventCallback

The event callback will be invoked only for the current request.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

True if the installation request is successful, otherwise false.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, RequestEventCallback, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, PackageManager.RequestEventCallback eventCallback, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
PackageManager.RequestEventCallback eventCallback

The event callback will be invoked only for the current request.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, PackageType, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, PackageType type, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
PackageType type

Package type for the package to be installed.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

Install(string, PackageType, RequestEventCallback, InstallationMode)

Installs the package located at the given path.

Declaration
public static bool Install(string packagePath, PackageType type, PackageManager.RequestEventCallback eventCallback, InstallationMode installMode = InstallationMode.Normal)
Parameters
Type Name Description
string packagePath

Absolute path for the package to be installed.
PackageType type

Package type for the package to be installed.
PackageManager.RequestEventCallback eventCallback

The event callback will be invoked only for the current request.
InstallationMode installMode

Optional parameter to indicate special installation mode.
Returns
Type Description
bool

Returns true if installation request is successful, false otherwise.
Remarks

True indicates that the installation request was successful. However, to determine whether the actual installation was completed successfully, the caller must monitor the progress by subscribing to the InstallProgressChanged event.

View Source

IsPreloadPackageByApplicationId(string)

Gets the package's preload attribute which contains a given application ID.

Declaration
public static bool IsPreloadPackageByApplicationId(string applicationId)
Parameters
Type Name Description
string applicationId

ID of the application.
Returns
Type Description
bool

Returns true if the package is preloaded, otherwise false.
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.ArgumentException

Thrown when the failed input package ID is invalid.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
View Source

Move(string, PackageType, StorageType, RequestEventCallback)

Moves the package to the given storage.

Declaration
public static bool Move(string packageId, PackageType type, StorageType newStorage, PackageManager.RequestEventCallback eventCallback)
Parameters
Type Name Description
string packageId

ID of the package to be moved.
PackageType type

Optional - Package type for the package to be moved.
StorageType newStorage

Storage, package should be moved to.
PackageManager.RequestEventCallback eventCallback

Optional - The event callback will be invoked only for the current request.
Returns
Type Description
bool

Returns true if move request is successful, false otherwise.
Remarks

The return value 'true' indicates that the move request was successfully made. To determine whether the actual move operation completed successfully, the caller needs to monitor the progress by handling the MoveProgressChanged event.

View Source

Move(string, PackageType, StorageType)

Moves the package to the given storage.

Declaration
public static bool Move(string packageId, PackageType type, StorageType newStorage)
Parameters
Type Name Description
string packageId

ID of the package to be moved.
PackageType type

Optional - Package type for the package to be moved.
StorageType newStorage

Storage package should be moved to.
Returns
Type Description
bool

Returns true if the move request is successful, false otherwise.
Remarks

The return value 'true' indicates that the move request was successfully made. To determine whether the actual move operation completed successfully, the caller needs to monitor the progress by handling the MoveProgressChanged event.

View Source

Move(string, StorageType, RequestEventCallback)

Moves the package to the given storage.

Declaration
public static bool Move(string packageId, StorageType newStorage, PackageManager.RequestEventCallback eventCallback)
Parameters
Type Name Description
string packageId

ID of the package to be moved.
StorageType newStorage

Storage package should be moved to.
PackageManager.RequestEventCallback eventCallback

Optional - The event callback will be invoked only for the current request.
Returns
Type Description
bool

Returns true if move request is successful, false otherwise.
Remarks

The return value 'true' indicates that the move request was successfully made. To determine whether the actual move operation completed successfully, the caller needs to monitor the progress by handling the MoveProgressChanged event.

View Source

Move(string, StorageType)

Moves the package to the given storage.

Declaration
public static bool Move(string packageId, StorageType newStorage)
Parameters
Type Name Description
string packageId

ID of the package to be moved.
StorageType newStorage

Storage package should be moved to.
Returns
Type Description
bool

Returns true if the move request is successful, false otherwise.
Remarks

The return value 'true' indicates that the move request was successfully made. To determine whether the actual move operation completed successfully, the caller needs to monitor the progress by handling the MoveProgressChanged event.

View Source

Uninstall(string, RequestEventCallback)

Uninstalls the package with the given name.

Declaration
public static bool Uninstall(string packageId, PackageManager.RequestEventCallback eventCallback)
Parameters
Type Name Description
string packageId

ID of the package to be uninstalled.
PackageManager.RequestEventCallback eventCallback

Optional - The event callback will be invoked only for the current request.
Returns
Type Description
bool

Returns true if the uninstallation request is successful, false otherwise.
Remarks

The return value 'true' indicates that the uninstallation request was successfully made. However, in order to determine whether the actual uninstallation process completed without any errors, the caller needs to monitor the progress through the UninstallProgressChanged event.

View Source

Uninstall(string, PackageType, RequestEventCallback)

Uninstalls the package with the given name.

Declaration
public static bool Uninstall(string packageId, PackageType type, PackageManager.RequestEventCallback eventCallback)
Parameters
Type Name Description
string packageId

ID of the package to be uninstalled
PackageType type

Optional - Package type for the package to be uninstalled.
PackageManager.RequestEventCallback eventCallback

Optional - The event callback will be invoked only for the current request.
Returns
Type Description
bool

Returns true if the uninstallation request is successful, false otherwise.
Remarks

The return value 'true' indicates that the uninstallation request was successfully made. However, in order to determine whether the actual uninstallation process completed without any errors, the caller needs to monitor the progress through the UninstallProgressChanged event.

View Source

Uninstall(string, PackageType)

Uninstalls package with the given names.

Declaration
public static bool Uninstall(string packageId, PackageType type)
Parameters
Type Name Description
string packageId

ID of the package to be uninstalled.
PackageType type

Optional - Package type for the package to be uninstalled.
Returns
Type Description
bool

Returns true if the uninstallation request is successful, false otherwise.
Remarks

The return value 'true' indicates that the uninstallation request was successfully made. However, in order to determine whether the actual uninstallation process completed without any errors, the caller needs to monitor the progress through the UninstallProgressChanged event.

View Source

Uninstall(string)

Uninstalls the package with the given name.

Declaration
public static bool Uninstall(string packageId)
Parameters
Type Name Description
string packageId

ID of the package to be uninstalled.
Returns
Type Description
bool

Returns true if the uninstallation request is successful, false otherwise.
Remarks

The return value 'true' indicates that the uninstallation request was successfully made. However, in order to determine whether the actual uninstallation process completed without any errors, the caller needs to monitor the progress through the UninstallProgressChanged event.

Events

View Source

ClearDataProgressChanged

ClearDataProgressChanged event. This event occurs when data directories are cleared in the given package.

Declaration
public static event EventHandler<PackageManagerEventArgs> ClearDataProgressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><PackageManagerEventArgs>
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.IO.IOException

Thrown when subscribing to package manager event failed.
View Source

InstallProgressChanged

InstallProgressChanged event. Occurs when a package is being installed and the progress of the request to the package manager changes.

Declaration
public static event EventHandler<PackageManagerEventArgs> InstallProgressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><PackageManagerEventArgs>
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.IO.IOException

Thrown when subscribing to package manager event fails.
View Source

MoveProgressChanged

MoveProgressChanged event. This event occurs when a package is getting moved and the progress of the request to the package manager is changed.

Declaration
public static event EventHandler<PackageManagerEventArgs> MoveProgressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><PackageManagerEventArgs>
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.IO.IOException

Thrown when subscribing to package manager event failed.
View Source

UninstallProgressChanged

UninstallProgressChanged event. This event occurs when a package is getting uninstalled and the progress of the request to the package manager is changed.

Declaration
public static event EventHandler<PackageManagerEventArgs> UninstallProgressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><PackageManagerEventArgs>
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.IO.IOException

Thrown when subscribing to package manager event failed.
View Source

UpdateProgressChanged

UpdateProgressChanged event. This event occurs when a package is getting updated and the progress of the request to the package manager is changed.

Declaration
public static event EventHandler<PackageManagerEventArgs> UpdateProgressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><PackageManagerEventArgs>
Remarks

The package manager is one of the core modules of the Tizen application framework and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.

Exceptions
Type Condition
System.IO.IOException

Thrown when subscribing to package manager event failed.