#include <bundle.h>
+#include <sys/types.h>
#ifdef __cplusplus
extern "C" {
/** APP_SVC OPERATION TYPE*/
#define APPSVC_OPERATION_MULTI_SHARE "http://tizen.org/appcontrol/operation/multi_share"
/** APP_SVC OPERATION TYPE*/
-#define APPSVC_OPERATION_COMPOSE "http://tizen.org/appcontorl/opeation/compose"
+#define APPSVC_OPERATION_COMPOSE "http://tizen.org/appcontrol/operation/compose"
/** APP_SVC OPERATION TYPE*/
#define APPSVC_OPERATION_LOCATION "http://tizen.org/appcontrol/operation/configure/location"
/** APP_SVC OPERATION TYPE*/
#define APPSVC_OPERATION_FONT_TYPE "http://tizen.org/appcontrol/operation/configure/font/type"
/** APP_SVC OPERATION TYPE*/
#define APPSVC_OPERATION_FONT_SIZE "http://tizen.org/appcontrol/operation/configure/font/size"
-
+#define APPSVC_OPERATION_LAUNCH_ON_EVENT "http://tizen.org/appcontrol/operation/launch_on_event"
/** APP SVC internal private key */
#define APP_SVC_K_URI_R_INFO "__APP_SVC_URI_R_INFO__"
+#define APP_SVC_K_SELECTOR_EXTRA_LIST "http://tizen.org/appcontrol/data/selector_extra_list"
+
+#ifdef _APPFW_FEATURE_MULTI_INSTANCE
+#define APP_SVC_K_MULTI_INSTANCE "multi_instance"
+#endif
+
+#define APP_SELECTOR "org.tizen.app-selector"
+
+/** Internal operation for launching application which is other zone */
+#define APP_SVC_OPERATION_JUMP "http://tizen.org/appcontrol/operation/jump"
+#define APP_SVC_K_JUMP_ZONE_NAME "__K_JUMP_DOMAIN_NAME__"
+#define APP_SVC_K_JUMP_ORIGIN_OPERATION "__K_JUMP_ORIGIN_OPERATION__"
+#define APP_SVC_K_FOCUS_ZONE "__K_FOCUS_ZONE__"
+
/**
- * @brief Return values in appsvc.
+ * @brief Return values in appsvc.
*/
typedef enum _appsvc_return_val {
+ APPSVC_RET_EREJECTED = -7, /**< application launch rejected */
+ APPSVC_RET_ETERMINATING = -6, /**< application terminating */
APPSVC_RET_EILLACC = -5, /**< Illegal Access */
APPSVC_RET_ELAUNCH = -4, /**< Failure on launching the app */
APPSVC_RET_ENOMATCH = -3, /**< No matching result Error */
/**
- * @brief result values in appsvc.
+ * @brief result values in appsvc.
*/
typedef enum _appsvc_result_val {
APPSVC_RES_CANCEL = -2, /**< Cancel by system */
}appsvc_result_val;
-/**
+/**
* @brief appsvc_res_fn is appsvc result function
- * @param[out] b result bundle
+ * @param[out] b result bundle
* @param[out] request_code request code
* @param[out] result result value
- * @param[out] data user-supplied data
+ * @param[out] data user-supplied data
*/
typedef void (*appsvc_res_fn)(bundle *b, int request_code, appsvc_result_val result, void *data);
-/**
- * @brief iterator function running with appsvc_get_list
- * @param[out] pkg_name package name retreived by appsvc_get_list
- * @param[out] data user-supplied data
+/**
+ * @brief iterator function running with appsvc_get_list
+ * @param[out] appid appid retreived by appsvc_get_list
+ * @param[out] data user-supplied data
*/
typedef int (*appsvc_info_iter_fn)(const char *appid, void *data);
* @par Description:
* This function sets an operation to launch application based on appsvc.
*
- * @param[in] b bundle object
- * @param[in] operation operation
+ * @param[in] b bundle object
+ * @param[in] operation operation
*
* @return 0 if success, negative value(<0) if fail
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see None.
- * @remarks An application must call this function before using appsvc_run_service API.
+ * @remarks An application must call this function before using appsvc_run_service API.
*
* @par Sample code:
* @code
bundle *b = NULL;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_VIEW);
}
* @endcode
* @par Description:
* This function sets an uri to launch application based on appsvc.
*
- * @param[in] b bundle object
- * @param[in] uri uri
+ * @param[in] b bundle object
+ * @param[in] uri uri
*
* @return 0 if success, negative value(<0) if fail
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
bundle *b = NULL;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_VIEW);
appsvc_set_uri(b,"http://www.samsung.com");
}
* @par Description:
* This function sets a mime-type to launch application based on appsvc.
*
- * @param[in] b bundle object
- * @param[in] mime mime-type
+ * @param[in] b bundle object
+ * @param[in] mime mime-type
*
* @return 0 if success, negative value(<0) if fail
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
bundle *b = NULL;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_PICK);
appsvc_set_mime(b,"image/jpg");
}
* @par Description:
* This function sets an extra data to launch application based on appsvc.
*
- * @param[in] b bundle object
- * @param[in] key key of extra data
- * @param[in] val data
+ * @param[in] b bundle object
+ * @param[in] key key of extra data
+ * @param[in] val data
*
* @return 0 if success, negative value(<0) if fail
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
bundle *b = NULL;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_SEND);
appsvc_set_uri(b,"mailto:xxx1@xxx");
appsvc_add_data(b,APPSVC_DATA_CC,"xxx2@xxx");
* @par Description:
* This function sets an extra array data to launch application based on appsvc.
*
- * @param[in] b bundle object
- * @param[in] key key of extra data
- * @param[in] val_array data
+ * @param[in] b bundle object
+ * @param[in] key key of extra data
+ * @param[in] val_array data
* @param[in] len Length of array
*
* @return 0 if success, negative value(<0) if fail
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
* @par Description:
* This function sets a package name to launch application based on appsvc.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
* @param[in] pkg_name package name for explict launch
*
* @return 0 if success, negative value(<0) if fail
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
bundle *b = NULL;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_PICK);
appsvc_set_mime(b,"image/jpg");
appsvc_set_pkgname(b, "org.tizen.mygallery");
*
* @return callee's pid if success, negative value(<0) if fail
* @retval callee's pid - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
- * @retval APPSVC_RET_ENOMATCH - no matching result Error
+ * @retval APPSVC_RET_ENOMATCH - no matching result Error
* @retval APPSVC_RET_ELAUNCH - failure on launching the app
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
static int num = 0;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_PICK);
appsvc_set_mime(b,"image/jpg");
*
*/
int appsvc_run_service(bundle *b, int request_code, appsvc_res_fn cbfunc, void *data);
+int appsvc_usr_run_service(bundle *b, int request_code, appsvc_res_fn cbfunc, void *data, uid_t uid);
/**
* @par Description:
* @return 0 if success, negative value(<0) if fail
* @retval APPSVC_RET_OK - success
* @retval APPSVC_RET_EINVAL - invalid argument(content)
- * @retval APPSVC_RET_ENOMATCH - no matching result Error
+ * @retval APPSVC_RET_ENOMATCH - no matching result Error
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
#include <appsvc.h>
-static int iter_fn(const char* pkg_name, void *data)
+static int iter_fn(const char* appid, void *data)
{
printf("\t==========================\n");
- printf("\t pkg_name: %s\n", pkg_name);
+ printf("\t appid: %s\n", appid);
printf("\t==========================\n");
return 0;
}
static int num = 0;
b = bundle_create();
-
+
appsvc_set_operation(b, APPSVC_OPERATION_PICK);
appsvc_set_mime(b,"image/jpg");
*
*/
int appsvc_get_list(bundle *b, appsvc_info_iter_fn iter_fn, void *data);
+int appsvc_usr_get_list(bundle *b, appsvc_info_iter_fn iter_fn, void *data, uid_t uid);
+
+/**
+ * @par Description:
+ * This API use to get default applications
+ *
+ * @param[in] iter_fn iterator function
+ * @param[in] data user-supplied data for iter_fn
+ *
+ * @return 0 if success, negative value(<0) if fail
+ * @retval APPSVC_RET_OK - success
+ * @retval APPSVC_RET_EINVAL - invalid argument(content)
+ * @retval APPSVC_RET_ENOMATCH - no matching result Error
+ *
+ * @pre None.
+ * @post None.
+ * @see None.
+ * @remarks None.
+ *
+ * @par Sample code:
+ * @code
+#include <appsvc.h>
+
+static int iter_fn(const char* appid, void *data)
+{
+ printf("\t==========================\n");
+ printf("\t appid : %s\n", appid);
+ printf("\t==========================\n");
+ return 0;
+}
+
+...
+{
+ return appsvc_get_all_defapps(iter_fn, (void*)NULL);
+}
+ * @endcode
+ *
+ */
+int appsvc_get_all_defapps(appsvc_info_iter_fn iter_fn, void *data);
/**
* @par Description:
* This function gets a operation from bundle.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
*
* @return Pointer for operation string if success, NULL if fail
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char *val;
+ char *val;
val = appsvc_get_operation(b);
}
* @endcode
* @par Description:
* This function gets a uri from bundle.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
*
* @return Pointer for uri string if success, NULL if fail
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char *val;
+ char *val;
val = appsvc_get_uri(b);
}
* @endcode
* @par Description:
* This function gets a mime-type from bundle.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
*
* @return Pointer for mime-type string if success, NULL if fail
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char *val;
+ char *val;
val = appsvc_get_mime(b);
}
* @endcode
* @par Description:
* This function gets a package name from bundle.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
*
* @return Pointer for package name string if success, NULL if fail
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char *val;
+ char *val;
val = appsvc_get_pkgname(b);
}
* @endcode
* @par Description:
* This function gets value from key.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
* @param[in] key key
*
* @return Pointer for value string if success, NULL if fail
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char *val;
+ char *val;
val = appsvc_get_data(b, APPSVC_DATA_CC);
}
* @endcode
* @par Description:
* This function gets value from key.
*
- * @param[in] b bundle object
+ * @param[in] b bundle object
* @param[in] key key
* @param[out] len length of array
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
...
{
- char **val_array;
+ char **val_array;
int len;
char *val;
if(appsvc_data_is_array(b, APPSVC_DATA_SELECTED))
val_array = appsvc_get_data_array(b, APPSVC_DATA_SELECTED, &len);
- else
+ else
val = appsvc_get_data(b, APPSVC_DATA_SELECTED);
}
* @endcode
* @par Description:
* This API create appsvc result bundle based on bundle received in reset event.
*
- * @param[in] inb bundle received in reset event
- * @param[in] outb bundle to use for returning result
+ * @param[in] inb bundle received in reset event
+ * @param[in] outb bundle to use for returning result
*
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see appsvc_send_result.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
{
struct appdata *ad = data;
bundle* res_bundle;
-
+
appsvc_create_result_bundle(ad->b,&res_bundle);
bundle_add(res_bundle, "result", "1");
appsvc_send_result(res_bundle, 0);
* @param[in] result result value
*
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre appsvc_create_result_bundle.
* @post None.
* @see appsvc_send_result.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
{
struct appdata *ad = data;
bundle* res_bundle;
-
+
appsvc_create_result_bundle(ad->b,&res_bundle);
bundle_add(res_bundle, "result", "1");
appsvc_send_result(res_bundle, 0);
* @param[in] defapp default application
*
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
* @retval APPSVC_RET_EINVAL - invalid argument(content)
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
*
*/
int appsvc_set_defapp(const char *op, const char *mime_type, const char *uri,
- const char *defapp);
+ const char *defapp, uid_t uid);
/**
* @par Description:
* @param[in] defapp default application
*
* @retval APPSVC_RET_OK - success
- * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_ERROR - general error
*
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
* @endcode
*
*/
-int appsvc_unset_defapp(const char *defapp);
+int appsvc_unset_defapp(const char *defapp, uid_t uid);
+
+/**
+ * @par Description:
+ * This API unset all of default applications associated with op, uri and mime-type.
+ *
+ *
+ * @retval APPSVC_RET_OK - success
+ * @retval APPSVC_RET_ERROR - general error
+ *
+ * @pre None.
+ * @post None.
+ * @see None.
+ * @remarks None.
+ *
+ * @par Sample code:
+ * @code
+#include <appsvc.h>
+
+...
+{
+ appsvc_unset_all_defapps();
+}
+ * @endcode
+ *
+ */
+int appsvc_unset_all_defapps();
/**
* @par Description:
* This API ask a application is default application or not.
*
- * @param[in] pkg_name application package name
+ * @param[in] appid application appid
* @return true / false
* @retval 1 app_name is default application in appsvc.
* @retval 0 app_name is NOT default application in appsvc.
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
#include <appsvc.h>
-
+
...
* int is_defapp_browser_app()
- * {
+ * {
* return appsvc_is_defapp("org.tizen.browser");
* }
*
* @endcode
* @remark
* None
-*
+*
*/
-int appsvc_is_defapp(const char *appid);
+int appsvc_is_defapp(const char *appid, uid_t uid);
/**
* @par Description:
* This API ask a extra data is array or not.
*
- * @param[in] b bundle object
- * @param[in] key key of extra data
+ * @param[in] b bundle object
+ * @param[in] key key of extra data
* @return true / false
* @retval 1 a extra data is array.
* @retval 0 a extra data is not array.
* @pre None.
* @post None.
* @see None.
- * @remarks None.
+ * @remarks None.
*
* @par Sample code:
* @code
#include <appsvc.h>
-
+
...
- * int is_defapp_browser_app(bundle *b, char *key)
- * {
+ * int appsvc_data_is_array(bundle *b, char *key)
+ * {
* return appsvc_data_is_array(b, key);
* }
*
* @endcode
* @remark
* None
-*
+*
*/
int appsvc_data_is_array(bundle *b, const char *key);
+int appsvc_subapp_terminate_request_pid(int pid);
+/**
+ * @par Description:
+ * This function sets an uri to launch application based on appsvc.
+ *
+ * @param[in] b bundle object
+ * @param[in] char *mode
+ *
+ * @return 0 if success, negative value(<0) if fail
+ * @retval APPSVC_RET_OK - success
+ * @retval APPSVC_RET_ERROR - general error
+ * @retval APPSVC_RET_EINVAL - invalid argument(content)
+ *
+ * @pre None.
+ * @post None.
+ * @see None.
+ * @remarks None.
+ *
+ * @par Sample code:
+ * @code
+#include <appsvc.h>
+
+...
+{
+ appsvc_set_launch_mode(app_control->data, mode);
+}
+ * @endcode
+ *
+ */
+int appsvc_set_launch_mode(bundle *b, const char *mode);
+
+/**
+ * @par Description:
+ * This function sets an uri to launch application based on appsvc.
+ *
+ * @param[in] b bundle object
+ *
+ * @return Pointer for launch mode string if success, NULL if fail
+ *
+ * @pre None.
+ * @post None.
+ * @see None.
+ * @remarks None.
+ *
+ * @par Sample code:
+ * @code
+#include <appsvc.h>
+
+...
+{
+ appsvc_get_launch_mode(app_control->data);
+}
+ * @endcode
+ *
+ */
+const char *appsvc_get_launch_mode(bundle *b);
#ifdef __cplusplus
}
#endif
projects / platform / core / appfw / app-svc.git / blobdiff