diff --git a/AbilityKit/ability_runtime/application_context.h b/AbilityKit/ability_runtime/application_context.h index 00c5d579d453d5a8c0619d9712f438f26a18565d..ed62cf40293ae91ec6ccbeaefa601c04a514f874 100644 --- a/AbilityKit/ability_runtime/application_context.h +++ b/AbilityKit/ability_runtime/application_context.h @@ -294,19 +294,6 @@ AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbility(AbilityBase_Want * AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbilityWithStartOptions(AbilityBase_Want *want, AbilityRuntime_StartOptions *options); - /** - * @brief Obtain the version code of the application. - * - * @param versionCode The version code of the application. - * @return The error code. - * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} if the operation is successful. - * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} if the versionCode is null. - * {@link ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST} if the application context does not exist. - * {@link ABILITY_RUNTIME_ERROR_CODE_GET_APPLICATION_INFO_FAILED} if the application info does not exist. - * @since 21 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetVersionCode(int64_t* versionCode); - #ifdef __cplusplus } // extern "C" #endif diff --git a/AbilityKit/ability_runtime/libability_runtime.ndk.json b/AbilityKit/ability_runtime/libability_runtime.ndk.json index f7939128e402a6a67baa4deac6554689b64f434d..6790d7d683b7cd97f6cc22c4bbe81b71f9080e18 100644 --- a/AbilityKit/ability_runtime/libability_runtime.ndk.json +++ b/AbilityKit/ability_runtime/libability_runtime.ndk.json @@ -178,9 +178,5 @@ { "first_introduced": "20", "name": "OH_AbilityRuntime_ApplicationContextGetResourceDir" - }, - { - "first_introduced": "21", - "name": "OH_AbilityRuntime_ApplicationContextGetVersionCode" } ] \ No newline at end of file diff --git a/BasicServicesKit/commonevent/oh_commonevent.h b/BasicServicesKit/commonevent/oh_commonevent.h index d3f16a959a7268aa4bfa0d6b10580c5c0be36b15..a5cca763b88a3edaceb57588159d05487dcbe8a6 100644 --- a/BasicServicesKit/commonevent/oh_commonevent.h +++ b/BasicServicesKit/commonevent/oh_commonevent.h @@ -227,19 +227,19 @@ CommonEvent_ErrCode OH_CommonEvent_UnSubscribe(const CommonEvent_Subscriber* sub const char* OH_CommonEvent_GetEventFromRcvData(const CommonEvent_RcvData* rcvData); /** - * @brief Get event result code from callback data. + * @brief Get event code from callback data. * * @param rcvData Indicates the callback data. - * @return Returns the event of result code, default is 0. + * @return Returns the event of code, default is 0. * @since 12 */ int32_t OH_CommonEvent_GetCodeFromRcvData(const CommonEvent_RcvData* rcvData); /** - * @brief Get event result data from callback data. + * @brief Get event data from callback data. * * @param rcvData Indicates the callback data. - * @return Returns the event of result data, default is null. + * @return Returns the event of data, default is null. * @since 12 */ const char* OH_CommonEvent_GetDataStrFromRcvData(const CommonEvent_RcvData* rcvData); @@ -628,7 +628,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetDoubleArrayToParameters(CommonEvent_Parame const double* value, size_t num); /** - * @brief Publish a standard commen event. + * @brief Publish a commen event. * * @param event Indicates the name of the common event. * @return Returns the error code. @@ -704,39 +704,39 @@ bool OH_CommonEvent_AbortCommonEvent(CommonEvent_Subscriber* subscriber); bool OH_CommonEvent_ClearAbortCommonEvent(CommonEvent_Subscriber* subscriber); /** - * @brief Get result code from an ordered event by a subscriber. + * @brief Get code from an ordered event by a subscriber. * * @param subscriber Indicates the subscriber. - * @return Returns the result code, default is 0. + * @return Returns the code, default is 0. * @since 18 */ int32_t OH_CommonEvent_GetCodeFromSubscriber(const CommonEvent_Subscriber* subscriber); /** - * @brief Set result code to an ordered event by a subscriber. + * @brief Set code to an ordered event by a subscriber. * * @param subscriber Indicates the subscriber. - * @param code Indicates the result code. + * @param code Indicates the code. * @return Returns the result of operation, true means succeeded. * @since 18 */ bool OH_CommonEvent_SetCodeToSubscriber(CommonEvent_Subscriber* subscriber, int32_t code); /** - * @brief Get result data from an ordered event by a subscriber. + * @brief Get data from an ordered event by a subscriber. * * @param subscriber Indicates the subscriber. - * @return Returns the result data, default is null. + * @return Returns the data, default is null. * @since 18 */ const char* OH_CommonEvent_GetDataFromSubscriber(const CommonEvent_Subscriber* subscriber); /** - * @brief Set result data to an ordered event by a subscriber. + * @brief Set data to an ordered event by a subscriber. * * @param subscriber Indicates the subscriber. - * @param data Indicates the result data. - * @param length Indicates the length of result data. + * @param data Indicates the data. + * @param length Indicates the length of data. * @return Returns the result of operation, true means succeeded. * @since 18 */ diff --git a/ability/ability_runtime/child_process/native_child_process.h b/ability/ability_runtime/child_process/native_child_process.h index ce59adf740bd17bd4832cc76d0e6ef13fddae81c..796b7920568dced863d3bfd65d42f8003afd124a 100644 --- a/ability/ability_runtime/child_process/native_child_process.h +++ b/ability/ability_runtime/child_process/native_child_process.h @@ -152,13 +152,13 @@ typedef struct Ability_ChildProcessConfigs Ability_ChildProcessConfigs; Ability_ChildProcessConfigs* OH_Ability_CreateChildProcessConfigs(); /** - * @brief Destroys a child process configs object and releases associated rescources. + * @brief Destroys a child process configs object and releases associated resources. * * @param configs Pointer to the child process configs object to be destroyed. * After this call, the pointer becomes invalid and must not be used. * Passing nullptr is allowed and will be ignored. * @return Returns {@link NCP_NO_ERROR} if the operation is successful or if the input is nullptr. - * Returns {@link NCP_NO_ERR_INVALID_PARAM} if the input parameters are invalid. + * Returns {@link NCP_ERR_INVALID_PARAM} if the input parameters are invalid. * @since 20 */ Ability_NativeChildProcess_ErrCode OH_Ability_DestroyChildProcessConfigs(Ability_ChildProcessConfigs* configs); @@ -169,8 +169,8 @@ Ability_NativeChildProcess_ErrCode OH_Ability_DestroyChildProcessConfigs(Ability * * @param configs Pointer to the child process configs object. Must not be nullptr. * @param isolationMode The isolation mode to set. See {@link NativeChildProcess_IsolationMode} for details. - * @return Returns {@link NCP_NO_ERROR} if the isolation mode is set successful. - * Returns {@link NCP_NO_ERR_INVALID_PARAM} if the input parameters are invalid. + * @return Returns {@link NCP_NO_ERROR} if the isolation mode is set successfully. + * Returns {@link NCP_ERR_INVALID_PARAM} if the input parameters are invalid. * @since 20 */ Ability_NativeChildProcess_ErrCode OH_Ability_ChildProcessConfigs_SetIsolationMode( @@ -184,8 +184,8 @@ Ability_NativeChildProcess_ErrCode OH_Ability_ChildProcessConfigs_SetIsolationMo * Must be a non-empty string containing only letters, digits, or underscores. * Maximum length is 64 characters. * The name ultimately assigned to the process is {bundleName}:{processName}. - * @return Returns {@link NCP_NO_ERROR} if the process name is set successful. - * Returns {@link NCP_NO_ERR_INVALID_PARAM} if the input parameters are invalid. + * @return Returns {@link NCP_NO_ERROR} if the process name is set successfully. + * Returns {@link NCP_ERR_INVALID_PARAM} if the input parameters are invalid. * @since 20 */ Ability_NativeChildProcess_ErrCode OH_Ability_ChildProcessConfigs_SetProcessName(Ability_ChildProcessConfigs* configs, @@ -426,7 +426,7 @@ Ability_NativeChildProcess_ErrCode OH_Ability_StartNativeChildProcessWithConfigs NativeChildProcess_Args* OH_Ability_GetCurrentChildProcessArgs(); /** - * @brief Define a callback function to handle the exit of a native child process. + * @brief Defines a callback function to handle the exit of a native child process. * * @param pid The pid of the exited native child process. * @param signal The signal of the exited native child process. @@ -434,14 +434,13 @@ NativeChildProcess_Args* OH_Ability_GetCurrentChildProcessArgs(); */ typedef void (*OH_Ability_OnNativeChildProcessExit)(int32_t pid, int32_t signal); -/** + /** * @brief Register a native child process exit callback. * Registering the same callback repeatedly will only keep one. * * @param onProcessExit Pointer to the callback function to handle the exit of a native child process. * For details, see {@link OH_Ability_OnNativeChildProcessExit}. * @return Returns {@link NCP_NO_ERROR} if the call is successful. - * Returns {@link NCP_ERR_INVALID_PARAM} if the param is invalid. * Returns {@link NCP_ERR_INTERNAL} if internal error occurs. * For details, see {@link Ability_NativeChildProcess_ErrCode}. * @since 20 @@ -449,13 +448,12 @@ typedef void (*OH_Ability_OnNativeChildProcessExit)(int32_t pid, int32_t signal) Ability_NativeChildProcess_ErrCode OH_Ability_RegisterNativeChildProcessExitCallback( OH_Ability_OnNativeChildProcessExit onProcessExit); -/** + /** * @brief Unregister a native child process exit callback. * * @param onProcessExit Pointer to the callback function to handle the exit of a native child process. * For details, see {@link OH_Ability_OnNativeChildProcessExit}. * @return Returns {@link NCP_NO_ERROR} if the call is successful. - * Returns {@link NCP_ERR_INVALID_PARAM} if the param is invalid. * Returns {@link NCP_ERR_INTERNAL} if internal error occurs. * Returns {@link NCP_ERR_CALLBACK_NOT_EXIST} if the callback is not exist. * For details, see {@link Ability_NativeChildProcess_ErrCode}. diff --git a/arkui/ace_engine/native/drag_and_drop.h b/arkui/ace_engine/native/drag_and_drop.h index 15f4de6214044b0b2438c78488e6640e01ba0218..68865dfbdf7508ea622ef9230d51f2216f5c9a24 100644 --- a/arkui/ace_engine/native/drag_and_drop.h +++ b/arkui/ace_engine/native/drag_and_drop.h @@ -467,8 +467,8 @@ float OH_ArkUI_DragEvent_GetVelocity(ArkUI_DragEvent* event); * @brief Obtains the pressed status of modifier keys from a drag event. * * @param event Indicates the pointer to an ArkUI_DragEvent object. - * @param keys {@link ArkUI_ModifierKeyName} Indicates the returned combination of modifier keys that are currently pressed. - * The application can determine the pressed modifier keys through bitwise operations. + * @param keys {@link ArkUI_ModifierKeyName} Indicates the returned combination of modifier keys that are + * currently pressed. The application can determine the pressed modifier keys through bitwise operations. * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. @@ -499,7 +499,6 @@ ArkUI_ErrorCode OH_ArkUI_DragEvent_GetDisplayId(ArkUI_DragEvent *event, int32_t * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_DRAG_DATA_SYNC_FAILED} if the data sync is not allowed or failed. * @since 15 */ int32_t OH_ArkUI_DragEvent_StartDataLoading( @@ -968,7 +967,6 @@ int32_t OH_ArkUI_NotifyDragEndPendingDone(int32_t requestIdentify); * to pass a character array for receiving the string and explicitly specify the array length. It is * recommended that the array length be no less than 128 characters. If the length cannot accommodate * the actual bundle name length, the ERROR result will be returned. - * * @param event Indicates the pointer to an ArkUI_DragEvent object. * @param bundleName A string array used to receive the source application's bundle name. * @param length Use this to explicitly specify the length of the incoming string array. diff --git a/arkui/ace_engine/native/libace.ndk.json b/arkui/ace_engine/native/libace.ndk.json index 4a896d6404f7eddd28bb31e6377d17f8828491a0..7f0ead52df6f3949759a07f02af917103dbef2b3 100644 --- a/arkui/ace_engine/native/libace.ndk.json +++ b/arkui/ace_engine/native/libace.ndk.json @@ -121,115 +121,111 @@ }, { "first_introduced": "12", - "name": "OH_NativeXComponent_RegisterUIInputEventCallback" + "name": "OH_ArkUI_GetNodeHandleFromNapiValue" }, { "first_introduced": "12", - "name": "OH_ArkUI_UIInputEvent_GetType" + "name": "OH_ArkUI_QueryModuleInterface" }, { "first_introduced": "12", - "name": "OH_ArkUI_UIInputEvent_GetEventTime" + "name": "OH_ArkUI_GestureEvent_GetActionType" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetX" + "name": "OH_ArkUI_GestureEvent_GetRawInputEvent" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetY" + "name": "OH_ArkUI_LongPress_GetRepeatCount" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetWindowX" + "name": "OH_ArkUI_PanGesture_GetVelocity" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetWindowY" + "name": "OH_ArkUI_PanGesture_GetVelocityY" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetDisplayX" + "name": "OH_ArkUI_PanGesture_GetVelocityX" }, { "first_introduced": "12", - "name": "OH_ArkUI_PointerEvent_GetDisplayY" + "name": "OH_ArkUI_PanGesture_GetOffsetX" }, { "first_introduced": "12", - "name": "OH_ArkUI_AxisEvent_GetVerticalAxisValue" + "name": "OH_ArkUI_PanGesture_GetOffsetY" }, { "first_introduced": "12", - "name": "OH_ArkUI_AxisEvent_GetHorizontalAxisValue" + "name": "OH_ArkUI_SwipeGesture_GetAngle" }, { "first_introduced": "12", - "name": "OH_ArkUI_AxisEvent_GetPinchAxisScaleValue" - }, - { - "first_introduced": "15", - "name": "OH_ArkUI_AxisEvent_GetAxisAction" + "name": "OH_ArkUI_SwipeGesture_GetVelocity" }, { "first_introduced": "12", - "name": "OH_ArkUI_GetNodeHandleFromNapiValue" + "name": "OH_ArkUI_RotationGesture_GetAngle" }, { "first_introduced": "12", - "name": "OH_ArkUI_GestureEvent_GetActionType" + "name": "OH_ArkUI_PinchGesture_GetScale" }, { "first_introduced": "12", - "name": "OH_ArkUI_GestureEvent_GetRawInputEvent" + "name": "OH_ArkUI_PinchGesture_GetCenterX" }, { "first_introduced": "12", - "name": "OH_ArkUI_LongPress_GetRepeatCount" + "name": "OH_ArkUI_PinchGesture_GetCenterY" }, { "first_introduced": "12", - "name": "OH_ArkUI_PanGesture_GetVelocity" + "name": "OH_NativeXComponent_RegisterSurfaceShowCallback" }, { "first_introduced": "12", - "name": "OH_ArkUI_PanGesture_GetVelocityY" + "name": "OH_NativeXComponent_RegisterSurfaceHideCallback" }, { "first_introduced": "12", - "name": "OH_ArkUI_PanGesture_GetVelocityX" + "name": "OH_NativeXComponent_RegisterUIInputEventCallback" }, { "first_introduced": "12", - "name": "OH_ArkUI_PanGesture_GetOffsetX" + "name": "OH_ArkUI_UIInputEvent_GetType" }, { "first_introduced": "12", - "name": "OH_ArkUI_PanGesture_GetOffsetY" + "name": "OH_ArkUI_UIInputEvent_GetEventTime" }, { "first_introduced": "12", - "name": "OH_ArkUI_SwipeGesture_GetAngle" + "name": "OH_ArkUI_PointerEvent_GetX" }, { "first_introduced": "12", - "name": "OH_ArkUI_SwipeGesture_GetVelocity" + "name": "OH_ArkUI_PointerEvent_GetY" }, { "first_introduced": "12", - "name": "OH_ArkUI_RotationGesture_GetAngle" + "name": "OH_ArkUI_PointerEvent_GetWindowX" }, { "first_introduced": "12", - "name": "OH_ArkUI_PinchGesture_GetScale" + "name": "OH_ArkUI_PointerEvent_GetWindowY" }, { "first_introduced": "12", - "name": "OH_ArkUI_PinchGesture_GetCenterX" + "name": "OH_ArkUI_PointerEvent_GetDisplayX" }, { "first_introduced": "12", - "name": "OH_ArkUI_PinchGesture_GetCenterY" + "name": "OH_ArkUI_PointerEvent_GetDisplayY" }, { "first_introduced": "12", @@ -333,15 +329,19 @@ }, { "first_introduced": "12", - "name": "OH_NativeXComponent_SetNeedSoftKeyboard" + "name": "OH_ArkUI_AxisEvent_GetVerticalAxisValue" }, { "first_introduced": "12", - "name": "OH_NativeXComponent_RegisterSurfaceShowCallback" + "name": "OH_ArkUI_AxisEvent_GetHorizontalAxisValue" }, { "first_introduced": "12", - "name": "OH_NativeXComponent_RegisterSurfaceHideCallback" + "name": "OH_ArkUI_AxisEvent_GetPinchAxisScaleValue" + }, + { + "first_introduced": "15", + "name": "OH_ArkUI_AxisEvent_GetAxisAction" }, { "first_introduced": "12", @@ -349,7 +349,7 @@ }, { "first_introduced": "12", - "name": "OH_ArkUI_QueryModuleInterface" + "name": "OH_NativeXComponent_SetNeedSoftKeyboard" }, { "first_introduced": "12", @@ -763,7 +763,7 @@ "first_introduced": "12", "name": "OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData" }, - { + { "first_introduced": "12", "name": "OH_ArkUI_AnimateOption_Create" }, @@ -835,6 +835,10 @@ "first_introduced": "12", "name": "OH_ArkUI_PointerEvent_SetInterceptHitTestMode" }, + { + "first_introduced": "12", + "name": "OH_NativeXComponent_GetNativeXComponent" + }, { "first_introduced": "12", "name": "OH_ArkUI_NodeContent_AddNode" @@ -871,10 +875,6 @@ "first_introduced": "12", "name": "OH_ArkUI_GetNodeContentFromNapiValue" }, - { - "first_introduced": "12", - "name": "OH_NativeXComponent_GetNativeXComponent" - }, { "first_introduced": "12", "name": "OH_ArkUI_MouseEvent_GetMouseButton" @@ -1559,10 +1559,6 @@ "first_introduced": "18", "name": "OH_ArkUI_NodeUtils_MoveTo" }, - { - "first_introduced": "21", - "name": "OH_ArkUI_NativeModule_InvalidateAttributes" - }, { "first_introduced": "15", "name": "OH_ArkUI_NodeUtils_SetCrossLanguageOption" @@ -1803,6 +1799,18 @@ "first_introduced": "12", "name": "OH_ArkUI_AccessibilityValue_GetText" }, + { + "first_introduced": "12", + "name": "OH_ArkUI_NodeEvent_GetNumberValue" + }, + { + "first_introduced": "12", + "name": "OH_ArkUI_NodeEvent_GetStringValue" + }, + { + "first_introduced": "12", + "name": "OH_ArkUI_NodeEvent_SetReturnNumberValue" + }, { "first_introduced": "12", "name": "OH_ArkUI_AnimateOption_SetICurve" @@ -2047,18 +2055,6 @@ "first_introduced": "12", "name": "OH_ArkUI_Curve_DisposeCurve" }, - { - "first_introduced": "12", - "name": "OH_ArkUI_NodeEvent_GetNumberValue" - }, - { - "first_introduced": "12", - "name": "OH_ArkUI_NodeEvent_GetStringValue" - }, - { - "first_introduced": "12", - "name": "OH_ArkUI_NodeEvent_SetReturnNumberValue" - }, { "first_introduced": "12", "name": "OH_ArkUI_CreateOpacityTransitionEffect" @@ -2391,18 +2387,6 @@ "first_introduced": "12", "name": "OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale" }, - { - "first_introduced": "12", - "name": "OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss" - }, - { - "first_introduced": "12", - "name": "OH_ArkUI_DialogDismissEvent_GetUserData" - }, - { - "first_introduced": "12", - "name": "OH_ArkUI_DialogDismissEvent_GetDismissReason" - }, { "first_introduced": "12", "name": "OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo" @@ -2467,6 +2451,18 @@ "first_introduced": "12", "name": "OH_ArkUI_CustomSpanDrawInfo_GetBaseline" }, + { + "first_introduced": "12", + "name": "OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss" + }, + { + "first_introduced": "12", + "name": "OH_ArkUI_DialogDismissEvent_GetUserData" + }, + { + "first_introduced": "12", + "name": "OH_ArkUI_DialogDismissEvent_GetDismissReason" + }, { "first_introduced": "13", "name": "OH_ArkUI_AccessibilityProviderRegisterCallback" @@ -2763,10 +2759,46 @@ "first_introduced": "15", "name": "OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance" }, + { + "first_introduced": "15", + "name": "OH_ArkUI_KeyEvent_Dispatch" + }, + { + "first_introduced": "18", + "name": "OH_ArkUI_PostFrameCallback" + }, + { + "first_introduced": "15", + "name": "OH_ArkUI_NodeEvent_GetTextChangeEvent" + }, { "first_introduced": "15", "name": "OH_ArkUI_PointerEvent_GetChangedPointerId" }, + { + "first_introduced": "19", + "name": "OH_ArkUI_DragEvent_RequestDragEndPending" + }, + { + "first_introduced": "19", + "name": "OH_ArkUI_NotifyDragResult" + }, + { + "first_introduced": "19", + "name": "OH_ArkUI_NotifyDragEndPendingDone" + }, + { + "first_introduced": "20", + "name": "OH_ArkUI_EnableDropDisallowedBadge" + }, + { + "first_introduced": "20", + "name": "OH_ArkUI_DragEvent_SetDataLoadParams" + }, + { + "first_introduced": "20", + "name": "OH_ArkUI_DragAction_SetDataLoadParams" + }, { "first_introduced": "18", "name": "OH_ArkUI_GetGestureParam_FingerCount" @@ -2805,111 +2837,87 @@ }, { "first_introduced": "15", - "name": "OH_ArkUI_KeyEvent_Dispatch" - }, - { - "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_Create" - }, - { - "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_Destroy" - }, - { - "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_SetScanEffectEnabled" - }, - { - "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled" + "name": "OH_ArkUI_RegisterLayoutCallbackOnNodeHandle" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_SetStrokeWidth" + "name": "OH_ArkUI_RegisterDrawCallbackOnNodeHandle" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_SetStrokeRadius" + "name": "OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_GetScanEffectEnabled" + "name": "OH_ArkUI_UnregisterDrawCallbackOnNodeHandle" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_GetSmoothEffectEnabled" + "name": "OH_ArkUI_FocusRequest" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_GetStrokeWidth" + "name": "OH_ArkUI_FocusClear" }, { "first_introduced": "15", - "name": "OH_ArkUI_ProgressLinearStyleOption_GetStrokeRadius" + "name": "OH_ArkUI_FocusActivate" }, { "first_introduced": "15", - "name": "OH_ArkUI_NodeEvent_GetTextChangeEvent" - }, - { - "first_introduced": "18", - "name": "OH_ArkUI_PostFrameCallback" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_PostIdleCallback" + "name": "OH_ArkUI_FocusSetAutoTransfer" }, { "first_introduced": "15", - "name": "OH_ArkUI_HostWindowInfo_GetName" + "name": "OH_ArkUI_ProgressLinearStyleOption_Create" }, { "first_introduced": "15", - "name": "OH_ArkUI_HostWindowInfo_Destroy" + "name": "OH_ArkUI_ProgressLinearStyleOption_Destroy" }, { "first_introduced": "15", - "name": "OH_ArkUI_RegisterLayoutCallbackOnNodeHandle" + "name": "OH_ArkUI_ProgressLinearStyleOption_SetScanEffectEnabled" }, { "first_introduced": "15", - "name": "OH_ArkUI_RegisterDrawCallbackOnNodeHandle" + "name": "OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled" }, { "first_introduced": "15", - "name": "OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle" + "name": "OH_ArkUI_ProgressLinearStyleOption_SetStrokeWidth" }, { "first_introduced": "15", - "name": "OH_ArkUI_UnregisterDrawCallbackOnNodeHandle" + "name": "OH_ArkUI_ProgressLinearStyleOption_SetStrokeRadius" }, { "first_introduced": "15", - "name": "OH_ArkUI_DragEvent_StartDataLoading" + "name": "OH_ArkUI_ProgressLinearStyleOption_GetScanEffectEnabled" }, { "first_introduced": "15", - "name": "OH_ArkUI_CancelDataLoading" + "name": "OH_ArkUI_ProgressLinearStyleOption_GetSmoothEffectEnabled" }, { "first_introduced": "15", - "name": "OH_ArkUI_DisableDropDataPrefetchOnNode" + "name": "OH_ArkUI_ProgressLinearStyleOption_GetStrokeWidth" }, { "first_introduced": "15", - "name": "OH_ArkUI_FocusRequest" + "name": "OH_ArkUI_ProgressLinearStyleOption_GetStrokeRadius" }, { - "first_introduced": "15", - "name": "OH_ArkUI_FocusClear" + "first_introduced": "20", + "name": "OH_ArkUI_PostIdleCallback" }, { "first_introduced": "15", - "name": "OH_ArkUI_FocusActivate" + "name": "OH_ArkUI_HostWindowInfo_GetName" }, { "first_introduced": "15", - "name": "OH_ArkUI_FocusSetAutoTransfer" + "name": "OH_ArkUI_HostWindowInfo_Destroy" }, { "first_introduced": "15", @@ -2947,6 +2955,14 @@ "first_introduced": "15", "name": "OH_ArkUI_UIInputEvent_GetTargetDisplayId" }, + { + "first_introduced": "18", + "name": "OH_ArkUI_GestureInterrupter_GetUserData" + }, + { + "first_introduced": "15", + "name": "OH_ArkUI_FocusSetKeyProcessingMode" + }, { "first_introduced": "18", "name": "OH_ArkUI_XComponent_StartImageAnalyzer" @@ -2963,6 +2979,14 @@ "first_introduced": "19", "name": "OH_ArkUI_KeyframeAnimateOption_GetExpectedFrameRate" }, + { + "first_introduced": "15", + "name": "OH_ArkUI_DragEvent_StartDataLoading" + }, + { + "first_introduced": "15", + "name": "OH_ArkUI_CancelDataLoading" + }, { "first_introduced": "17", "name": "OH_ArkUI_VisibleAreaEventOptions_Create" @@ -2988,112 +3012,84 @@ "name": "OH_ArkUI_VisibleAreaEventOptions_GetExpectedUpdateInterval" }, { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetWidth" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetHeight" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetPositionX" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetPositionY" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionX" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionY" - }, - { - "first_introduced": "17", - "name": "OH_ArkUI_HoverEvent_IsHovered" + "first_introduced": "15", + "name": "OH_ArkUI_DisableDropDataPrefetchOnNode" }, { - "first_introduced": "17", - "name": "OH_ArkUI_UIInputEvent_GetModifierKeyStates" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_CreateClonedEvent" }, { - "first_introduced": "17", - "name": "OH_ArkUI_AxisEvent_SetPropagation" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_DestroyClonedEvent" }, { - "first_introduced": "17", - "name": "OH_ArkUI_AxisEvent_GetScrollStep" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_SetClonedEventLocalPosition" }, { - "first_introduced": "19", - "name": "OH_ArkUI_DragEvent_RequestDragEndPending" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex" }, { - "first_introduced": "19", - "name": "OH_ArkUI_NotifyDragResult" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_SetClonedEventActionType" }, { - "first_introduced": "19", - "name": "OH_ArkUI_NotifyDragEndPendingDone" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId" }, { - "first_introduced": "20", - "name": "OH_ArkUI_EnableDropDisallowedBadge" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex" }, { - "first_introduced": "20", - "name": "OH_ArkUI_DragEvent_SetDataLoadParams" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_DragAction_SetDataLoadParams" + "first_introduced": "15", + "name": "OH_ArkUI_PointerEvent_PostClonedEvent" }, { - "first_introduced": "18", - "name": "OH_ArkUI_GestureInterrupter_GetUserData" + "first_introduced": "15", + "name": "OH_ArkUI_NodeUtils_GetPositionToParent" }, { - "first_introduced": "15", - "name": "OH_ArkUI_FocusSetKeyProcessingMode" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetWidth" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_CreateClonedEvent" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetHeight" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_DestroyClonedEvent" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetPositionX" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_SetClonedEventLocalPosition" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetPositionY" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionX" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_SetClonedEventActionType" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionY" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId" + "first_introduced": "17", + "name": "OH_ArkUI_HoverEvent_IsHovered" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex" + "first_introduced": "17", + "name": "OH_ArkUI_UIInputEvent_GetModifierKeyStates" }, { - "first_introduced": "15", - "name": "OH_ArkUI_PointerEvent_PostClonedEvent" + "first_introduced": "17", + "name": "OH_ArkUI_AxisEvent_SetPropagation" }, { - "first_introduced": "15", - "name": "OH_ArkUI_NodeUtils_GetPositionToParent" + "first_introduced": "17", + "name": "OH_ArkUI_AxisEvent_GetScrollStep" }, { "first_introduced": "19", @@ -3327,6 +3323,14 @@ "first_introduced": "19", "name": "OH_ArkUI_XComponent_IsInitialized" }, + { + "first_introduced": "19", + "name": "OH_ArkUI_PanGesture_SetDistanceMap" + }, + { + "first_introduced": "19", + "name": "OH_ArkUI_PanGesture_GetDistanceByToolType" + }, { "first_introduced": "19", "name": "OH_ArkUI_KeyEvent_IsNumLockOn" @@ -3340,12 +3344,12 @@ "name": "OH_ArkUI_KeyEvent_IsScrollLockOn" }, { - "first_introduced": "19", - "name": "OH_ArkUI_PanGesture_SetDistanceMap" + "first_introduced": "20", + "name": "OH_ArkUI_AddSupportedUIStates" }, { - "first_introduced": "19", - "name": "OH_ArkUI_PanGesture_GetDistanceByToolType" + "first_introduced": "20", + "name": "OH_ArkUI_RemoveSupportedUIStates" }, { "first_introduced": "20", @@ -3369,19 +3373,19 @@ }, { "first_introduced": "20", - "name": "OH_ArkUI_AddSupportedUIStates" + "name": "OH_ArkUI_DragEvent_GetDragSource" }, { "first_introduced": "20", - "name": "OH_ArkUI_RemoveSupportedUIStates" + "name": "OH_ArkUI_DragEvent_IsRemote" }, { "first_introduced": "20", - "name": "OH_ArkUI_DragEvent_GetDragSource" + "name": "OH_ArkUI_PreventGestureRecognizerBegin" }, { "first_introduced": "20", - "name": "OH_ArkUI_DragEvent_IsRemote" + "name": "OH_ArkUI_SetTouchTestDoneCallback" }, { "first_introduced": "20", @@ -3431,6 +3435,14 @@ "first_introduced": "20", "name": "OH_ArkUI_AccessibilityProvider_Dispose" }, + { + "first_introduced": "20", + "name": "OH_ArkUI_InitModuleForArkTSEnv" + }, + { + "first_introduced": "20", + "name": "OH_ArkUI_NotifyArkTSEnvDestroy" + }, { "first_introduced": "20", "name": "OH_ArkUI_SurfaceCallback_SetSurfaceShowEvent" @@ -3471,14 +3483,6 @@ "first_introduced": "20", "name": "OH_ArkUI_NodeUtils_GetLayoutPositionInGlobalDisplay" }, - { - "first_introduced": "20", - "name": "OH_ArkUI_InitModuleForArkTSEnv" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_NotifyArkTSEnvDestroy" - }, { "first_introduced": "20", "name": "OH_ArkUI_SurfaceCallback_SetSurfaceHideEvent" @@ -3495,14 +3499,6 @@ "first_introduced": "20", "name": "OH_ArkUI_NodeUtils_GetNodeUniqueId" }, - { - "first_introduced": "20", - "name": "OH_ArkUI_PreventGestureRecognizerBegin" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_SetTouchTestDoneCallback" - }, { "first_introduced": "20", "name": "OH_ArkUI_SetForceDarkConfig" @@ -4054,17 +4050,5 @@ { "first_introduced": "20", "name": "OH_ArkUI_RenderNodeUtils_DisposeRenderNodeClipOption" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_PostAsyncUITask" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_PostUITask" - }, - { - "first_introduced": "20", - "name": "OH_ArkUI_PostUITaskAndWait" } ] \ No newline at end of file diff --git a/arkui/ace_engine/native/native_dialog.h b/arkui/ace_engine/native/native_dialog.h index a59f1afcb526077fab851017e77ac29abe4d2e8d..5bdde7f9d1eb5b35d572b87e21c62971d6b8d7cb 100644 --- a/arkui/ace_engine/native/native_dialog.h +++ b/arkui/ace_engine/native/native_dialog.h @@ -983,8 +983,7 @@ int32_t OH_ArkUI_CustomDialog_SetShadow(ArkUI_CustomDialogOptions* options, ArkU * @brief Sets the custom shadow of the dialog box background. * * @param options Dialog box parameters. - * @param customShadow Custom shadow parameter. The format is the same as that of - * the NODE_CUSTOM_SHADOW property. + * @param customShadow Custom shadow parameter. The format is the same as that of the NODE_SHADOW property. * @return Returns the error code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. diff --git a/arkui/ace_engine/native/native_interface.h b/arkui/ace_engine/native/native_interface.h index 4c3405779511912c2b8b668c24e7ba5990028b62..64cae7e06ea74db39542281356b42f0bcb425b82 100644 --- a/arkui/ace_engine/native/native_interface.h +++ b/arkui/ace_engine/native/native_interface.h @@ -57,12 +57,6 @@ typedef enum { ARKUI_NATIVE_GESTURE, /** API related to animations. For details, see the struct definition in .*/ ARKUI_NATIVE_ANIMATE, - /** - * API related to supported multi thread UI components. - * For details, see the struct definition in . - * @since 20 - */ - ARKUI_MULTI_THREAD_NATIVE_NODE, } ArkUI_NativeAPIVariantKind; /** diff --git a/arkui/ace_engine/native/native_node.h b/arkui/ace_engine/native/native_node.h index ce5b57eb466694a3560506fa7a0111385ae2d37f..abfddcf6fbbe7e7e112235bdd03e324352b41e10 100644 --- a/arkui/ace_engine/native/native_node.h +++ b/arkui/ace_engine/native/native_node.h @@ -1807,8 +1807,8 @@ typedef enum { * */ NODE_VISIBLE_AREA_CHANGE_RATIO = 93, - - /** + + /** * @brief Sets the transition effect when the component is inserted or deleted. * This attribute can be set, and obtained as required through APIs. * @@ -1981,7 +1981,8 @@ typedef enum { NODE_TRANSLATE_WITH_PERCENT = 103, /** - * @brief Sets component rotation with multi-axis angle control. This attribute can be set, reset, and obtained as required through APIs. + * @brief Sets component rotation with multi-axis angle control. This attribute can be set, reset, + * and obtained as required through APIs. * * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n * .value[0].f32: x-axis rotation angle. The default value is 0. \n @@ -2445,7 +2446,8 @@ typedef enum { NODE_TEXT_LINEAR_GRADIENT = 1033, /** - * @brief Sets a radial gradient effect for text. This attribute can be set, reset, and obtained as required through APIs. + * @brief Sets a radial gradient effect for text. + * This attribute can be set, reset, and obtained as required through APIs. * * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n * .value[0]?.f32: X-coordinate of the radial gradient center relative to the upper left corner of the text. \n @@ -2761,114 +2763,6 @@ typedef enum { * @since 20 */ NODE_IMAGE_SYNC_LOAD = 4012, - /** - * @brief Defines the image decoding size attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: width of the image decoding, in px.\n - * .value[1].i32: height of the image decoding, in px.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: width of the image decoding, in px.\n - * .value[1].i32: height of the image decoding, in px.\n - * - * @since 21 - */ - NODE_IMAGE_SOURCE_SIZE = 4013, - /** - * @brief Defines the display tranformation matrix for an image. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0...15].f32: 16 floating-point numbers.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0...15].f32: 16 floating-point numbers.\n - * - * @since 21 - */ - NODE_IMAGE_IMAGE_MATRIX = 4014, - /** - * @brief Defines the image follow text direction attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: whether to follows the text direction.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: whether to follows the text direction.\n - * - * @since 21 - */ - NODE_IMAGE_MATCH_TEXT_DIRECTION = 4015, - /** - * @brief Defines the image copy attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: copy option {@link ArkUI_CopyOptions}. The default value is ARKUI_COPY_OPTIONS_NONE.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: copy option {@link ArkUI_CopyOptions.\n - * - * @since 21 - */ - NODE_IMAGE_COPY_OPTION = 4016, - /** - * @brief Defines the image AI analysis enable attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: whether to enable AI analysis for the image.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: whether to enable AI analysis for the image.\n - * - * @since 21 - */ - NODE_IMAGE_ENABLE_ANALYZER = 4017, - /** - * @brief Defines the image dynamic display range attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: dynamic range mode {@link ArkUI_DynamicRangeMode}. - * The default value is ARKUI_DYNAMIC_RANGE_MODE_STANDARD.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: dynamic range mode {@link ArkUI_DynamicRangeMode.\n - * - * @since 21 - */ - NODE_IMAGE_DYNAMIC_RANGE_MODE = 4018, - /** - * @brief Defines the image dynamic display brightness attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].f32: hdr brightness. value range [0, 1]\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].f32: hdr brightness. value range [0, 1]\n - * - * @since 21 - */ - NODE_IMAGE_HDR_BRIGHTNESS = 4019, - /** - * @brief Defines the image display direction attribute. - * This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: orientation {@link ArkUI_Orientation}. - * The default value is ARKUI_ORIENTATION_UP.\n - * \n - * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: orientation {@link ArkUI_Orientation.\n - * - * @since 21 - */ - NODE_IMAGE_ORIENTATION = 4020, /** * @brief Defines the color of the component when it is selected. * This attribute can be set, reset, and obtained as required through APIs. @@ -3379,6 +3273,7 @@ typedef enum { * @since 15 */ NODE_TEXT_INPUT_LETTER_SPACING = 7032, + /** * @brief Sets whether to enable preview text for the TextInput component. * This attribute can be set, reset, and obtained as required through APIs. @@ -3430,17 +3325,17 @@ typedef enum { * * @since 20 */ - NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION = 7036, - + NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION = 7036, + /** * @brief Set the line height of the input node. * This attribute can be set, reset, and obtained as required through APIs. * * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: line height value. \n + * .value[0].i32: line height value. * \n * Format of the return value {@link ArkUI_AttributeItem}: \n - * .value[0].i32: line height value. \n + * .value[0].i32: line height value * * @since 20 */ @@ -3729,6 +3624,7 @@ typedef enum { * */ NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS, + /** * @brief When this property is set, the height of the textArea component is calculated using this property. * @@ -3795,13 +3691,13 @@ typedef enum { NODE_TEXT_AREA_KEYBOARD_APPEARANCE = 8026, /** - * @brief Set the max lines of the node. This attrilbute can be set, reset, and obtained as required through APIs. + * @brief Set the max lines of the node. This attribute can be set, reset, and obtained as required through APIs. * * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: max lines count. \n + * .value[0].i32: max lines count. * \n * Format of the return value {@link ArkUI_AttributeItem}:\n - * .value[0].i32: max lines count. \n + * .value[0].i32: max lines count.\n * * @since 20 */ @@ -3820,19 +3716,19 @@ typedef enum { */ NODE_TEXT_AREA_LINE_SPACING = 8028, - /** - * @brief Set the min lines of the node. This attribute can be set, reset, and obtained as required through APIs. - * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: min lines count. - * \n - * Format of the return value {@link ArkUI_AttributeItem}: \n - * .value[0].i32: min line count.\n - * - * @since 20 - * - */ - NODE_TEXT_AREA_MIN_LINES = 8029, + /** + * @brief Set the min lines of the node. This attribute can be set, reset, and obtained as required through APIs. + * + * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n + * .value[0].i32: min lines count. + * \n + * Format of the return value {@link ArkUI_AttributeItem}: \n + * .value[0].i32: min line count.\n + * + * @since 20 + * + */ + NODE_TEXT_AREA_MIN_LINES = 8029, /** * @brief Set the max lines of the node with scroll. @@ -3846,16 +3742,16 @@ typedef enum { * * @since 20 */ - NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL = 8030, + NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL = 8030, /** * @brief Set the line height of the node. This attribute can be set, reset, and obtained as required through APIs. * * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: line height value. \n + * .value[0].i32: line height value. * \n * Format of the return value {@link ArkUI_AttributeItem}: \n - * .value[0].i32: line height value. \n + * .value[0].i32: line height value * * @since 20 */ @@ -4088,25 +3984,19 @@ typedef enum { */ NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM * ARKUI_NODE_XCOMPONENT, /** - * @brief Defines the type of the component. - * This attribute can be set, reset, and obtained as required through APIs. + * @brief Specifies the type of the XComponent component. This attribute is read-only. \n + * The type of the XComponent component must be explicitly set during creation using {@link ARKUI_NODE_XCOMPONENT} or {@link ARKUI_NODE_XCOMPONENT_TEXTURE}, and cannot be modified afterward. \n + * Attempting to change the type through {@link setAttribute} will cause rendering exceptions. * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].i32: type {@link ArkUI_XComponentType}. The default value is ARKUI_XCOMPONENT_TYPE_SURFACE. \n - * \n * Format of the return value {@link ArkUI_AttributeItem}:\n * .value[0].i32: type {@link ArkUI_XComponentType}. \n * */ NODE_XCOMPONENT_TYPE, /** - * @brief Defines the width and height of the component. - * This attribute can be set and obtained as required through APIs. + * @brief Specifies the size of the XComponent component. This attribute is read-only. \n + * Attempting to modify the size through {@link setAttribute} will have no effect. * - * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n - * .value[0].u32: width, in px. \n - * .value[1].u32: height, in px. \n - * \n * Format of the return value {@link ArkUI_AttributeItem}:\n * .value[0].u32: width, in px. \n * .value[1].u32: height, in px. \n @@ -4403,7 +4293,7 @@ typedef enum { * */ NODE_TIME_PICKER_SELECTED_TEXT_STYLE, - /** + /** * @brief Defines the start time of the time picker. * This attribute can be set, reset, and obtained as required through APIs. * @@ -6977,7 +6867,8 @@ typedef enum { /** * @brief Defines the gesture event type. * - * When the event callback occurs, the union type in the {@link ArkUI_NodeEvent} object is {@link ArkUI_UIInputEvent}. + * When the event callback occurs, the union type in the {@link ArkUI_NodeEvent} object is + * {@link ArkUI_UIInputEvent}. */ NODE_TOUCH_EVENT = 0, @@ -7335,11 +7226,11 @@ typedef enum { */ NODE_TEXT_ON_DETECT_RESULT_UPDATE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT, /** - * @brief Defines the long press event for span + * @brief Defines the long press event for span. * * The event is triggered when the span is long pressed. * When the event callback occurs, the {@link ArkUI_NodeEvent} object can be obtained from the - * {@link ArkUI_UIInputEvent} object.\n + * {@link ArkUI_UIInputEvent} object. \n * @since 20 */ NODE_TEXT_SPAN_ON_LONG_PRESS = 1001, @@ -7587,7 +7478,7 @@ typedef enum { NODE_TEXT_INPUT_ON_CHANGE_WITH_PREVIEW_TEXT = 7013, /** - * @brief Defines the event triggered before content changes. + * @brief Defines the event triggered before content changes * * When the event callback occurs, the union type {@link ArkUI_NodeEvent} is {@link ArkUI_TextChangeEvent}. \n * {@link ArkUI_TextChangeEvent} contains the following parameters: \n @@ -7766,7 +7657,7 @@ typedef enum { NODE_TEXT_AREA_ON_CHANGE_WITH_PREVIEW_TEXT = 8012, /** - * @brief Defines the event triggered before content changes + * @brief Defines the event triggered before content changes. * * When the event callback occurs, the union type {@link ArkUI_NodeEvent} is {@link ArkUI_TextChangeEvent}. \n * {@link ArkUI_TextChangeEvent} contains the following parameters: \n @@ -8008,6 +7899,22 @@ typedef enum { */ NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL, + /** + * @brief Defines the event triggered when content in the swiper component will scroll. + * Instructions: Before page scrolling, the ContentWillScrollCallback callback is invoked. \n \n + * When the event callback occurs, the union type in the {@link ArkUI_NodeEvent} object is + * {@link ArkUI_NodeComponentEvent}. \n + * {@link ArkUI_NodeComponentEvent} contains three parameters:\n + * ArkUI_NodeComponentEvent.data[0].i32: the index value of the current child page. \n + * ArkUI_NodeComponentEvent.data[1].i32: the index value of the child page that will display. \n + * ArkUI_NodeComponentEvent.data[2].f32: the sliding offset of each frame. + * Positive numbers indicating slide backward(e.g. from index=1 to index=0), negative numbers indicating + * slide forward(e.g. from index=0 to index=1). \n + * + * @since 15 + */ + NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL = 1001007, + /** * @brief Defines the event triggered when the selected index of the ARKUI_NODE_SWIPER changed. * @@ -8042,22 +7949,6 @@ typedef enum { */ NODE_SWIPER_EVENT_ON_UNSELECTED = 1001006, - /** - * @brief Defines the event triggered when content in the swiper component will scroll. - * Instructions: Before page scrolling, the ContentWillScrollCallback callback is invoked. \n \n - * When the event callback occurs, the union type in the {@link ArkUI_NodeEvent} object is - * {@link ArkUI_NodeComponentEvent}. \n - * {@link ArkUI_NodeComponentEvent} contains three parameters:\n - * ArkUI_NodeComponentEvent.data[0].i32: the index value of the current child page. \n - * ArkUI_NodeComponentEvent.data[1].i32: the index value of the child page that will display. \n - * ArkUI_NodeComponentEvent.data[2].f32: the sliding offset of each frame. - * Positive numbers indicating slide backward(e.g. from index=1 to index=0), negative numbers indicating - * slide forward(e.g. from index=0 to index=1). \n - * - * @since 15 - */ - NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL = 1001007, - /** * @brief Defines the ARKUI_NODE_SWIPER scroll state change event. * This event is triggered when the scroll state of the Swiper component changes during user dragging, @@ -9866,18 +9757,6 @@ float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale(const ArkUI_SystemFontStyle */ float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale(const ArkUI_SystemFontStyleEvent* event); -/** - * @brief Get the node handle by id. - * - * @param id The id of the target node handle. - * @param node The handle of target node handle. - * @return Error code. - * {@link ARKUI_ERROR_CODE_NO_ERROR} success. - * {@link ARKUI_ERROR_CODE_PARAM_INVALID} Function parameter exception. - * @since 15 - */ -int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeHandle* node); - /** * @brief Move the node handle to target parent node as child. * @@ -9893,21 +9772,6 @@ int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeH */ int32_t OH_ArkUI_NodeUtils_MoveTo(ArkUI_NodeHandle node, ArkUI_NodeHandle target_parent, int32_t index); -/** - * @brief Triggers node updates in the current frame. - * When node attributes are modified after the current frame's build phase (i.e., after - * the unified processing of dirty nodes), the node updates will be deferred to the next - * frame. This function forces immediate node updates within the current frame to - * ensure rendering effects are applied synchronously. - * - * @param node ArkUI_NodeHandle pointer. - * @return Error code. - * {@link ARKUI_ERROR_CODE_NO_ERROR} Success. - * {@link ARKUI_ERROR_CODE_PARAM_INVALID} Function parameter exception. - * @since 21 - */ -int32_t OH_ArkUI_NativeModule_InvalidateAttributes(ArkUI_NodeHandle node); - /** * @brief Set the cross-language option of the target node handle. * @@ -9946,7 +9810,6 @@ int32_t OH_ArkUI_NodeUtils_GetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_C int32_t OH_ArkUI_RegisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node, void* userData, void (*onLayoutCompleted)(void* userData)); - /** * @brief Registers a callback for node when draw is completed. * @@ -9983,6 +9846,18 @@ int32_t OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node); */ int32_t OH_ArkUI_UnregisterDrawCallbackOnNodeHandle(ArkUI_NodeHandle node); +/** + * @brief Get the node handle by id. + * + * @param id The id of the target node handle. + * @param node The handle of target node handle. + * @return Error code. + * {@link ARKUI_ERROR_CODE_NO_ERROR} success. + * {@link ARKUI_ERROR_CODE_PARAM_INVALID} Function parameter exception. + * @since 15 + */ +int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeHandle* node); + /** * @brief Get the snapshot pixelmap for the given node synchronously, will get error if the node is not on the * tree or is not rendered yet. @@ -10063,7 +9938,7 @@ ArkUI_ErrorCode OH_ArkUI_RemoveSupportedUIStates(ArkUI_NodeHandle node, int32_t /** * @brief Run a custom function inside the UIContext scope. * - * @param uiContext Indicates the pointer to a UI instance. + * @param uiContext ArkUI_ContextHandle. * @param userData Indicates the pointer to the custom data. * @param callback The custom function. * @return Returns the result code. @@ -10119,46 +9994,6 @@ int32_t OH_ArkUI_NodeUtils_GetNodeUniqueId(ArkUI_NodeHandle node, int32_t* uniqu int32_t OH_ArkUI_SetForceDarkConfig(ArkUI_ContextHandle uiContext, bool forceDark, ArkUI_NodeType nodeType, uint32_t (*colorInvertFunc)(uint32_t color)); -/** - * @brief Post UI task to background threads. - * - * @param context UIContext pointer of the page where the UI task located. - * @param asyncUITaskData Parameter of asyncUITask and onFinish. - * @param asyncUITask Function executed by a background thread. - * @param onFinish Function executed by UI thread after async UI task is executed. - * @return Returns the result code. - * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. - * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if context or asyncUITask is nullptr. - * @since 20 - */ -int32_t OH_ArkUI_PostAsyncUITask(ArkUI_ContextHandle context, void* asyncUITaskData, - void (*asyncUITask)(void* asyncUITaskData), void (*onFinish)(void* asyncUITaskData)); - -/** - * @brief Post UI task to UI thread. - * - * @param context UIContext pointer of the page where the UI task located. - * @param taskData Parameter of task. - * @param task Function executed by UI thread. - * @return Returns the result code. - * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. - * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if context or task is nullptr. - * @since 20 - */ -int32_t OH_ArkUI_PostUITask(ArkUI_ContextHandle context, void* taskData, void (*task)(void* taskData)); - -/** - * @brief Post UI task to UI thread and wait until UI task finished. - * - * @param context UIContext pointer of the page where the UI task located. - * @param taskData Parameter of task. - * @param task Function executed by UI thread. - * @return Returns the result code. - * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. - * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if context or task is nullptr. - * @since 20 - */ -int32_t OH_ArkUI_PostUITaskAndWait(ArkUI_ContextHandle context, void* taskData, void (*task)(void* taskData)); #ifdef __cplusplus }; #endif diff --git a/arkui/ace_engine/native/native_node_napi.h b/arkui/ace_engine/native/native_node_napi.h index 44642ac10dff80359592c97aeadb20c671057903..3742bee384b15ee91346f59c336fd7554fc8ee8c 100644 --- a/arkui/ace_engine/native/native_node_napi.h +++ b/arkui/ace_engine/native/native_node_napi.h @@ -412,7 +412,7 @@ void OH_ArkUI_NotifyArkTSEnvDestroy(napi_env env); * Returns {@link ARKUI_ERROR_CODE_CALLBACK_INVALID} if the callback function is invalid. * @since 20 */ - int32_t OH_ArkUI_PostIdleCallback(ArkUI_ContextHandle uiContext, void* userData, +int32_t OH_ArkUI_PostIdleCallback(ArkUI_ContextHandle uiContext, void* userData, void (*callback)(uint64_t nanoTimeLeft, uint32_t frameCount, void* userData)); #ifdef __cplusplus diff --git a/arkui/ace_engine/native/native_type.h b/arkui/ace_engine/native/native_type.h index 7cef398b2d6b7cbab8dec555464d44799d0898fa..5898260f8d5c9c2ee6d016a75e0aa82997fa4707 100644 --- a/arkui/ace_engine/native/native_type.h +++ b/arkui/ace_engine/native/native_type.h @@ -1374,46 +1374,6 @@ typedef enum { ARKUI_IMAGE_INTERPOLATION_HIGH, } ArkUI_ImageInterpolation; -/** - * @brief Enumerates the image dynamic range mode. - * - * @since 21 - */ -typedef enum { - /** high dynamic range mode. */ - ARKUI_DYNAMIC_RANGE_MODE_HIGH = 0, - /** constraint dynamic range mode. */ - ARKUI_DYNAMIC_RANGE_MODE_CONSTRAINT, - /** standard dynamic range mode. */ - ARKUI_DYNAMIC_RANGE_MODE_STANDARD, -} ArkUI_DynamicRangeMode; - -/** - * @brief Enumerates the image rotate orientation. - * - * @since 21 - */ -typedef enum { - /** Use EXIF metadata for display orientation, with support for rotation and mirroring. */ - ARKUI_ORIENTATION_AUTO = 0, - /** Display original pixel data without transformation. */ - ARKUI_ORIENTATION_UP, - /** Display the image after rotating it 90 degrees clockwise. */ - ARKUI_ORIENTATION_RIGHT, - /** Display the image after rotating it 180 degrees clockwise. */ - ARKUI_ORIENTATION_DOWN, - /** Display the image after rotating it 270 degrees clockwise. */ - ARKUI_ORIENTATION_LEFT, - /** Display the image after flipping it horizontally. */ - ARKUI_ORIENTATION_UP_MIRRORED, - /** Display the image after flipping it horizontally and then rotating it 90 degrees clockwise. */ - ARKUI_ORIENTATION_RIGHT_MIRRORED, - /** Display the image after flipping it vertically. */ - ARKUI_ORIENTATION_DOWN_MIRRORED, - /** Display the image after flipping it horizontally and then rotating it 270 degrees clockwise. */ - ARKUI_ORIENTATION_LEFT_MIRRORED, -} ArkUI_ImageRotateOrientation; - /** * @brief Enumerates the blend modes. * @@ -2306,11 +2266,6 @@ typedef enum { * @since 15 */ ARKUI_ERROR_CODE_NODE_NOT_ON_MAIN_TREE = 106203, - /** - * @error The node is running on invalid thread. - * @since 20 - */ - ARKUI_ERROR_CODE_NODE_ON_INVALID_THREAD = 106204, /** * @error Force dark config is invalid. * @since 20 diff --git a/arkui/ace_engine/native/ui_input_event.h b/arkui/ace_engine/native/ui_input_event.h index a13728fe50da5166a9e103e72b83ea0ff757db7d..4297f5facda10be2cb6fb91f1f2b2d60be0d41fa 100644 --- a/arkui/ace_engine/native/ui_input_event.h +++ b/arkui/ace_engine/native/ui_input_event.h @@ -36,9 +36,9 @@ #ifndef _ARKUI_UI_INPUT_EVENT_H_ #define _ARKUI_UI_INPUT_EVENT_H_ -#include "native_type.h" #include +#include "native_type.h" #ifdef __cplusplus extern "C" { #endif @@ -61,9 +61,9 @@ typedef enum { ARKUI_UIINPUTEVENT_TYPE_AXIS = 2, /** Mouse event. */ ARKUI_UIINPUTEVENT_TYPE_MOUSE = 3, - /** + /** * @brief key event. - * + * * @since 20 */ ARKUI_UIINPUTEVENT_TYPE_KEY = 4, @@ -429,7 +429,7 @@ float OH_ArkUI_PointerEvent_GetXByIndex(const ArkUI_UIInputEvent* event, uint32_ * * @param event Indicates the pointer to the UI input event. * @return Returns the Y coordinate relative to the upper left corner of the current component; - * returns 0 if any parameter error occurs. + * returns 0.0f if any parameter error occurs. * @since 12 */ float OH_ArkUI_PointerEvent_GetY(const ArkUI_UIInputEvent* event); @@ -453,7 +453,7 @@ float OH_ArkUI_PointerEvent_GetYByIndex(const ArkUI_UIInputEvent* event, uint32_ * * @param event Indicates the pointer to the UI input event. * @return Returns the X coordinate relative to the upper left corner of the current application window; - * returns 0 if any parameter error occurs. + * returns 0.0f if any parameter error occurs. * @since 12 */ float OH_ArkUI_PointerEvent_GetWindowX(const ArkUI_UIInputEvent* event); @@ -477,7 +477,7 @@ float OH_ArkUI_PointerEvent_GetWindowXByIndex(const ArkUI_UIInputEvent* event, u * * @param event Indicates the pointer to the UI input event. * @return Returns the Y coordinate relative to the upper left corner of the current application window; - * returns 0 if any parameter error occurs. + * returns 0.0f if any parameter error occurs. * @since 12 */ float OH_ArkUI_PointerEvent_GetWindowY(const ArkUI_UIInputEvent* event); @@ -501,7 +501,7 @@ float OH_ArkUI_PointerEvent_GetWindowYByIndex(const ArkUI_UIInputEvent* event, u * * @param event Indicates the pointer to the UI input event. * @return Returns the X coordinate relative to the upper left corner of the current screen; - * returns 0 if any parameter error occurs. + * returns 0.0f if any parameter error occurs. * @since 12 */ float OH_ArkUI_PointerEvent_GetDisplayX(const ArkUI_UIInputEvent* event); @@ -525,7 +525,7 @@ float OH_ArkUI_PointerEvent_GetDisplayXByIndex(const ArkUI_UIInputEvent* event, * * @param event Indicates the pointer to the UI input event. * @return Returns the Y coordinate relative to the upper left corner of the current screen; - * returns 0 if any parameter error occurs. + * returns 0.0f if any parameter error occurs. * @since 12 */ float OH_ArkUI_PointerEvent_GetDisplayY(const ArkUI_UIInputEvent* event); @@ -666,8 +666,9 @@ float OH_ArkUI_PointerEvent_GetTouchAreaHeight(const ArkUI_UIInputEvent* event, * @brief Checks whether an event is triggered by the user's left or right hand. * This API is only effective on some touch devices. * - * @note The value is not available immediately upon press. Until the system infers the result, this API will return - * NONE. Do not rely on the return value for critical functionality. + * @note This value cannot be obtained in real time when pressed. Before the + * system completes result inference, it will return NONE by default. Therefore, + * please do not over-rely on the results returned by this interface. * * @param event Pointer to the current UI input event. * @param hand Whether the touch point is from the left or right hand. @@ -682,8 +683,9 @@ int32_t OH_ArkUI_PointerEvent_GetInteractionHand(const ArkUI_UIInputEvent *event * @brief Checks whether an event is triggered by the user's left or right hand. * This API is only effective on some touch devices. * - * @note The value is not available immediately upon press. Until the system infers the result, - * this API will return NONE. Do not rely on the return value for critical functionality. + * @note This value cannot be obtained in real time when pressed. Before the + * system completes result inference, it will return NONE by default. Therefore, + * please do not over-rely on the results returned by this interface. * * @param event Pointer to the current UI input event. * @param pointerIndex Index of the target touch point in the multi-touch data list. @@ -1273,7 +1275,7 @@ int32_t OH_ArkUI_PointerEvent_CreateClonedEvent(const ArkUI_UIInputEvent* event, * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1288,7 +1290,7 @@ int32_t OH_ArkUI_PointerEvent_DestroyClonedEvent(const ArkUI_UIInputEvent* event * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1305,7 +1307,7 @@ int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPosition(const ArkUI_UIInputEve * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1320,7 +1322,7 @@ int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex( * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1334,7 +1336,7 @@ int32_t OH_ArkUI_PointerEvent_SetClonedEventActionType(const ArkUI_UIInputEvent* * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1349,7 +1351,7 @@ int32_t OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId(const ArkUI_UIInputE * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * @since 15 */ @@ -1364,7 +1366,7 @@ int32_t OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex( * @return Returns the result code. * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} if the operation is successful. * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} if a parameter error occurs. - * Returns {@link ARKUI_ERROR_CODE_NON_CLONED_POINTER_EVENT} if the input event pointer is not a + * Returns {@link ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT} if the input event pointer is not a * cloned event pointer. * Returns {@link ARKUI_ERROR_CODE_POST_CLONED_COMPONENT_STATUS_ABNORMAL} * if the component status abnormal. diff --git a/build-tools/clean_ndk_ani.py b/build-tools/clean_ndk_ani.py new file mode 100755 index 0000000000000000000000000000000000000000..f28647ffbda489e351be6ad74889f9b08668d9a9 --- /dev/null +++ b/build-tools/clean_ndk_ani.py @@ -0,0 +1,128 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# Copyright (c) 2025 Huawei Device Co., Ltd. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import os +import re +import argparse +import shutil +import json +import stat +from typing import List + +# ani header file list +_ANI_HEADER_LISTS = [ +] + +# Precompiled regular expression +_HEADER_PATTERN = re.compile( + r'^\s*#\s*include\s+["<](.*/)?({})[">]'.format( + '|'.join(map(re.escape, _ANI_HEADER_LISTS)) + ) +) + + +def process_header_file(file_path): + """processing single header file""" + modified = False + try: + with open(file_path, 'r+', encoding='utf-8') as f: + content = f.read() + # Use a regular expression to process all rows at once + new_content = [] + for line in content.splitlines(): + if not _HEADER_PATTERN.match(line): + new_content.append(line) + else: + modified = True + + if modified: + f.seek(0) + f.write('\n'.join(new_content)) + f.truncate() + except Exception as e: + print(f"process file {file_path} failed: {str(e)}") + return modified + + +def clean_ndk_ani_headers(ndk_header_path): + if not _ANI_HEADER_LISTS: + print("Warning: ani header file list") + return + + # all files to be processed + file_paths = [] + for root, _, files in os.walk(ndk_header_path): + for file in files: + if not file.endswith('.h'): + continue + + file_path = os.path.join(root, file) + if file in _ANI_HEADER_LISTS: + try: + os.remove(file_path) + print(f"Deleted ani header file: {file_path}") + except OSError as e: + print(f"Error deleting {file_path}: {str(e)}") + else: + file_paths.append(file_path) + + # Bulk processing file include + for file_path in file_paths: + process_header_file(file_path) + + +# Clear the ani header file in the systemCapability configuration json file +def clean_json_systemCapability_headers(capability_header_path): + try: + with open(capability_header_path, 'r') as f: + systemCapabilitys = json.load(f) + except Exception as e: + print(f"Error reading JSON file: {str(e)}") + return + + # Traverse all levels of items + for _systemCapability in systemCapabilitys: + # filtering ani header file + systemCapabilitys[_systemCapability] = [item for item in systemCapabilitys[_systemCapability] + if os.path.basename(item) not in _ANI_HEADER_LISTS] + + # Saving the modified JSON + try: + fd = os.open(capability_header_path, os.O_WRONLY | os.O_TRUNC | os.O_CREAT, + stat.S_IRUSR | stat.S_IWUSR) + with os.fdopen(fd, 'w') as f: + json.dump(systemCapabilitys, f, indent=2) + print("JSON file updated successfully") + except Exception as e: + print(f"Error saving JSON file: {str(e)}") + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--ndk-header-path', help='ndk header path', required=True) + parser.add_argument('--system-capability-header-config', required=True) + args = parser.parse_args() + + if not os.path.isdir(args.ndk_header_path): + print(f"Error:path {args.ndk_header_path} is not exist!") + return + + clean_ndk_ani_headers(args.ndk_header_path) + clean_json_systemCapability_headers(args.system_capability_header_config) + print("Ani Header file cleanup complete!") + + +if __name__ == '__main__': + main() diff --git a/build-tools/clean_ndk_ani.pydeps b/build-tools/clean_ndk_ani.pydeps new file mode 100644 index 0000000000000000000000000000000000000000..9ec5fde3fccfab67dd5391b753fb08513622e8a3 --- /dev/null +++ b/build-tools/clean_ndk_ani.pydeps @@ -0,0 +1,10 @@ +# Generated by running: +# build/print_python_deps.py --root build/ohos/ndk --output interface/sdk_c/build-tools/clean_ndk_ani.pydeps interface/sdk_c/build-tools/clean_ndk_ani.py +../../../build/gn_helpers.py +../../../build/scripts/__init__.py +../../../build/scripts/interface_mgr.py +../../../build/scripts/util/__init__.py +../../../build/scripts/util/build_utils.py +../../../build/scripts/util/md5_check.py +../../../build/scripts/util/pycache.py +clean_ndk_ani.py diff --git a/distributeddatamgr/relational_store/include/data_asset.h b/distributeddatamgr/relational_store/include/data_asset.h index f791cbc9e815b1358fd4bb3b4054f1576b808521..85c4fbdf6ba1a0195c34f30f2a15c36c5465c1fc 100644 --- a/distributeddatamgr/relational_store/include/data_asset.h +++ b/distributeddatamgr/relational_store/include/data_asset.h @@ -326,7 +326,9 @@ Data_Asset *OH_Data_Asset_CreateOne(void); * * @param asset Represents a pointer to an {@link Data_Asset} instance. * @return Returns the status code of the execution. Successful execution returns RDB_OK, - * while failure returns a specific error code. Specific error codes can be referenced {@link OH_Rdb_ErrCode}. + * while failure returns a specific error code. + * {@link RDB_OK} - success. + * Specific error codes can be referenced {@link OH_Rdb_ErrCode}. * @see Data_Asset, OH_Rdb_ErrCode. * @since 11 */ @@ -349,7 +351,9 @@ Data_Asset **OH_Data_Asset_CreateMultiple(uint32_t count); * @param assets Represents a pointer to an {@link Data_Asset} instance. * @param count Represents the count of {@link Data_Asset} to destroy. * @return Returns the status code of the execution. Successful execution returns RDB_OK, - * while failure returns a specific error code. Specific error codes can be referenced {@link OH_Rdb_ErrCode}. + * while failure returns a specific error code. + * {@link RDB_OK} - success. + * Specific error codes can be referenced {@link OH_Rdb_ErrCode}. * @see Data_Asset, OH_Rdb_ErrCode. * @since 11 */ diff --git a/hiviewdfx/hiappevent/include/hiappevent/hiappevent_event.h b/hiviewdfx/hiappevent/include/hiappevent/hiappevent_event.h index 83c319e6c04d7a37f80d14c221cc12c789b8ce80..06f186ed5ad34d88e25247429d918dc164c83242 100644 --- a/hiviewdfx/hiappevent/include/hiappevent/hiappevent_event.h +++ b/hiviewdfx/hiappevent/include/hiappevent/hiappevent_event.h @@ -168,14 +168,6 @@ extern "C" { */ #define EVENT_APP_KILLED "APP_KILLED" -/** - * @brief audio jank frame event. - * - * @since 21 - * @version 1.0 - */ -#define EVENT_AUDIO_JANK_FRAME "AUDIO_JANK_FRAME" - /** * @brief OS domain. * diff --git a/multimedia/av_codec/native_avcapability.h b/multimedia/av_codec/native_avcapability.h index 1d0af06b2b47a70e57f70e5f8440b67e56dd7d56..3c8649510a60c693bee868cff1098b08c40814e9 100644 --- a/multimedia/av_codec/native_avcapability.h +++ b/multimedia/av_codec/native_avcapability.h @@ -84,7 +84,7 @@ typedef enum OH_AVCapabilityFeature { VIDEO_ENCODER_TEMPORAL_SCALABILITY = 0, /** Feature for codec supports long-term reference. It is only used in video encoder. */ VIDEO_ENCODER_LONG_TERM_REFERENCE = 1, - /** Feature for codec supports low latency. It is used in video encoder and video decoder. */ + /** Feature for codec supports low latency. It is only used in video decoder. */ VIDEO_LOW_LATENCY = 2, /** Feature for codec supports B-frame encoding. It is only used in video encoder. * @since 20 diff --git a/multimedia/av_codec/native_avcodec_base.h b/multimedia/av_codec/native_avcodec_base.h index 7745ac2101f9066330942d3bd141a608a2ec70e2..0042b76b4a2da27c3f8f01b44f2254bfe09f2a95 100644 --- a/multimedia/av_codec/native_avcodec_base.h +++ b/multimedia/av_codec/native_avcodec_base.h @@ -944,8 +944,8 @@ extern const char *OH_MD_KEY_VIDEO_PIC_WIDTH; extern const char *OH_MD_KEY_VIDEO_PIC_HEIGHT; /** * @brief Key to enable the low latency mode, value type is int32_t (0 or 1):1 is enabled, 0 otherwise. - * If enabled, the video encoder or video decoder doesn't hold input and output data more than required by - * the codec standards. This is an optional key that applies only to video encoder or video decoder. + * If enabled, the video decoder doesn't hold input and output data more than required by + * the codec standards. This is an optional key that applies only to video decoder. * It is used in configure. * * @syscap SystemCapability.Multimedia.Media.CodecBase diff --git a/multimedia/player_framework/lowpower_audio_sink.h b/multimedia/player_framework/lowpower_audio_sink.h index 07f24a2999867ed323462567a676035cdcf3d874..226f1f17a292d73a00748310e0e39cfe76eb7c09 100644 --- a/multimedia/player_framework/lowpower_audio_sink.h +++ b/multimedia/player_framework/lowpower_audio_sink.h @@ -258,20 +258,6 @@ OH_AVErrCode OH_LowPowerAudioSink_SetPlaybackSpeed(OH_LowPowerAudioSink* sink, c */ OH_AVErrCode OH_LowPowerAudioSink_ReturnSamples(OH_LowPowerAudioSink* sink, OH_AVSamplesBuffer* samples); -/** - * @brief Set the loudness gain for lowpower audio sink. - * - * @param {OH_LowPowerAudioSink*} sink Pointer to an OH_LowPowerAudioSink instance. - * @param {float} loudnessGain Loudness gain to set which changes from -90.0 to 24.0, expressing in dB. - * The default loudness gain is 0.0dB. - * @return Returns AV_ERR_OK if the gain is set successfully; - * otherwise, returns a specific error code as defined in {@link OH_AVErrCode} - * {@link AV_ERR_INVALID_VAL} the sink is nullptr or loudnessGain is out of valid range. - * {@link AV_ERR_SERVICE_DIED} media service is died. - * @since 20 - */ -OH_AVErrCode OH_LowPowerAudioSink_SetLoudnessGain(OH_LowPowerAudioSink* sink, float loudnessGain); - /** * @brief Regsister callback instance for lowpower audio sink. * diff --git a/multimedia/player_framework/lowpower_avsink/liblowpower_avsink.ndk.json b/multimedia/player_framework/lowpower_avsink/liblowpower_avsink.ndk.json index 7e53713e491574d739dd5d83c218d7ebb6cf50de..079f642c5fbba140774dd4334ba23d0c1600210b 100644 --- a/multimedia/player_framework/lowpower_avsink/liblowpower_avsink.ndk.json +++ b/multimedia/player_framework/lowpower_avsink/liblowpower_avsink.ndk.json @@ -67,10 +67,6 @@ "first_introduced": "20", "name": "OH_LowPowerAudioSink_ReturnSamples" }, - { - "first_introduced": "20", - "name": "OH_LowPowerAudioSink_SetLoudnessGain" - }, { "first_introduced": "20", "name": "OH_LowPowerAudioSink_RegisterCallback" diff --git a/web/webview/interfaces/native/libohweb.ndk.json b/web/webview/interfaces/native/libohweb.ndk.json index c86a02925aa59078751e1186c6315c1a960ed980..1cdb08fd6a841b158b8b48b1388fde3371b32d21 100644 --- a/web/webview/interfaces/native/libohweb.ndk.json +++ b/web/webview/interfaces/native/libohweb.ndk.json @@ -366,5 +366,13 @@ { "first_introduced": "20", "name": "OH_ArkWebResourceHandler_DidFailWithErrorV2" + }, + { + "first_introduced": "20", + "name": "OH_NativeArkWeb_SetActiveWebEngineVersion" + }, + { + "first_introduced": "20", + "name": "OH_NativeArkWeb_GetActiveWebEngineVersion" } ] diff --git a/web/webview/interfaces/native/native_interface_arkweb.h b/web/webview/interfaces/native/native_interface_arkweb.h index 10332371c25cfc6edba29c677bbef88757d8712b..122d0c50bb4363bbcec2ba7b86b7f04fb4b1a7d3 100644 --- a/web/webview/interfaces/native/native_interface_arkweb.h +++ b/web/webview/interfaces/native/native_interface_arkweb.h @@ -93,6 +93,34 @@ typedef struct { int32_t loadingTime; } ArkWeb_BlanklessInfo; +/** + * @brief ArkWeb Engine Version. + * + * ArkWeb Dual Web Engine Versioning Convention: + *

See [ArkWeb Dual Web Engine Versioning Convention] for switching between Legacy and Evergreen Web Engine. + * + * @since 20 + */ +typedef enum { + /** + * the system default ArkWeb engine. + * @since 20 + */ + SYSTEM_DEFAULT = 0, + + /** + * ArkWeb M114 version. + * @since 20 + */ + ARKWEB_M114 = 1, + + /** + * ArkWeb M132 version. + * @since 20 + */ + ARKWEB_M132 = 2, +} ArkWebEngineVersion; + /** * @brief Loads a piece of code and execute JS code in the context of the currently displayed page. * @@ -315,6 +343,30 @@ ArkWeb_ErrorCode OH_ArkWebCookieManager_SaveCookieSync(); */ void OH_ArkWebCookieManager_SaveCookieAsync(OH_ArkWeb_OnCookieSaveCallback callback); +/** + * Set active ArkWeb engine version. + * If the system does not support the specified version, it will not take effect. + * + * This is a global static API that must be called before initializeWebEngine, and it will have no effect if any + * Web components are loaded. + * + * Legacy Web Engine Compatibility Note: + *

When using legacy ArkWeb Engine, some ArkWeb newly created API will not take effect,
+ * see [Compatible with Legacy Web Engine in release note] for compatibility guidelines. + *

+ * + * @param { ArkWebEngineVersion } webEngineVersion - the ArkWebEngineVersion + * @since 20 + */ +void OH_NativeArkWeb_SetActiveWebEngineVersion(ArkWebEngineVersion webEngineVersion); + +/** + * Get currently active ArkWeb engine version. + * @return { ArkWebEngineVersion } Active ArkWeb Engine version as defined by ArkWebEngineVersion + * @since 20 + */ +ArkWebEngineVersion OH_NativeArkWeb_GetActiveWebEngineVersion(); + #ifdef __cplusplus }; #endif