From: Changgyu Choi Date: Mon, 17 Mar 2025 10:10:40 +0000 (+0900) Subject: Deprecated component-based-app efl api X-Git-Tag: accepted/tizen/unified/20250324.140551~3 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=01ae762a353a3582d6e89b648b434e0b194597b3;p=platform%2Fcore%2Fappfw%2Fcomponent-based-application.git 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 --- diff --git a/component_based/efl_base/api/frame_component.h b/component_based/efl_base/api/frame_component.h index e9c9f02..4e0b97f 100644 --- 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 e3c3503..4c205d2 100644 --- 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 9ad45bc..0526eb3 100755 --- 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 *