/**
* @brief Application context handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct app_context_s *app_context_h;
/**
* @brief Enumeration for Application Context Event.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef enum {
APP_CONTEXT_EVENT_LAUNCHED, /**< The application is launched */
/**
* @brief Destroys the application context handle and releases all its resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] app_context The application context handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @deprecated Deprecated since 2.3.1. Use app_context_get_app_id() instead.
* @brief Gets the application ID with the given application context.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release @a package using free().
* @param[in] app_context The application context
* @param[out] package The application ID of the given application context
/**
* @brief Gets the application ID with the given application context.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Gets the process ID with the given application context.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] app_context The application context
* @param[out] pid The process ID of the given application context
* @return @c 0 on success,
/**
* @brief Checks whether the application with the given application context is terminated.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Checks whether two application contexts are equal.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Clones the application context handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The @a clone should be released using app_context_destroy()
* @param[out] clone The newly created application context handle, if cloning is successful
* @param[in] app_context The application context
/**
* @brief Definition for string property for filtering based on app info: String property for filtering packages with app id.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define PACKAGE_INFO_PROP_APP_ID "PACKAGE_INFO_PROP_APP_ID"
/**
* @brief Definition for string property for filtering based on app info: String property for filtering packages with app type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define PACKAGE_INFO_PROP_APP_TYPE "PACKAGE_INFO_PROP_APP_TYPE"
/**
* @brief Definition for string property for filtering based on app info: String property for filtering packages with app category.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define PACKAGE_INFO_PROP_APP_CATEGORY "PACKAGE_INFO_PROP_APP_CATEGORY"
/**
* @brief Definition for boolean property for filtering based on app info: Boolean property for filtering whether the package is nodisplay or not based on package info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define PACKAGE_INFO_PROP_APP_NODISPLAY "PACKAGE_INFO_PROP_APP_NODISPLAY"
/**
* @brief Definition for boolean property for filtering based on app info: Boolean property for filtering whether the package has the authority to manage task or not based on package info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define PACKAGE_INFO_PROP_APP_TASKMANAGE "PACKAGE_INFO_PROP_APP_TASKMANAGE"
/**
* @brief Application information handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct app_info_s *app_info_h;
/**
* @brief Application filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct app_info_filter_s *app_info_filter_h;
/**
* @brief Application metadata filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] metadata_key The key 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()
/**
* @brief Creates the application information handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The @a app_info should be released using app_info_destroy().
* @param[in] app_id The application ID
* @param[out] app_info The application information handle
/**
* @brief Destroys the application information handle and releases all its resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Gets the executable path of the application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Gets the label of the application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release @a label using free().
* @param[in] app_info The application information
* @param[out] label The label of the application
/**
* @brief Gets the localed name of the application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release localed name using free().
* @param[in] app_id The application ID
* @param[in] locale The locale information
/**
* @brief Gets the absolute path to the icon image.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release @a path using free().
* @param[in] app_info The application information
* @param[out] path The absolute path to the icon
/**
* @brief Gets the package name.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release @a package name using free().
* @param[in] app_info The application information
* @param[out] package The package name
/**
* @brief Gets the package type name.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release package @a type name using free().
* @param[in] app_info The application information
* @param[out] type The package type
/**
* @brief Gets the list of metadata for a particular application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Checks whether application information is nodisplay.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Checks whether application is enabled.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The @a clone should be released using app_info_destroy().
* @param[out] clone A newly created application information handle, if successfully cloned
* @param[in] app_info The application information
/**
* @brief Creates the application information filter handle from DB.
* All filter properties will be ANDed.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The @a handle should be released using app_info_filter_destroy().
* @param[out] handle The pointer to the application info filter handle
* @return @c 0 on success,
/**
* @brief Destroys the application information filter handle, freeing up all the resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] handle The pointer to the application info filter handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Adds a boolean filter property to the filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Adds a string filter property to the filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Gets the count of filtered apps.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Creates the application's metadata information filter handle from DB.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The @a handle should be released using app_info_metadata_filter_destroy().
* @param[out] handle The pointer to the application metadata info filter handle
* @return @c 0 on success,
/**
* @brief Destroys the application's metadata information filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] handle The pointer to the application info filter handle
* @return @c 0 on success,
* otherwise a negative error value
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Enumerations for Application Manager Error.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
APP_MANAGER_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
/**
* @brief Called when an application is launched or terminated.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks Please don't try to free the handle of app_context, because it is managed by the framework.
* @param[in] app_context The application context of the application launched or terminated
* @param[in] event The application context event
/**
* @brief Called to get the application context once for each running application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 Registers a callback function to be invoked when the applications get launched or terminated.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success,
/**
* @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @see app_manager_app_context_event_cb()
*/
void app_manager_unset_app_context_event_cb(void);
/**
* @brief Retrieves all application contexts of running applications.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks In case of ui applications, sub apps in application groups will not be shown.
* @param[in] callback The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Gets the application context for the given ID of the application.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function returns #APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given application ID is not running. \n
* You must release @a app_context using app_context_destroy().
* @param[in] app_id The ID of the application
/**
* @brief Gets the ID of the application for the given process ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function returns #APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given process ID is not valid. \n
* You must release @a app_id using free().
* @param[in] pid The process ID of the application
/**
* @brief Checks whether the application with the given ID of the application is running.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.launch
* @param[in] app_context The application context
/**
* @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 function.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.kill.bgapp
* @remarks This function returns after it just sends a request for terminating a background application.\n
/**
* @brief Retrieves all installed applications information.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success,
/**
* @brief Gets the application information for the given application ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must release @a app_info using app_info_destroy().
* @param[in] app_id The ID of the application
* @param[out] app_info The application information for the given application ID
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specified @a path should be released with free().\n
* Since Tizen 3.0, the shared/data directory is supported only for the applications that declare the %http://tizen.org/privilege/appdir.shareddata privilege.
* The function will fail with #APP_MANAGER_ERROR_NOT_SUPPORTED if the privilege is not declared.
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specified @a path should be released with free().
*
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specified @a path should be released with free().
*
* @param[in] app_id The ID of the application
int app_manager_get_shared_trusted_path(const char *app_id, char **path);
/**
- * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
+ * @deprecated Deprecated since 2.4.
* @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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specified @a path should be released with free().
* @remarks To access the path returned by this function may not work as intended in certain devices due to some implementation issues.
*