/**
* @brief Application context handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct app_context_s *app_context_h;
/**
* @brief Enumeration for Application Context Event.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum
{
/**
* @brief Destroys the application context handle and releases all its resources.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_context The application context handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Gets the package with the given application context.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks This function is @b deprecated. Use app_context_get_app_id() instead. \n
* You must release @a package using free().
* @param[in] app_context The application context
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_get_package(app_context_h app_context, char **package);
/**
* @brief Gets the application ID with the given application context.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a app_id using free().
* @param[in] app_context The application context
* @param[out] app_id The application ID of the given application context
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_get_app_id(app_context_h app_context, char **app_id);
/**
* @brief Gets the process ID with the given application context.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_context The application context
* @param[out] pid The process ID of the given application context
* @return @c 0 on success,
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_get_pid(app_context_h app_context, pid_t *pid);
/**
* @brief Checks whether the application with the given application context is terminated.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_context The application context
* @param[out] terminated @c true if the application is terminated, \n
* otherwise @c false if the application is running
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_is_terminated(app_context_h app_context, bool *terminated);
/**
* @brief Checks whether two application contexts are equal.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] lhs The first application context to compare
* @param[in] rhs The second application context to compare
* @param[out] equal @c true if the application contexts are equal, \n
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_is_equal(app_context_h lhs, app_context_h rhs, bool *equal);
/**
* @brief Clones the application context handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[out] clone The newly created application context handle, if cloning is successful
* @param[in] app_context The application context
* @return @c 0 on success,
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_context_clone(app_context_h *clone, app_context_h app_context);
/**
* @brief Application information handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct app_info_s *app_info_h;
/**
* @brief Application filter handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct app_info_filter_s *app_info_filter_h;
/**
* @brief Application metadata filter handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct app_info_metadata_filter_s *app_info_metadata_filter_h;
/**
* @brief Called to get the application information once for each installed application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information of each installed application
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n
/**
* @brief Called to get application metadata in app_info_foreach_metadata().
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] metadata_name The name of the metadata
* @param[in] metadata_value The value of the metadata
* @param[in] user_data The user data passed to app_info_foreach_metadata()
typedef bool (*app_info_metadata_cb) (const char *metadata_key, const char *metadata_value, void *user_data);
/**
+ * @brief Enumeration for Application Information Event.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ */
+typedef enum
+{
+ APP_INFO_EVENT_INSTALLED, /**< The application is newly installed */
+ APP_INFO_EVENT_UNINSTALLED, /**< The application is uninstalled */
+ APP_INFO_EVENT_UPDATED, /**< The application is updated */
+} app_info_event_e;
+
+/**
* @brief Creates the application information handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[in] app_id The application ID
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_MANAGER_ERROR_NO_SUCH_APP The app is not installed
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
* @see app_manager_foreach_app_info()
* @see app_manager_get_app_info()
*/
/**
* @brief Destroys the application information handle and releases all its resources.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Gets the application ID with the given application context.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a app_id using free().
* @param[in] app_info The application information
* @param[out] app_id The application ID of the given application context
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_get_app_id(app_info_h app_info, char **app_id);
/**
* @brief Gets the executable path of the application
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a exec path using free().
* @param[in] app_info The application information
* @param[out] exec The executable path of the application
*/
int app_info_get_exec(app_info_h app_info, char **exec);
-/* FIXME: Temporary patch to prevent build break.
- This MUST be removed after packages using the below API are modified. */
-#define app_info_get_name app_info_get_label
-
/**
* @brief Gets the label of the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a label using free().
* @param[in] app_info The application information
* @param[out] label The label of the application
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_get_label(app_info_h app_info, char **label);
/**
* @brief Gets the localed name of the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @remarks You must release localed name using free().
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_info_get_localed_label(const char *app_id, const char *locale, char **label);
/**
* @brief Gets the absolute path to the icon image.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a path using free().
* @param[in] app_info The application information
* @param[out] path The absolute path to the icon
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_get_icon(app_info_h app_info, char **path);
/**
* @brief Gets the package name.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a package name using free().
* @param[in] app_info The application information
* @param[out] package The package name
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_get_package(app_info_h app_info, char **package);
/**
* @brief Gets the package type name.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release package @a type name using free().
* @param[in] app_info The application information
* @param[out] type The package type
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_get_type(app_info_h app_info, char **type);
/**
* @brief Gets the list of metadata for a particular application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information
* @param[in] callback The callback function for list
* @param[in] user_data The user data to be passed to callback function
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_foreach_metadata(app_info_h app_info, app_info_metadata_cb callback, void *user_data);
/**
* @brief Checks whether application information is nodisplay.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information
* @param[out] nodisplay @c true if the application is nodisplay, \n
* otherwise @c false
/**
* @brief Checks whether two application information are equal.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] lhs The first application information to compare
* @param[in] rhs The second application information to compare
* @param[out] equal @c true if the application information are equal, \n
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
*/
int app_info_is_equal(app_info_h lhs, app_info_h rhs, bool *equal);
/**
* @brief Checks whether application is enabled.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information
* @param[out] enabled @c true if the application is enabled, \n
* otherwise @c false
/**
* @brief Checks whether application is launched on booting time.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information
* @param[out] onboot @c true if the application is launched on booting time, \n
* otherwise @c false
/**
* @brief Checks whether application is preloaded.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information
* @param[out] preload @c true if the application is preloaded, \n
* otherwise @c false
/**
* @brief Clones the application information handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[out] clone A newly created application information handle, if successfully cloned
* @param[in] app_info The application information
* @return @c 0 on success,
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_NO_SUCH_APP The app is not installed
*/
int app_info_clone(app_info_h *clone, app_info_h app_info);
/**
* @brief Creates the application information filter handle from DB.
* All filter properties will be ANDed.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[out] handle The pointer to the application info filter handle
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_info_filter_create(app_info_filter_h *handle);
/**
* @brief Destroys the application information filter handle, freeing up all the resources.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @return @c 0 on success,
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_filter_destroy(app_info_filter_h handle);
/**
* @brief Adds a boolean filter property to the filter handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @param[in] property The integer property name
* @param[in] value The value corresponding to the property
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_filter_add_bool(app_info_filter_h handle, const char *property, const bool value);
/**
* @brief Adds a string filter property to the filter handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @param[in] property The integer property name
* @param[in] value The value corresponding to the property
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_filter_add_string(app_info_filter_h handle, const char *property, const char *value);
/**
* @brief Gets the count of filtered apps.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @param[out] count The pointer to the variable for count
* @return @c 0 on success,
/**
* @brief Executes the user supplied callback function for each application that satisfy the filter conditions.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @param[in] callback The callback function
* @param[in] user_data The user data to be passed to the callback function
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_filter_foreach_appinfo(app_info_filter_h handle, app_info_filter_cb callback, void * user_data);
/**
* @brief Creates the application's metadata information filter handle from DB.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[out] handle The pointer to the application metadata info filter handle
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_info_metadata_filter_create(app_info_metadata_filter_h *handle);
/**
* @brief Destroys the application's metadata information filter handle.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application info filter handle
* @return @c 0 on success,
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_metadata_filter_destroy(app_info_metadata_filter_h handle);
* @brief Adds filter condition for the query API.
* @details The query will search the entire application metadata information collected from
* the manifest file of all the installed packages. You can specify value as @c NULL to search based on key only.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application metadata info filter handle
* @param[in] key The pointer to metadata key
* @param[in] value The pointer to metadata value
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_metadata_filter_add(app_info_metadata_filter_h handle, const char *key, const char *value);
* @details The query will search the entire application metadata information collected from
* the manifest file of all the installed packages. For each application returned by the query, the callback will be called. If callback returns
* negative value, no more callbacks will be called and API will return.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] handle The pointer to the application metadata info filter handle
* @param[in] callback The function pointer to callback
* @param[in] user_data The pointer to user data
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #APP_MANAGER_ERROR_IO_ERROR I/O error
*/
int app_info_metadata_filter_foreach(app_info_metadata_filter_h handle, app_info_filter_cb callback, void *user_data);
/**
* @brief Enumerations for Application Manager Error .
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum
{
/**
* @internal
* @brief Called when an application is launched or terminated.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_context The application context of the application launched or terminated
* @param[in] event The application context event
* @param[in] user_data The user data passed from the foreach function
/**
* @brief Called to get the application context once for each running application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_context The application context of each running application
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n
/**
* @brief Called to get the application information once for each installed application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_info The application information of each installed application
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n
typedef bool (*app_manager_app_info_cb) (app_info_h app_info, void *user_data);
/**
- * @internal
* @brief Registers a callback function to be invoked when the applications get launched or terminated.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[in] callback The callback function to register
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
* @post It will invoke app_manager_app_context_event_cb() when the application is launched or terminated.
* @see app_manager_unset_app_context_event_cb()
* @see app_manager_app_context_event_cb()
int app_manager_set_app_context_event_cb(app_manager_app_context_event_cb callback, void *user_data);
/**
- * @internal
* @brief Unregisters the callback function.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @see app_manager_set_app_event_cb()
* @see app_manager_app_context_event_cb()
*/
/**
* @brief Retrieves all application contexts of running applications.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[in] callback The callback function to invoke
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
* @post This function invokes app_manager_app_context_cb() for each application context.
* @see app_manager_app_context_cb()
*/
/**
* @brief Gets the application context for the given ID of the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @remarks This function returns #APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given application ID is not running. \n
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #APP_MANAGER_ERROR_NO_SUCH_APP No such application
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_get_app_context(const char *app_id, app_context_h *app_context);
/**
* @brief Gets the ID of the application for the given process ID.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @remarks This function returns #APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given process ID is not valid. \n
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_NO_SUCH_APP No such application
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_get_app_id(pid_t pid, char **app_id);
-/* FIXME: Temporary patch to prevent build break.
- This MUST be removed after packages using the below API are modified. */
-#define app_manager_get_package app_manager_get_app_id
-
/**
* @brief Checks whether the application with the given package name is running.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @param[in] app_id The ID of the application
* @param[out] running @c true if the application is running, \n
* otherwise @c false if not running
/**
* @brief Resumes the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.launch
* @param[in] app_context The application context
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_APP_NO_RUNNING App is not running
- * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal resume error
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_APP_NO_RUNNING App is not running
+ * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal resume error
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_resume_app(app_context_h app_context);
/**
- * @internal
+ * @brief Terminates the back ground application.\n
+ * UI applications that are in paused state or some service applications could be required to terminate by this API.
+ * @since_tizen 2.4
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/appmanager.bgkill
+ * @remarks This function returns after it just sends a request for terminating a background application.\n
+ * Platform will decide if the target application could be terminated or not according to the state of the target application.
+ * @param[in] app_context The application context
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ * @retval #APP_MANAGER_ERROR_NONE Successful
+ * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Failed to send terminate request
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ */
+int app_manager_request_terminate_bg_app(app_context_h app_context);
+
+/* FIXME: should be separated */
+/**
* @brief Opens the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.launch
* @param[in] app_id The ID of the application
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_NO_SUCH_APP No such application
- * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal open error
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_NO_SUCH_APP No such application
+ * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal open error
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_open_app(const char *app_id);
+/* FIXME: should be separated */
/**
- * @internal
* @brief Terminates the application.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel platform
* @privilege %http://tizen.org/privilege/appmanager.kill
* @param[in] app_context The application context
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal terminate error
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_REQUEST_FAILED Internal terminate error
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_terminate_app(app_context_h app_context);
/**
* @brief Retrieves all installed applications information.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @param[in] callback The callback function to invoke
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
* @post This function invokes app_manager_app_info_cb() for each application information.
* @see app_manager_app_info_cb()
*/
/**
* @brief Gets the application information for the given application ID.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/packagemanager.info
* @remarks You must release @a app_info using app_info_destroy().
* otherwise a negative error value
* @retval #APP_MANAGER_ERROR_NONE Successful
* @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred
* @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #APP_MANAGER_ERROR_NO_SUCH_APP No such application
+ * @retval #APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
*/
int app_manager_get_app_info(const char *app_id, app_info_h *app_info);
* @brief Gets the absolute path to the shared data directory of the application specified
* with an application ID.
* @details An application can only read the files of other application's shared data directory.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks The specified @a path should be released.
*
* @param[in] app_id The ID of the application
* @brief Gets the absolute path to the shared resource directory of the application specified
* with an application ID.
* @details An application can only read the files of other application's shared resource directory.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks The specified @a path should be released.
*
* @param[in] app_id The ID of the application
* with an application ID.
* @details An application signed with the same certificate can read and write the files of
* other application's shared trusted directory.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks The specified @a path should be released.
*
* @param[in] app_id The ID of the application
* @brief Gets the absolute path to the shared data directory of the application specified
* with an application ID.
* @details An application can only read the files of other application's shared data directory.
- * @since_tizen 2.3
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks The specified @a path should be released.
*
* @param[in] app_id The ID of the application
return app_manager_error(APP_MANAGER_ERROR_INVALID_PARAMETER, __FUNCTION__, NULL);
}
- pkgmgrinfo_appinfo_get_localed_label(app_id, locale, &val);
- if (val == NULL)
+ if (pkgmgrinfo_appinfo_usr_get_localed_label(app_id, locale, getuid(), &val))
{
return app_manager_error(APP_MANAGER_ERROR_INVALID_PARAMETER, __FUNCTION__, NULL);
}
return APP_MANAGER_ERROR_NONE;
}
+API int app_manager_request_terminate_bg_app(app_context_h app_context)
+{
+#if 0
+ int retval = APP_MANAGER_ERROR_NONE;
+ pid_t pid = 0;
+#endif
+ if (app_context == NULL)
+ {
+ return app_manager_error(APP_MANAGER_ERROR_INVALID_PARAMETER, __FUNCTION__, NULL);
+ }
+ /* TODO: implement aul_terminate_bgapp_pid */
+#if 0
+ if (app_context_get_pid(app_context, &pid) != APP_MANAGER_ERROR_NONE) {
+ return app_manager_error(APP_MANAGER_ERROR_INVALID_PARAMETER, __FUNCTION__, "failed to get the process ID");
+ }
+
+ retval = aul_terminate_bgapp_pid(pid);
+ if (retval == AUL_R_EINVAL)
+ {
+ LOGE("[%s] APP_MANAGER_ERROR_INVALID_PARAMETER(0x%08x) : Invalid param", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER);
+ return APP_MANAGER_ERROR_INVALID_PARAMETER;
+ }
+ else if (retval == AUL_R_EILLACC)
+ {
+ LOGE("[%s] APP_MANAGER_ERROR_PERMISSION_DENIED(0x%08x) : Permission denied", __FUNCTION__, APP_MANAGER_ERROR_PERMISSION_DENIED);
+ return APP_MANAGER_ERROR_PERMISSION_DENIED;
+ }
+ else if (retval < 0)
+ {
+ return APP_MANAGER_ERROR_REQUEST_FAILED;
+ }
+#endif
+ return APP_MANAGER_ERROR_NONE;
+}
+
API int app_manager_is_running(const char *app_id, bool *running)
{
if (app_id == NULL)
projects / platform / core / api / app-manager.git / commitdiff