Deprecated component-based-app efl api

Since Tizen 10.0, EFL will be deprecated.
component-based-app that depend on the efl api will also be deprecated.

Change-Id: I741be63391794b6656bba12abb381bd23ab55708
Signed-off-by: Changgyu Choi <changyu.choi@samsung.com>

diff --git a/component_based/efl_base/api/frame_component.h b/component_based/efl_base/api/frame_component.h
index e9c9f02e959819714746f2c1841afc5cfcdca7d7..4e0b97fafac740fa1d5ff3d3e867a431314a0964 100644 (file)
--- a/component_based/efl_base/api/frame_component.h
+++ b/component_based/efl_base/api/frame_component.h
@@ -33,6 +33,7 @@ extern "C" {
 
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the frame component instance is created.
  * @details The returned Evas_Object MUST NOT be released using evas_object_del(). The platform frees the window when the frame component instance is destroyed.
  * @since_tizen 5.5
@@ -50,6 +51,7 @@ typedef Evas_Object *(*frame_component_create_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the frame component instance is started.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -68,6 +70,7 @@ typedef void (*frame_component_start_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the frame component becomes visible.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -80,6 +83,7 @@ typedef void (*frame_component_resume_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the frame component becomes invisible.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -92,6 +96,7 @@ typedef void (*frame_component_pause_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called before the frame component instance is stopped.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -104,6 +109,7 @@ typedef void (*frame_component_stop_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called before the frame component instance is destroyed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -116,6 +122,7 @@ typedef void (*frame_component_destroy_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called after the content information of the frame component instance is restored.
  * @since_tizen 5.5
  * @remarks The @a content should not be released. The @a content can be used only in the callback.
@@ -131,6 +138,7 @@ typedef void (*frame_component_restore_content_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called before the content information of the frame component instance is saved.
  * @since_tizen 5.5
  * @remarks The @a content should not be released. The @a content can be used only in the callback.
@@ -146,6 +154,7 @@ typedef void (*frame_component_save_content_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when another application sends a launch request to the component.
  * @details Before calling frame_component_start_cb(), this callback function is called.
  * @since_tizen 5.5
@@ -170,6 +179,7 @@ typedef void (*frame_component_action_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the device orientation is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -184,6 +194,7 @@ typedef void (*frame_component_device_orientation_changed_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the system language is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -199,6 +210,7 @@ typedef void (*frame_component_language_changed_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the system region format is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -214,6 +226,7 @@ typedef void (*frame_component_region_format_changed_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the battery status is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -228,6 +241,7 @@ typedef void (*frame_component_low_battery_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the memory status is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -242,6 +256,7 @@ typedef void (*frame_component_low_memory_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the suspended state of the frame component is changed.
  * @since_tizen 5.5
  * @remarks The @a context should not be released. The @a context can be used only in the callback.
@@ -256,6 +271,7 @@ typedef void (*frame_component_suspended_state_changed_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Called when the time zone of the frame component is changed.
  * @details An application can obtain a changed time zone (e.g., "+9:00") and a time zone id (e.g., "Asia/Seoul").
  * @since_tizen 8.0
@@ -274,6 +290,7 @@ typedef void (*frame_component_time_zone_changed_cb)(
                void *user_data);
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief The structure type containing the set of callback functions for lifecycle of a frame component instance.
  * @since_tizen 5.5
  */
@@ -297,6 +314,7 @@ typedef struct {
 } frame_component_lifecycle_callback_s;
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Gets the display status.
  * @since_tizen 5.5
  *
@@ -311,9 +329,10 @@ typedef struct {
  * @retval #COMPONENT_ERROR_INVALID_CONTEXT The display is in an unknown state.
  */
 int frame_component_get_display_status(component_h context,
-               component_display_status_e *display_status);
+               component_display_status_e *display_status) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 10.0.
  * @brief Gets an Evas object for the frame component.
  * @since_tizen 5.5
  * @remarks The @c window MUST NOT be released using evas_object_del().
@@ -328,7 +347,7 @@ int frame_component_get_display_status(component_h context,
  * @retval #COMPONENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int frame_component_get_window(component_h context,
-               Evas_Object **window);
+               Evas_Object **window) TIZEN_DEPRECATED_API;
 
 
 /**

diff --git a/component_based/efl_base/stub.cc b/component_based/efl_base/stub.cc
index e3c3503456757e168c03f0c0af8d882a0658a7ce..4c205d23fcffe3ddbad3517e1bd648babeda50a0 100644 (file)
--- a/component_based/efl_base/stub.cc
+++ b/component_based/efl_base/stub.cc
@@ -553,6 +553,7 @@ component_based_app_add_service_component(
 
 extern "C" EXPORT_API int frame_component_get_display_status(
     component_h context, component_display_status_e* display_status) {
+  LOGW("DEPRECATION WARNING: %s() is deprecated and will be removed from future release.", __FUNCTION__);
   if (context == nullptr || display_status == nullptr) {
     LOGE("Invalid parameter");
     return COMPONENT_ERROR_INVALID_PARAMETER;
@@ -582,6 +583,7 @@ extern "C" EXPORT_API int frame_component_get_display_status(
 extern "C" EXPORT_API int frame_component_get_window(
     component_h context,
     Evas_Object** window) {
+  LOGW("DEPRECATION WARNING: %s() is deprecated and will be removed from future release.", __FUNCTION__);
   if (context == nullptr || window == nullptr) {
     LOGE("Invalid parameter");
     return COMPONENT_ERROR_INVALID_PARAMETER;

diff --git a/doc/appfw_component_based_application_doc.h b/doc/appfw_component_based_application_doc.h
index 9ad45bc51316c27fa9f97f3124b43daea431c23d..0526eb33e8f7b36a9d5780ac1c4cfdd104065157 100755 (executable)
--- a/doc/appfw_component_based_application_doc.h
+++ b/doc/appfw_component_based_application_doc.h
@@ -67,7 +67,7 @@
  */
 
 /**
- * @defgroup COMPONENT_BASED_FRAME_COMPONENT_MODULE Frame Component
+ * @defgroup COMPONENT_BASED_FRAME_COMPONENT_MODULE Frame Component (Deprecated)
  * @ingroup COMPONENT_BASED_APPLICATION_MODULE
  * @brief The @ref COMPONENT_BASED_FRAME_COMPONENT_MODULE API provides functions for handling Frame Component state changes or system events, and get information about the Frame Component
  *