Tizen Native API
|
Functions | |
int | app_manager_set_app_context_event_cb (app_manager_app_context_event_cb callback, void *user_data) |
Registers a callback function to be invoked when the applications get launched or terminated. | |
void | app_manager_unset_app_context_event_cb (void) |
Unregisters the callback function. | |
int | app_manager_foreach_app_context (app_manager_app_context_cb callback, void *user_data) |
Retrieves all application contexts of running applications. | |
int | app_manager_get_app_context (const char *app_id, app_context_h *app_context) |
Gets the application context for the given ID of the application. | |
int | app_manager_get_app_id (pid_t pid, char **app_id) |
Gets the ID of the application for the given process ID. | |
int | app_manager_is_running (const char *app_id, bool *running) |
Checks whether the application with the given package name is running. | |
int | app_manager_resume_app (app_context_h app_context) |
Resumes the application. | |
int | app_manager_request_terminate_bg_app (app_context_h app_context) |
Terminates the back ground application. UI applications that are in paused state or some service applications could be required to terminate by this API. | |
int | app_manager_foreach_app_info (app_manager_app_info_cb callback, void *user_data) |
Retrieves all installed applications information. | |
int | app_manager_get_app_info (const char *app_id, app_info_h *app_info) |
Gets the application information for the given application ID. | |
int | app_manager_get_shared_data_path (const char *app_id, char **path) |
Gets the absolute path to the shared data directory of the application specified with an application ID. | |
int | app_manager_get_shared_resource_path (const char *app_id, char **path) |
Gets the absolute path to the shared resource directory of the application specified with an application ID. | |
int | app_manager_get_shared_trusted_path (const char *app_id, char **path) |
Gets the absolute path to the shared trusted directory of the application specified with an application ID. | |
int | app_manager_get_external_shared_data_path (const char *app_id, char **path) |
Gets the absolute path to the shared data directory of the application specified with an application ID. | |
Typedefs | |
typedef void(* | app_manager_app_context_event_cb )(app_context_h app_context, app_context_event_e event, void *user_data) |
Called when an application is launched or terminated. | |
typedef bool(* | app_manager_app_context_cb )(app_context_h app_context, void *user_data) |
Called to get the application context once for each running application. | |
typedef bool(* | app_manager_app_info_cb )(app_info_h app_info, void *user_data) |
Called to get the application information once for each installed application. |
The Application Manager API provides functions to get information about installed or running applications and manage the applications.
Required Header
#include <app_manager.h>
Overview
The Application Manager API provides information about applications. There are several different sorts of queries. Two iterator functions step through a list of applications. One is used in running applications(app_manager_foreach_app_context()), and the other is used in available ("installed") but not necessarily running applications(app_manager_foreach_app_info()). Each will call a callback function, passing the package name of each application found. A query function will respond whether the application represented by a particular package name is running. Other query functions return static information about an application, such as a name, a type, an icon path, or a version. The API provides functions to manage applications also. By using them, it is possible to resume(app_manager_resume_app) applications.
Typedef Documentation
typedef bool(* app_manager_app_context_cb)(app_context_h app_context, void *user_data) |
Called to get the application context once for each running application.
- Since :
- 2.3
- Parameters:
-
[in] app_context The application context of each running application [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:
- app_manager_foreach_app_context() will invoke this callback.
- See also:
- app_manager_foreach_app_context()
typedef void(* app_manager_app_context_event_cb)(app_context_h app_context, app_context_event_e event, void *user_data) |
Called when an application is launched or terminated.
- Since :
- 2.4
- Parameters:
-
[in] app_context The application context of the application launched or terminated [in] event The application context event [in] user_data The user data passed from the foreach function
- Precondition:
- This function is called when an application gets launched or terminated, after you register this callback using app_manager_set_app_context_event_cb().
typedef bool(* app_manager_app_info_cb)(app_info_h app_info, void *user_data) |
Called to get the application information once for each installed application.
- Since :
- 2.3
- Parameters:
-
[in] app_info The application information of each installed application [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:
- app_manager_foreach_app_info() will invoke this callback.
- See also:
- app_manager_foreach_app_info()
Enumeration Type Documentation
enum app_manager_error_e |
Enumerations for Application Manager Error .
- Since :
- 2.3
- Enumerator:
Function Documentation
int app_manager_foreach_app_context | ( | app_manager_app_context_cb | callback, |
void * | user_data | ||
) |
Retrieves all application contexts of running applications.
- Since :
- 2.3
- Parameters:
-
[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:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- Postcondition:
- This function invokes app_manager_app_context_cb() for each application context.
- See also:
- app_manager_app_context_cb()
int app_manager_foreach_app_info | ( | app_manager_app_info_cb | callback, |
void * | user_data | ||
) |
Retrieves all installed applications information.
- Since :
- 2.3
- Parameters:
-
[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:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
- Postcondition:
- This function invokes app_manager_app_info_cb() for each application information.
- See also:
- app_manager_app_info_cb()
int app_manager_get_app_context | ( | const char * | app_id, |
app_context_h * | app_context | ||
) |
Gets the application context for the given ID of the application.
- Since :
- 2.3
- Remarks:
- This function returns APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given application ID is not running.
You must release app_context using app_context_destroy().
- Parameters:
-
[in] app_id The ID of the application [out] app_context The application context of the given application ID
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory APP_MANAGER_ERROR_NO_SUCH_APP No such application
int app_manager_get_app_id | ( | pid_t | pid, |
char ** | app_id | ||
) |
Gets the ID of the application for the given process ID.
- Since :
- 2.3
- Remarks:
- This function returns APP_MANAGER_ERROR_NO_SUCH_APP if the application with the given process ID is not valid.
You must release app_id using free().
- Parameters:
-
[in] pid The process ID of the application [out] app_id The ID of the application
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_manager_get_app_info | ( | const char * | app_id, |
app_info_h * | app_info | ||
) |
Gets the application information for the given application ID.
- Since :
- 2.3
- Remarks:
- You must release app_info using app_info_destroy().
- Parameters:
-
[in] app_id The ID of the application [out] app_info The application information for the given application ID
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory APP_MANAGER_ERROR_NO_SUCH_APP No such application
int app_manager_get_external_shared_data_path | ( | const char * | app_id, |
char ** | path | ||
) |
Gets the absolute path to the shared data directory of the application specified with an application ID.
- Deprecated:
- Deprecated since 2.4.
An application can only read the files of other application's shared data directory.
- Since :
- 2.3
- Remarks:
- The specified path should be released.
- To access the path returned by this function may not work as intended in certain devices due to some implementation issues.
- Parameters:
-
[in] app_id The ID of the application [in,out] path The absolute path to the shared data directory of the application specified with the app_id
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_NO_SUCH_APP No such application APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_manager_get_shared_data_path | ( | const char * | app_id, |
char ** | path | ||
) |
Gets the absolute path to the shared data directory of the application specified with an application ID.
An application can only read the files of other application's shared data directory.
- Since :
- 2.3
- Remarks:
- The specified path should be released.
- Parameters:
-
[in] app_id The ID of the application [in,out] path The absolute path to the shared data directory of the application specified with the app_id
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_NO_SUCH_APP No such application APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_manager_get_shared_resource_path | ( | const char * | app_id, |
char ** | path | ||
) |
Gets the absolute path to the shared resource directory of the application specified with an application ID.
An application can only read the files of other application's shared resource directory.
- Since :
- 2.3
- Remarks:
- The specified path should be released.
- Parameters:
-
[in] app_id The ID of the application [in,out] path The absolute path to the shared resource directory of the application specified with the app_id
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_NO_SUCH_APP No such application APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_manager_get_shared_trusted_path | ( | const char * | app_id, |
char ** | path | ||
) |
Gets the absolute path to the shared trusted directory of the application specified with an application ID.
An application signed with the same certificate can read and write the files of other application's shared trusted directory.
- Since :
- 2.3
- Remarks:
- The specified path should be released.
- Parameters:
-
[in] app_id The ID of the application [in,out] path The absolute path to the shared trusted directory of the application specified with the app_id
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_NO_SUCH_APP No such application APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_manager_is_running | ( | const char * | app_id, |
bool * | running | ||
) |
Checks whether the application with the given package name is running.
- Since :
- 2.3
- Parameters:
-
[in] app_id The ID of the application [out] running true
if the application is running,
otherwisefalse
if not running
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int app_manager_request_terminate_bg_app | ( | app_context_h | app_context | ) |
Terminates the back ground application.
UI applications that are in paused state or some service applications could be required to terminate by this API.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/appmanager.kill.bgapp
- Remarks:
- This function returns after it just sends a request for terminating a background application.
Platform will decide if the target application could be terminated or not according to the state of the target application.
- Parameters:
-
[in] app_context The application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_REQUEST_FAILED Failed to send terminate request APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
int app_manager_resume_app | ( | app_context_h | app_context | ) |
Resumes the application.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/appmanager.launch
- Parameters:
-
[in] app_context The application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_APP_NO_RUNNING App is not running APP_MANAGER_ERROR_REQUEST_FAILED Internal resume error APP_MANAGER_ERROR_PERMISSION_DENIED Permission denied
int app_manager_set_app_context_event_cb | ( | app_manager_app_context_event_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the applications get launched or terminated.
- Since :
- 2.4
- Parameters:
-
[in] callback The callback function to register [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- Postcondition:
- It will invoke app_manager_app_context_event_cb() when the application is launched or terminated.
void app_manager_unset_app_context_event_cb | ( | void | ) |
Unregisters the callback function.
- Since :
- 2.4
- See also:
- app_manager_set_app_event_cb()
- app_manager_app_context_event_cb()