Tizen Native API
7.0
|
The package manager is one of the core modules of Tizen application framework, and responsible for getting their information. You can also retrieve information related to the packages that are installed on the device.
Required Header
#include <package_manager.h>
Overview
The Package Manager API provides functions to retrieve information related to the packages and also provides event listening function. You can get the status of package using package_manager_set_event_status() and package_manager_set_event_cb(). If you register package_manager_event_cb(), it is invoked when a package is installed, uninstalled, or updated.
Functions | |
int | package_manager_create (package_manager_h *manager) |
Creates a package manager handle. | |
int | package_manager_destroy (package_manager_h manager) |
Destroys the package manager handle. | |
int | package_manager_set_event_status (package_manager_h manager, int status_type) |
Sets the event status of the package when the package is installed, uninstalled, or updated. | |
int | package_manager_set_event_cb (package_manager_h manager, package_manager_event_cb callback, void *user_data) |
Registers a callback function to be invoked when the package is installed, uninstalled, or updated. | |
int | package_manager_set_res_event_cb (package_manager_h manager, package_manager_res_event_cb callback, void *user_data) |
Registers a callback function to be invoked when the progress of the request to the package resource share changes. | |
int | package_manager_unset_event_cb (package_manager_h manager) |
Unregisters the callback function. | |
int | package_manager_foreach_package_info (package_manager_package_info_cb callback, void *user_data) |
Retrieves all package information of installed packages. | |
int | package_manager_get_package_id_by_app_id (const char *app_id, char **package_id) |
Gets the package ID for the given app ID. | |
int | package_manager_get_package_info (const char *package_id, package_info_h *package_info) |
Gets the package information for the given package. | |
int | package_manager_compare_package_cert_info (const char *lhs_package_id, const char *rhs_package_id, package_manager_compare_result_type_e *compare_result) |
Compares whether two package certifications are matched. | |
int | package_manager_compare_app_cert_info (const char *lhs_app_id, const char *rhs_app_id, package_manager_compare_result_type_e *compare_result) |
Compares whether two app certifications are matched. | |
int | package_manager_is_preload_package_by_app_id (const char *app_id, bool *preload) |
Checks whether the package is preloaded by app_id. | |
int | package_manager_get_permission_type (const char *app_id, package_manager_permission_type_e *permission_type) |
Gets the package permission type by app_id. | |
int | package_manager_clear_cache_dir (const char *package_id) |
Clears the application's internal and external cache directory, asynchronously. | |
int | package_manager_clear_all_cache_dir (void) |
Clears all applications' internal and external cache directory, asynchronously. | |
int | package_manager_clear_data_dir (const char *package_id) |
Clears internal and external data directories used by applications in the given package. | |
int | package_manager_get_package_size_info (const char *package_id, package_manager_size_info_receive_cb callback, void *user_data) |
Gets the package size information, asynchronously. | |
int | package_manager_get_total_package_size_info (package_manager_total_size_info_receive_cb callback, void *user_data) |
Gets the total package size information, asynchronously. | |
int | package_manager_filter_create (package_manager_filter_h *handle) |
Creates the package information filter handle from db. | |
int | package_manager_filter_destroy (package_manager_filter_h handle) |
Destroys the package information filter handle freeing up all the resources. | |
int | package_manager_filter_add_bool (package_manager_filter_h handle, const char *property, const bool value) |
Adds a boolean filter property to the filter handle. | |
int | package_manager_filter_add_string (package_manager_filter_h handle, const char *property, const char *value) |
Adds a string filter property to the filter handle. | |
int | package_manager_filter_count (package_manager_filter_h handle, int *count) |
Counts the package that satisfy the filter conditions. | |
int | package_manager_filter_foreach_package_info (package_manager_filter_h handle, package_manager_package_info_cb callback, void *user_data) |
Executes the user supplied callback function for each package that satisfy the filter conditions. | |
int | package_manager_drm_generate_license_request (const char *resp_data, char **req_data, char **license_url) |
Generates request for getting License, asynchronously. | |
int | package_manager_drm_register_license (const char *resp_data) |
Registers encrypted license, asynchronously. | |
int | package_manager_drm_decrypt_package (const char *drm_file_path, const char *decrypted_file_path) |
Decrypts contents which is encrypted, asynchronously. | |
int | package_size_info_get_data_size (package_size_info_h handle, long long *data_size) |
Retrieves data size from given handle. | |
int | package_size_info_get_cache_size (package_size_info_h handle, long long *cache_size) |
Retrieves cache size from given handle. | |
int | package_size_info_get_app_size (package_size_info_h handle, long long *app_size) |
Retrieves application size from given handle. | |
int | package_size_info_get_external_data_size (package_size_info_h handle, long long *ext_data_size) |
Retrieves external data size from given handle. | |
int | package_size_info_get_external_cache_size (package_size_info_h handle, long long *ext_cache_size) |
Retrieves external cache size from given handle. | |
int | package_size_info_get_external_app_size (package_size_info_h handle, long long *ext_app_size) |
Retrieves external application size from given handle. | |
Typedefs | |
typedef struct package_updateinfo_request_s * | package_updateinfo_request_h |
The Package manager update info request handle. | |
typedef struct package_manager_s * | package_manager_h |
The Package manager handle. | |
typedef struct package_manager_filter_s * | package_manager_filter_h |
Package manager filter handle. | |
typedef struct package_manager_res_event_info_s * | package_manager_res_event_info_h |
Resource share event handle. | |
typedef void(* | package_manager_event_cb )(const char *type, const char *package, package_manager_event_type_e event_type, package_manager_event_state_e event_state, int progress, package_manager_error_e error, void *user_data) |
Called when the package is installed, uninstalled, or updated, and the progress of the request to the package manager changes. | |
typedef void(* | package_manager_res_event_cb )(const char *pkgid, package_manager_event_type_e event_type, package_manager_event_state_e event_state, package_manager_res_event_info_h handle, void *user_data) |
Called when the progress of the request to the package resource share changes. | |
typedef bool(* | package_manager_package_info_cb )(package_info_h package_info, void *user_data) |
Called to retrieve all packages. | |
typedef struct package_size_info * | package_size_info_h |
The package size information handle. | |
typedef void(* | package_manager_size_info_receive_cb )(const char *package_id, const package_size_info_h size_info, void *user_data) |
Called when the package size information is obtained. | |
typedef void(* | package_manager_total_size_info_receive_cb )(const package_size_info_h size_info, void *user_data) |
Called when the total package size information is obtained. | |
Defines | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_REMOVABLE "PMINFO_PKGINFO_PROP_PACKAGE_REMOVABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is removable or not based on package info. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_READONLY "PMINFO_PKGINFO_PROP_PACKAGE_READONLY" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is readonly or not based on package info. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_SUPPORT_DISABLE "PMINFO_PKGINFO_PROP_PACKAGE_SUPPORT_DISABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package supports disable or not based on package info. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_DISABLE "PMINFO_PKGINFO_PROP_PACKAGE_DISABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is disabled based on package info. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_PRELOAD "PMINFO_PKGINFO_PROP_PACKAGE_PRELOAD" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is preload or not based on package info. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_RES_TYPE "PMINFO_PKGINFO_PROP_PACKAGE_RES_TYPE" |
Definition for value to be used when filtering based on resource type: String property for filtering packages with specific resource types. | |
#define | PACKAGE_MANAGER_PKGINFO_PROP_TYPE "PMINFO_PKGINFO_PROP_PACKAGE_TYPE" |
Definition for value to be used when filtering based on package type: String property for filtering packages with specific package types. |
Define Documentation
#define PACKAGE_MANAGER_PKGINFO_PROP_DISABLE "PMINFO_PKGINFO_PROP_PACKAGE_DISABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is disabled based on package info.
- Since :
- 2.3
#define PACKAGE_MANAGER_PKGINFO_PROP_PRELOAD "PMINFO_PKGINFO_PROP_PACKAGE_PRELOAD" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is preload or not based on package info.
- Since :
- 2.3
#define PACKAGE_MANAGER_PKGINFO_PROP_READONLY "PMINFO_PKGINFO_PROP_PACKAGE_READONLY" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is readonly or not based on package info.
- Since :
- 2.3
#define PACKAGE_MANAGER_PKGINFO_PROP_REMOVABLE "PMINFO_PKGINFO_PROP_PACKAGE_REMOVABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package is removable or not based on package info.
- Since :
- 2.3
#define PACKAGE_MANAGER_PKGINFO_PROP_RES_TYPE "PMINFO_PKGINFO_PROP_PACKAGE_RES_TYPE" |
Definition for value to be used when filtering based on resource type: String property for filtering packages with specific resource types.
- Since :
- 6.5
#define PACKAGE_MANAGER_PKGINFO_PROP_SUPPORT_DISABLE "PMINFO_PKGINFO_PROP_PACKAGE_SUPPORT_DISABLE" |
Definition for value to be used when filtering based on install location: Boolean property for filtering whether the package supports disable or not based on package info.
- Since :
- 2.3
#define PACKAGE_MANAGER_PKGINFO_PROP_TYPE "PMINFO_PKGINFO_PROP_PACKAGE_TYPE" |
Definition for value to be used when filtering based on package type: String property for filtering packages with specific package types.
- Since :
- 6.5
Typedef Documentation
typedef void(* package_manager_event_cb)(const char *type, const char *package, package_manager_event_type_e event_type, package_manager_event_state_e event_state, int progress, package_manager_error_e error, void *user_data) |
Called when the package is installed, uninstalled, or updated, and the progress of the request to the package manager changes.
- Since :
- 2.3
- Parameters:
-
[in] type The type of the package to be installed, uninstalled, or updated [in] package The name of the package to be installed, uninstalled, or updated [in] event_type The type of the request to the package manager [in] event_state The current state of the request to the package manager [in] progress The progress for the request that is being processed by the package manager
The range of progress is from0
to100
[in] error The error code when the package manager failed to process the request [in] user_data The user data passed from package_manager_set_event_cb()
typedef struct package_manager_filter_s* package_manager_filter_h |
Package manager filter handle.
- Since :
- 2.3
typedef struct package_manager_s* package_manager_h |
The Package manager handle.
- Since :
- 2.3
typedef bool(* package_manager_package_info_cb)(package_info_h package_info, void *user_data) |
Called to retrieve all packages.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [in] user_data The user data passed from the foreach function
- Returns:
true
to continue with the next iteration of the loop, otherwisefalse
to break out of the loop
typedef void(* package_manager_res_event_cb)(const char *pkgid, package_manager_event_type_e event_type, package_manager_event_state_e event_state, package_manager_res_event_info_h handle, void *user_data) |
Called when the progress of the request to the package resource share changes.
- Since :
- 6.5
- Remarks:
- The pkgid should not be released. The pkgid can be used only in the callback.
- The handle should not be released. The handle can be used only in the callback.
- Parameters:
-
[in] pkgid The package ID of resource owner [in] event_type The type of resource event [in] event_state The state of resource event [in] handle The handle which contains additional information of event [in] user_data The user data passed from package_manager_set_res_event_cb()
typedef struct package_manager_res_event_info_s* package_manager_res_event_info_h |
Resource share event handle.
- Since :
- 6.5
typedef void(* package_manager_size_info_receive_cb)(const char *package_id, const package_size_info_h size_info, void *user_data) |
Called when the package size information is obtained.
- Since :
- 2.4
- Parameters:
-
[in] package_id The package ID [in] size_info The pointer to the structure including the package size information [in] user_data The user data to be passed to the callback function
typedef void(* package_manager_total_size_info_receive_cb)(const package_size_info_h size_info, void *user_data) |
Called when the total package size information is obtained.
- Warning:
- This is not for use by third-party applications.
- Since :
- 2.3
- Parameters:
-
[in] size_info The pointer to the structure including the package size information [in] user_data The user data to be passed to the callback function
typedef struct package_size_info* package_size_info_h |
The package size information handle.
- Since :
- 2.4
typedef struct package_updateinfo_request_s* package_updateinfo_request_h |
The Package manager update info request handle.
- Since :
- 4.0
Enumeration Type Documentation
Enumeration for certification compare type.
- Since :
- 2.3
- Enumerator:
Enumeration for error code.
- Since :
- 2.3
- Enumerator:
Enumeration for event type.
- Since :
- 2.3
- Enumerator:
Enumeration for resource event path state.
- Since :
- 6.5
Enumeration for status type.
- Since :
- 2.3
- Enumerator:
Function Documentation
int package_manager_clear_all_cache_dir | ( | void | ) |
Clears all applications' internal and external cache directory, asynchronously.
- Warning:
- This is not for use by third-party applications.
All files stored in the cache directory of each application are removed.
- Since :
- 2.3
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
int package_manager_clear_cache_dir | ( | const char * | package_id | ) |
Clears the application's internal and external cache directory, asynchronously.
All files stored in the cache directory of the application specified with the package ID are removed.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.clearcache
- Parameters:
-
[in] package_id The package ID
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
int package_manager_clear_data_dir | ( | const char * | package_id | ) |
Clears internal and external data directories used by applications in the given package.
- Warning:
- This is not for use by third-party applications.
All files stored in data directories used by applications in the package specified with the package_id are removed.
- Since :
- 4.0
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Parameters:
-
[in] package_id The package ID
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
int package_manager_compare_app_cert_info | ( | const char * | lhs_app_id, |
const char * | rhs_app_id, | ||
package_manager_compare_result_type_e * | compare_result | ||
) |
Compares whether two app certifications are matched.
- Since :
- 2.3
- Parameters:
-
[in] lhs_app_id The first app ID to compare [in] rhs_app_id The second app ID to compare [out] compare_result 0
if the certification information are matched, otherwise the compared result
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR Database error occurred
int package_manager_compare_package_cert_info | ( | const char * | lhs_package_id, |
const char * | rhs_package_id, | ||
package_manager_compare_result_type_e * | compare_result | ||
) |
Compares whether two package certifications are matched.
- Since :
- 2.3
- Parameters:
-
[in] lhs_package_id The first package ID to compare [in] rhs_package_id The second package ID to compare [out] compare_result 0
if the certification information are matched, otherwise the compared result
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR Database error occurred
int package_manager_create | ( | package_manager_h * | manager | ) |
Creates a package manager handle.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Remarks:
- You must release manager using package_manager_destroy().
- Parameters:
-
[out] manager The package manager handle that is newly created on success
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- See also:
- package_manager_destroy()
int package_manager_destroy | ( | package_manager_h | manager | ) |
Destroys the package manager handle.
- Since :
- 2.3
- Parameters:
-
[in] manager The package manager handle
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- See also:
- package_manager_create()
int package_manager_drm_decrypt_package | ( | const char * | drm_file_path, |
const char * | decrypted_file_path | ||
) |
Decrypts contents which is encrypted, asynchronously.
- Warning:
- This is not for use by third-party applications.
- Since :
- 2.4
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Parameters:
-
[in] drm_file_path DRM file path [in] decrypted_file_path Decrypted file path
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
int package_manager_drm_generate_license_request | ( | const char * | resp_data, |
char ** | req_data, | ||
char ** | license_url | ||
) |
Generates request for getting License, asynchronously.
- Warning:
- This is not for use by third-party applications.
- Since :
- 2.4
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Remarks:
- You must release req_data and license_url by yourself.
- Parameters:
-
[in] resp_data The response data string of the purchase request [out] req_data License request data [out] license_url License acquisition url data
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- Postcondition:
- package_manager_drm_register_license()
int package_manager_drm_register_license | ( | const char * | resp_data | ) |
Registers encrypted license, asynchronously.
- Warning:
- This is not for use by third-party applications.
- Since :
- 2.4
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Parameters:
-
[in] resp_data The response data string of the rights request
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- Precondition:
- package_manager_drm_generate_license_request()
int package_manager_filter_add_bool | ( | package_manager_filter_h | handle, |
const char * | property, | ||
const bool | value | ||
) |
Adds a boolean filter property to the filter handle.
- Since :
- 2.3
- Parameters:
-
[in] handle Pointer to the package info filter handle [in] property boolean property name [in] value value corresponding to the property
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Precondition:
- package_manager_filter_create()
- Postcondition:
- package_manager_filter_destroy()
int package_manager_filter_add_string | ( | package_manager_filter_h | handle, |
const char * | property, | ||
const char * | value | ||
) |
Adds a string filter property to the filter handle.
- Since :
- 6.5
- Parameters:
-
[in] handle pointer to the package info filter handle [in] property string property name [in] value value corresponding to the property
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Precondition:
- package_manager_filter_create()
- Postcondition:
- package_manager_filter_destroy()
int package_manager_filter_count | ( | package_manager_filter_h | handle, |
int * | count | ||
) |
Counts the package that satisfy the filter conditions.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] handle Pointer to the package info filter handle [out] count Pointer to store the count value
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Precondition:
- package_manager_filter_create()
- Postcondition:
- package_manager_filter_destroy()
int package_manager_filter_create | ( | package_manager_filter_h * | handle | ) |
Creates the package information filter handle from db.
The filtered result will be based on AND operation of all added filter properties.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Remarks:
- The handle should be released using package_manager_filter_destroy().
- Parameters:
-
[out] handle Pointer to the package info filter handle
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Postcondition:
- package_manager_filter_destroy()
int package_manager_filter_destroy | ( | package_manager_filter_h | handle | ) |
Destroys the package information filter handle freeing up all the resources.
- Since :
- 2.3
- Parameters:
-
[in] handle Pointer to the package info filter handle
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Precondition:
- package_manager_filter_create()
int package_manager_filter_foreach_package_info | ( | package_manager_filter_h | handle, |
package_manager_package_info_cb | callback, | ||
void * | user_data | ||
) |
Executes the user supplied callback function for each package that satisfy the filter conditions.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] handle Pointer to the package info filter handle [in] callback callback function [in] user_data user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
- Precondition:
- package_manager_filter_create()
- Postcondition:
- package_manager_filter_destroy()
- This function invokes package_manager_package_info_cb() repeatedly for each package information.
int package_manager_foreach_package_info | ( | package_manager_package_info_cb | callback, |
void * | user_data | ||
) |
Retrieves all package information of installed packages.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] callback The callback function to be invoked [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- Postcondition:
- This function invokes package_manager_package_info_cb() repeatedly for each package information.
- See also:
- package_manager_package_info_cb()
int package_manager_get_package_id_by_app_id | ( | const char * | app_id, |
char ** | package_id | ||
) |
Gets the package ID for the given app ID.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Remarks:
- The package_id should be released using free().
- Parameters:
-
[in] app_id The ID of the application [out] package_id The ID of the package
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int package_manager_get_package_info | ( | const char * | package_id, |
package_info_h * | package_info | ||
) |
Gets the package information for the given package.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Remarks:
- You must release package_info using package_info_destroy().
- Parameters:
-
[in] package_id The ID of the package [out] package_info The package information for the given package ID
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR Database error occurred
int package_manager_get_package_size_info | ( | const char * | package_id, |
package_manager_size_info_receive_cb | callback, | ||
void * | user_data | ||
) |
Gets the package size information, asynchronously.
The package size info is asynchronously obtained by the callback function.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] package_id The package ID [in] callback The asynchronous callback function to get the package size information [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
int package_manager_get_permission_type | ( | const char * | app_id, |
package_manager_permission_type_e * | permission_type | ||
) |
Gets the package permission type by app_id.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] app_id The ID of the application [out] permission_type The package permission type
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_manager_get_total_package_size_info | ( | package_manager_total_size_info_receive_cb | callback, |
void * | user_data | ||
) |
Gets the total package size information, asynchronously.
The total package size info is asynchronously obtained by the callback function.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] callback The asynchronous callback function to get the total package size information [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
int package_manager_is_preload_package_by_app_id | ( | const char * | app_id, |
bool * | preload | ||
) |
Checks whether the package is preloaded by app_id.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] app_id The ID of the application [out] preload The preload info of the package
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_manager_set_event_cb | ( | package_manager_h | manager, |
package_manager_event_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when the package is installed, uninstalled, or updated.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/packagemanager.info
- Parameters:
-
[in] manager The package manager handle [in] callback The callback function to be registered [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- Postcondition:
- package_manager_event_cb() will be invoked.
int package_manager_set_event_status | ( | package_manager_h | manager, |
int | status_type | ||
) |
Sets the event status of the package when the package is installed, uninstalled, or updated.
You can combine multiple status using OR operation which you want to listen.
- Since :
- 2.3
- Parameters:
-
[in] manager The package manager handle [in] status_type The status of the package
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
int package_manager_set_res_event_cb | ( | package_manager_h | manager, |
package_manager_res_event_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when the progress of the request to the package resource share changes.
- Warning:
- This is not for use by third-party applications.
- Since :
- 6.5
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Parameters:
-
[in] manager The package manager handle [in] callback The callback function to be registered [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- Postcondition:
- package_manager_res_event_cb() will be invoked.
int package_manager_unset_event_cb | ( | package_manager_h | manager | ) |
Unregisters the callback function.
- Since :
- 2.3
- Parameters:
-
[in] manager The package manager handle
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_app_size | ( | package_size_info_h | handle, |
long long * | app_size | ||
) |
Retrieves application size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] app_size App size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_cache_size | ( | package_size_info_h | handle, |
long long * | cache_size | ||
) |
Retrieves cache size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] cache_size Cache size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_data_size | ( | package_size_info_h | handle, |
long long * | data_size | ||
) |
Retrieves data size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] data_size Data size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_external_app_size | ( | package_size_info_h | handle, |
long long * | ext_app_size | ||
) |
Retrieves external application size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] ext_app_size External app size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_external_cache_size | ( | package_size_info_h | handle, |
long long * | ext_cache_size | ||
) |
Retrieves external cache size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] ext_cache_size External cache size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int package_size_info_get_external_data_size | ( | package_size_info_h | handle, |
long long * | ext_data_size | ||
) |
Retrieves external data size from given handle.
- Since :
- 2.4
- Parameters:
-
[in] handle Package size info handle [out] ext_data_size External data size will be returned
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
PACKAGE_MANAGER_ERROR_NONE Successful PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter