diff options
author | Hwankyu Jhun <h.jhun@samsung.com> | 2016-01-13 20:30:07 +0900 |
---|---|---|
committer | HwanKyu Jhun <h.jhun@samsung.com> | 2016-02-01 15:00:04 -0800 |
commit | 219f14076eefec7275b40754932c791f593bc158 (patch) | |
tree | 39d87110f9989bbe55a97d6c4e4f260ce2b0f63c /include | |
parent | 89b39d6803340306c5e0cca75c70980858b46ab1 (diff) | |
download | application-219f14076eefec7275b40754932c791f593bc158.tar.gz application-219f14076eefec7275b40754932c791f593bc158.tar.bz2 application-219f14076eefec7275b40754932c791f593bc158.zip |
Deprecate shared directory related APIsubmit/tizen/20160202.010556submit/tizen/20160202.002216
- app_get_shared_data_path() is deprecated
Change-Id: Ib95914191f395c08172facbd875b64630d1788a3
Signed-off-by: Hwankyu Jhun <h.jhun@samsung.com>
Diffstat (limited to 'include')
-rw-r--r-- | include/app_common.h | 21 | ||||
-rw-r--r-- | include/app_types.h | 1 |
2 files changed, 20 insertions, 2 deletions
diff --git a/include/app_common.h b/include/app_common.h index 992a4d3..774c40e 100644 --- a/include/app_common.h +++ b/include/app_common.h @@ -340,15 +340,32 @@ char *app_get_resource_path(void); /** + * @deprecated Deprecated since 3.0. * @brief Gets the absolute path to the application's shared data directory which is used to share * data with other applications. * @details An application can read and write its own files in the application's shared data * directory and others can only read the files. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @remarks The returned path should be released. + * @remarks The returned path should be released. @n + * shared/data directory is not supported since Tizen 3.0. + * You MUST NOT use this API when you develop new application. + * Actually, we strongly recommend to stop using shared/data path for all your previous applications. + * Files in shared/data directory can be read by all other applications. + * You cannot control what applications can read the files in shared/data directory. + * If you want to share files with other applications, consider passing path via @ref CAPI_APP_CONTROL_MODULE API. + * The @ref CAPI_APP_CONTROL_MODULE API supports giving permission to other applications by passing path via app_control. @n + * shared/data directory is only available for applications with api-version lower than 3.0 from Tizen 3.0 platform. + * The applications with api-version from 3.0 cannot access other applications' shared/data directory. + * For example, a Tizen 2.4 application can access another Tizen 2.4 application's shared/data directory as it did in Tizen 2.4 platform. + * However, a Tizen 3.0 application cannot access another application's shared/data directory even the another application is Tizen 2.4 application. + * Note that Tizen 3.0 platform only supports shared/data directory among applications with api-version lower than 3.0 for minimum backward compatibility. @n + * The specific error code can be obtained using the get_last_result(). Error codes are described in Exception section. * * @return The absolute path to the application's shared data directory, @n - * otherwise a null pointer if the memory is insufficient + * otherwise a null pointer if the memory is insufficient. It will return NULL for 3.0 application, and set to APP_ERROR_NOT_SUPPORTED. + * @exception APP_ERROR_NONE Success + * @exception APP_ERROR_OUT_OF_MEMORY Out of memory + * @exception APP_ERROR_NOT_SUPPORTED Not supported */ char *app_get_shared_data_path(void); diff --git a/include/app_types.h b/include/app_types.h index bef1f42..0ca8575 100644 --- a/include/app_types.h +++ b/include/app_types.h @@ -42,6 +42,7 @@ typedef enum { APP_ERROR_NO_SUCH_FILE = TIZEN_ERROR_NO_SUCH_FILE, /**< No such file or directory */ APP_ERROR_ALREADY_RUNNING = TIZEN_ERROR_ALREADY_IN_PROGRESS, /**< Application is already running */ APP_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied @if MOBILE (Since 2.3.1) @endif */ + APP_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< Not supported (Since 3.0) */ } app_error_e; /** |