Changelog #

本文档记录 holding 插件的版本变更。

格式基于 Keep a Changelog，版本号遵循语义化版本。

0.0.2 API 26 升级版 #

构建配置升级：示例工程 compatibleSdkVersion、compileSdkVersion 与 targetSdkVersion 统一升级为 26.0.0（API 26；compatibleSdkVersion 随新版 Flutter SDK 链接的 @ohos/flutter_ohos 最低要求同步上调，原为 5.1.0(18)）；验证环境升级为 Flutter 3.47.9-ohos-1.0.0（oh-3.47-dev 分支）、Dart 3.13.4、DevEco Studio 26.0.0。
仓库地址统一：下载、Issue、PR 链接统一为 AtomGit（atomgit.com/oh-flutter/holding-harmony）。
文档更新：开发环境章节更新至 API 26 构建配置。

操作手状态订阅：Holding.subscribeOperatingHand(SubscribeOperatingHandOptions) / unsubscribeOperatingHand([options])，基于鸿蒙 motion.on/off('operatingHandChanged')（since API 15），对应 motion.OperatingHandStatus（unknown/left/right）。
最近操作手查询：Holding.getRecentOperatingHandStatus(GetRecentOperatingHandStatusOptions)，基于鸿蒙 motion.getRecentOperatingHandStatus() 同步查询并经 MethodChannel 异步回调返回。
新通道：EventChannel holding/operating/events 下发操作手整型状态；MethodChannel holding 新增 subscribeOperatingHand、unsubscribeOperatingHand、getRecentOperatingHandStatus 三个方法。

握持手状态订阅：Holding.subscribeHoldingHand(SubscribeHoldingHandOptions)，订阅系统握持手状态变化。
取消订阅：Holding.unsubscribeHoldingHand([UnsubscribeHoldingHandOptions?])，取消握持手状态监听。
握持手状态枚举：HoldingHandStatus（none / left / right / both / unknown），与鸿蒙 motion.HoldingHandStatus 对应，提供 code 与 fromCode(int)。
订阅选项：SubscribeHoldingHandOptions（必填 onChange，可选 success、fail、complete）；UnsubscribeHoldingHandOptions（可选 success、fail、complete）。
OHOS 平台实现：基于 MethodChannel（holding）与 EventChannel（holding/events），使用 @kit.MultimodalAwarenessKit 的 motion.on('holdingHandChanged') / motion.off('holdingHandChanged') 接收并下发状态。
权限：插件 HAR 声明 ohos.permission.DETECT_GESTURE、ohos.permission.ACTIVITY_MOTION。
示例应用：example/ 中提供握持手订阅 UI 与状态变化记录示例。