Tizen Native API
|
Functions | |
int | package_info_foreach_app_from_package (package_info_h package_info, package_info_app_component_type_e comp_type, package_info_app_cb callback, void *user_data) |
Retrieves all application IDs of each package. | |
int | package_info_destroy (package_info_h package_info) |
Destroys the package information handle and releases all its resources. | |
int | package_info_get_package (package_info_h package_info, char **package) |
Gets the package name. | |
int | package_info_get_label (package_info_h package_info, char **label) |
Gets the label of the package. | |
int | package_info_get_icon (package_info_h package_info, char **path) |
Gets the absolute path to the icon image. | |
int | package_info_get_version (package_info_h package_info, char **version) |
Gets the version of the package. | |
int | package_info_get_type (package_info_h package_info, char **type) |
Gets the type of the package. | |
int | package_info_get_installed_storage (package_info_h package_info, package_info_installed_storage_type_e *storage) |
Gets the installed storage for the given package. | |
int | package_info_get_root_path (package_info_h package_info, char **path) |
Gets the root path of the package. | |
int | package_info_get_tep_name (package_info_h package_info, char **name) |
Gets the name of the TEP(Tizen Expansion Package). | |
int | package_info_is_system_package (package_info_h package_info, bool *system) |
Checks whether the package is system package. | |
int | package_info_is_removable_package (package_info_h package_info, bool *removable) |
Checks whether the package is removable. | |
int | package_info_is_preload_package (package_info_h package_info, bool *preload) |
Checks whether the package is preloaded. | |
int | package_info_is_equal (package_info_h lhs, package_info_h rhs, bool *equal) |
Checks whether two package information are equal. | |
int | package_info_is_accessible (package_info_h package_info, bool *accessible) |
Checks whether the package info is accessible for the given package. | |
int | package_info_clone (package_info_h *clone, package_info_h package_info) |
Clones the package information handle. | |
int | package_info_create (const char *package, package_info_h *package_info) |
Gets the package information for the given package. | |
int | package_info_foreach_cert_info (package_info_h package_info, package_info_cert_info_cb callback, void *user_data) |
Retrieves certification information of the package. | |
int | package_info_foreach_privilege_info (package_info_h package_info, package_info_privilege_info_cb callback, void *user_data) |
Retrieves privilege information of the package. | |
Typedefs | |
typedef struct package_info_s * | package_info_h |
The package information handle. | |
typedef bool(* | package_info_app_cb )(package_info_app_component_type_e comp_type, const char *app_id, void *user_data) |
Called to get the application ID once for each installed package. | |
typedef bool(* | package_info_cert_info_cb )(package_info_h handle, package_cert_type_e cert_type, const char *cert_value, void *user_data) |
Called to get the certification information. | |
typedef bool(* | package_info_privilege_info_cb )(const char *privilege_name, void *user_data) |
Called to get the privilege information. |
Packager Manager infomation API for packaging. It provides functions for getting the package information.
Required Header
#include <package_manager.h>
Overview
The package manager is used to retrieve detailed information of the installed packages on the device. This information includes package name, label, path to the icon image, version, type, and installed storage. To retrieve package information, you should get the package_info_h using package_info_create() or package_manager_get_package_info(). The package_manager_foreach_package_info() is used to retrieve all the package information of installed packages. And then package_manager_package_info_cb() is invoked. When the callback function is called, you can get the information using the following functions.
Typedef Documentation
typedef bool(* package_info_app_cb)(package_info_app_component_type_e comp_type, const char *app_id, void *user_data) |
Called to get the application ID once for each installed package.
- Since :
- 2.3
- Parameters:
-
[in] comp_type The Application Component type [in] callback The callback function to be invoked [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
- Precondition:
- package_info_foreach_app_from_package() will invoke this callback.
typedef bool(* package_info_cert_info_cb)(package_info_h handle, package_cert_type_e cert_type, const char *cert_value, void *user_data) |
Called to get the certification information.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package info handle [in] cert_type The certificate type [in] cert_value The certificate value of corresponding certificate key
This value is base64 encoded data.[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
- Precondition:
- package_info_foreach_cert_info() will invoke this callback.
- See also:
- package_info_foreach_cert_info()
typedef struct package_info_s* package_info_h |
The package information handle.
- Since :
- 2.3
typedef bool(* package_info_privilege_info_cb)(const char *privilege_name, void *user_data) |
Called to get the privilege information.
- Since :
- 2.3
- Parameters:
-
[in] privilege_name the name of the privilege [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
- Precondition:
- package_info_foreach_privilege_info() will invoke this callback.
Enumeration Type Documentation
enum package_cert_type_e |
Enumeration for certification type.
- Since :
- 2.3
- Enumerator:
Function Documentation
int package_info_clone | ( | package_info_h * | clone, |
package_info_h | package_info | ||
) |
Clones the package information handle.
- Since :
- 2.3
- Parameters:
-
[out] clone The newly created package information handle [in] package_info The package information
- 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_NO_SUCH_PACKAGE The package is not installed PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int package_info_create | ( | const char * | package, |
package_info_h * | package_info | ||
) |
Gets the package information for the given package.
- Since :
- 2.3
- Remarks:
- You must release package_info using package_info_destroy().
- Parameters:
-
[in] package 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_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE The package is not installed PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int package_info_destroy | ( | package_info_h | package_info | ) |
Destroys the package information handle and releases all its resources.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information 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_info_foreach_app_from_package | ( | package_info_h | package_info, |
package_info_app_component_type_e | comp_type, | ||
package_info_app_cb | callback, | ||
void * | user_data | ||
) |
Retrieves all application IDs of each package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package info handle [in] comp_type The application component type [in] callback The callback function to invoke [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_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE No such package
- Postcondition:
- This function invokes package_info_app_cb() repeatedly for each package.
- See also:
- package_info_app_cb()
int package_info_foreach_cert_info | ( | package_info_h | package_info, |
package_info_cert_info_cb | callback, | ||
void * | user_data | ||
) |
Retrieves certification information of the package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [in] callback The iteration callback function [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_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_foreach_privilege_info | ( | package_info_h | package_info, |
package_info_privilege_info_cb | callback, | ||
void * | user_data | ||
) |
Retrieves privilege information of the package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [in] callback The iteration callback function [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_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_get_icon | ( | package_info_h | package_info, |
char ** | path | ||
) |
Gets the absolute path to the icon image.
- Since :
- 2.3
- Remarks:
- You must release path using free().
- Parameters:
-
[in] package_info The package information [out] path The path 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_get_installed_storage | ( | package_info_h | package_info, |
package_info_installed_storage_type_e * | storage | ||
) |
Gets the installed storage for the given package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [out] storage The installed storage
- 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_info_get_label | ( | package_info_h | package_info, |
char ** | label | ||
) |
Gets the label of the package.
- Since :
- 2.3
- Remarks:
- You must release label using free().
- Parameters:
-
[in] package_info The package information [out] label The label 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_get_package | ( | package_info_h | package_info, |
char ** | package | ||
) |
Gets the package name.
- Since :
- 2.3
- Remarks:
- You must release package using free().
- Parameters:
-
[in] package_info The package information [out] package The package name
- 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
int package_info_get_root_path | ( | package_info_h | package_info, |
char ** | path | ||
) |
Gets the root path of the package.
- Since :
- 2.3
- Remarks:
- You must release path using free().
- Parameters:
-
[in] package_info The package information [out] path The root path 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_get_tep_name | ( | package_info_h | package_info, |
char ** | name | ||
) |
Gets the name of the TEP(Tizen Expansion Package).
- Warning:
- This is not for use by third-party applications.
- Since :
- 2.4
- Privilege Level:
- platform
- Privilege:
- http://tizen.org/privilege/packagemanager.admin
- Remarks:
- name must be released using free().
- Parameters:
-
[in] package_info The package information [out] name The name of the tep
- 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 IO error PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
int package_info_get_type | ( | package_info_h | package_info, |
char ** | type | ||
) |
Gets the type of the package.
- Since :
- 2.3
- Remarks:
- You must release type using free().
- Parameters:
-
[in] package_info The package information [out] type The type 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_get_version | ( | package_info_h | package_info, |
char ** | version | ||
) |
Gets the version of the package.
- Since :
- 2.3
- Remarks:
- You must release version using free().
- Parameters:
-
[in] package_info The package information [out] version The version 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_is_accessible | ( | package_info_h | package_info, |
bool * | accessible | ||
) |
Checks whether the package info is accessible for the given package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [out] accessible true
if the package info is accessible, otherwisefalse
if the package info is not accessible
- 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_info_is_equal | ( | package_info_h | lhs, |
package_info_h | rhs, | ||
bool * | equal | ||
) |
Checks whether two package information are equal.
- Since :
- 2.3
- Parameters:
-
[in] lhs The first package information to be compared [in] rhs The second package information to be compared [out] equal true
if the package information are equal, otherwisefalse
if package information are not equal
- 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_info_is_preload_package | ( | package_info_h | package_info, |
bool * | preload | ||
) |
Checks whether the package is preloaded.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [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_INVALID_PARAMETER Invalid parameter PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_is_removable_package | ( | package_info_h | package_info, |
bool * | removable | ||
) |
Checks whether the package is removable.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [out] removable The removable info 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error
int package_info_is_system_package | ( | package_info_h | package_info, |
bool * | system | ||
) |
Checks whether the package is system package.
- Since :
- 2.3
- Parameters:
-
[in] package_info The package information [out] system true
if the package is system package, otherwisefalse
if the package is not system 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_OUT_OF_MEMORY Out of memory PACKAGE_MANAGER_ERROR_IO_ERROR I/O error