gesturesshare 0.0.1
gesturesshare: ^0.0.1 copied to clipboard
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 平台;其他平台调用将未实现或报错。
- 图片路径需为应用可访问的本地文件路径。