gesturesshare 0.0.1

Flutter 隔空传送分享插件，支持 HarmonyOS/OpenHarmony。通过系统 ShareKit 注册隔空传送监听，用户触发手势时自动分享指定图片与 App Linking。

Changelog

本文档记录 gesturesshare 的版本变更。版本号遵循 语义化版本 2.0.0。

---

0.0.1 - 2025-02-09

新增

• 隔空传送分享能力：支持在 HarmonyOS/OpenHarmony 上注册隔空传送监听，用户触发隔空传送手势时自动分享指定内容。
• API
  • Gesturesshare.registerGesturesShare(RegisterGesturesShareOptions)：注册隔空传送分享，支持图片路径、App Linking、标题、描述。
  • Gesturesshare.unregisterGesturesShare()：注销隔空传送分享监听。
  • Gesturesshare.onShareTriggered：Stream<GesturesShareResult>，监听实际触发分享时的成功/失败结果。
  • Gesturesshare.getPlatformVersion()：获取平台版本信息。
• 类型
  • RegisterGesturesShareOptions：注册参数（imagePath、appLink、title、description）。
  • GesturesShareResult：分享结果（success、errCode、errMsg）。
• OHOS 原生实现
  • 使用 @kit.ShareKit 的 harmonyShare.on('gesturesShare') / harmonyShare.off('gesturesShare')。
  • 实现 AbilityAware，通过 UIAbility.context 获取窗口以正确注册隔空传送。
  • 支持纯图片（IMAGE）与「链接 + 缩略图」（HYPERLINK）两种分享类型。
• Example
  • 首页场景选择：分享福卡、分享图片、自定义参数。
  • 分享福卡：模拟赠送福卡场景（图片 + App Linking）。
  • 分享图片：仅分享本地图片。
  • 自定义参数：完整表单与运行日志，便于调试。
• 文档
  • README.md：安装、API、约束、实现说明、开源协议。
  • 使用说明.md：环境、安装、API 说明、完整示例、运行 example、注意事项。
  • LICENSE：Apache License 2.0，版权归属坚果派。

约束与说明

• 仅支持 OHOS 平台；其他平台调用将未实现或报错。
• 图片路径需为应用可访问的本地文件路径。

---