当前位置：首页 > news >正文

HarmonyOS开发实战：小分享-系统分享能力——@ohos.systemShare 集成

news 2026/7/23 11:09:52

前言

系统分享是让 App 内容流向其他应用的关键能力，HarmonyOS 提供了@ohos.systemShare分享 API。小分享 App 的 SharePreviewPage 中的分享按钮可以集成系统分享。本篇讲解系统分享的集成。详细 API 可参考 HarmonyOS SystemShare 官方文档。

一、系统分享基本用法

import { systemShare } from '@ohos.systemShare'; import { BusinessError } from '@ohos.base'; async function shareText(content: string): Promise<void> { try { await systemShare.share({ type: 'text/plain', data: content, title: '小分享' }); } catch (err) { console.error('Share failed: ' + JSON.stringify(err)); } }

二、分享不同类型内容

2.1 分享文本

await systemShare.share({ type: 'text/plain', data: '生活的美好在于分享', title: '小分享' });

2.2 分享图片

await systemShare.share({ type: 'image/png', data: imageUri, title: '小分享图片' });

2.3 分享链接

await systemShare.share({ type: 'text/plain', data: 'https://www.example.com/article/123', title: '分享链接' });

三、在 SharePreviewPage 中集成

@Builder ShareButton(icon: string, label: string, color: string) { Column({ space: 6 }) { Column() { Text(icon).fontSize(22) } .width(44).height(44).backgroundColor(color).borderRadius(22) .justifyContent(FlexAlign.Center).alignItems(HorizontalAlign.Center) Text(label).fontSize(11).fontColor('#666666') } .alignItems(HorizontalAlign.Center) .onClick(() => { if (label === '微信' || label === '更多') { shareText('生活的美好在于分享') } else if (label === '复制链接') { shareText('https://www.example.com/article/123') } }) }

四、分享参数说明

参数	类型	说明
`type`	string	MIME 类型
`data`	string	分享内容
`title`	string	分享标题
`uri`	string	文件 URI

五、本文核心知识点

5.1 系统分享核心要点

systemShare.share 调用系统分享面板
支持文本、图片、链接等类型
按 MIME 类型区分内容

5.2 实战开发要点

文本分享用 text/plain
图片分享用 image/png
用 try/catch 处理分享失败

附录：系统分享的完整实现细节

1. SystemShare 完整 API

API	作用	说明
`systemShare.share(options)`	调用系统分享	分享到其他应用
`type`	MIME 类型	text/plain, image/png
`data`	分享内容	文本或 URI
`title`	分享标题	显示在分享面板

2. 完整的分享流程

import { systemShare } from '@ohos.systemShare'; import { BusinessError } from '@ohos.base'; async function shareText(content: string): Promise<void> { try { await systemShare.share({ type: 'text/plain', data: content, title: '小分享' }); } catch (err) { console.error('Share failed: ' + JSON.stringify(err)); } } async function shareImage(uri: string): Promise<void> { try { await systemShare.share({ type: 'image/png', data: uri, title: '小分享图片' }); } catch (err) { console.error('Share image failed: ' + JSON.stringify(err)); } }

3. 分享不同类型的内容

类型	MIME	示例
文本	`text/plain`	分享文字内容
图片	`image/png`	分享图片 URI
链接	`text/plain`	分享 URL 字符串

4. 在 SharePreviewPage 中集成

@Builder ShareButton(icon: string, label: string, color: string) { Column({ space: 6 }) { Column() { Text(icon).fontSize(22) } .width(44).height(44).backgroundColor(color).borderRadius(22) Text(label).fontSize(11).fontColor('#666666') } .onClick(() => { if (label === '微信' || label === '更多') { shareText('生活的美好在于分享') } }) }