HarmonyOS实战开发-自定义分享

news2024/12/23 10:10:26

介绍

自定义分享主要是发送方将文本，链接，图片三种类型分享给三方应用,同时能够在三方应用中展示。本示例使用数据请求实现网络资源的获取，使用屏幕截屏实现屏幕的截取，使用文件管理实现对文件，文件目录的管理，使用媒体库管理获取截取的图片，使用弹窗进行信息的提示。

效果预览

在这里插入图片描述
使用说明：

1.启动Share应用，首页展示分享跳转页面，点击分享按钮出现自定义分享弹窗（三方APP的）。

2.点击分享文本+链接，选择"Chat"图标，会拉起三方应用Chat ，此时选择聊天列表中任意的朋友进行分享。

3.点击生成海报，此时第一层弹窗消失并出现新的弹窗，点击截图并分享，会出现小提示"截图成功，分享加载中…" ,稍后会拉起三方应用Chat ，此时选择聊天列表中任意的朋友进行分享。

4.安装entry以及textShare两个module的hap包，点击分享文本+链接，选择"文本分享"图标，会拉起应用文本分享 ,此时选择"留在文本分享"可以进入文本页面 ,若选择"返回"，则会回到Share应用主页面。

5.安装entry以及textEdit两个module的hap包，点击分享文本+链接，选择"文本编辑"图标，会拉起应用文本编辑 ,此时选择"留在文本编辑"可以进入文本编辑页面 ,若选择"返回"，则会回到Share应用主页面。

工程目录

entry/src/main/ets/
|---Application
|   |---MyAbilityStage.ets                   
|---MainAbility
|   |---MainAbility.ts                   
|---model
|   |---Logger.ts                      // 日志工具
|---pages
|   |---Index.ets                      // 首页
textShare/src/main/ets/
├──model
|  └──Logger.ts
├──pages
|  ├──Index.ets                       // TextReceiveAbility页面
|  ├──TemplateBuilder.ets             // 自定义组件页面
|  └──ShareExtenIndex.ets             // ShareExtension页面
├──textreceiveability
|  └──TextReceiveAbility.ts           // 文本分享主页面
├──shareextensionability
|  └──ShareExtAbility.ts
textEdit/src/main/ets/
├──editability
|  └──EditTextAbility.ts              // 文本编辑主页面
├──model
|  └──Logger.ts
├──pages
|  ├──Index.ets                       // EditTextAbility页面
|  ├──TemplateBuilder.ets             // 自定义组件页面
|  └──ShareExtenIndex.ets             // ShareExtension页面
└──shareextensionability
   └──ShareExtAbility.ts

具体实现

本示例分为链接分享，应用内文件分享，其它应用分享三个模块：
文本+链接分享模块
ButtonDialogBuilder方法展示自定义分享弹窗，@ohos.abilityAccessCtrl接口获取访问控制权限，@ohos.net.http接口获取网络资源。
应用内文件分享模块
使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)接口进行图片、链接，视频的分享
其他应用分享模块：
使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)API，把图片，链接，文件在其他应用内分享
本示例还包含文本分享应用及文本编辑应用：
在Index.ets中加载TemplateBuilder自定义组件并显示分享信息。
在加载Index页面中，如果是被分享方拉起，则加载TemplateBuilder自定义组件。若不是被分享拉起，则显示Ability设置内容。
TemplateBuilder组件内容封装在TemplateBuilder.ets中
在TemplateBuilder组件中包含ShareExtAbility组件、“返回Share”和“留在文本分享/留在文本编辑”按钮，可选择返回Share应用或留在当前（文本分享/文本编辑）应用。

依赖

依赖于Chat 应用，来作为接收方。

entry中测试Share.test.ets需要依赖textShare以及textEdit，需要编译两个feature module的hap包，并与entry应用hap包及测试hap包一同签名并安装。

约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568。

2.本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0 Release)

3.本示例需要使用DevEco Studio 版本号(4.0 Release)及以上版本才可编译运行

4.本示例使用的screenshot API属于SystemAPI，需要使用Full SDK 手动从镜像站点获取，并在DevEco Studio中替换。

5.本示例涉及相关权限为system_core级别，需要手动配置高级别的权限签名。

6.本示例类型为系统应用，需要手动配置对应级别的应用类型(“app-feature”: “hos_system_app”)。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/BasicFeature/ApplicationModels/CustomShare/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master

为了帮助大家更深入有效的学习到鸿蒙开发知识点，小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源，获取完整版方式请点击→HarmonyOS教学视频：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3