分享App Linking直达应用
提供如何通过隔空传送分享实现直达应用,应用需接入App Linking以确保端到端完整的体验。参考:使用App Linking实现应用间跳转。
注意事项
- 当进入可分享页面时,使用harmonyShare.on('gesturesShare')方法注册隔空传送监听事件。
- 当离开可分享页面(包括应用退至后台等场景)时,使用harmonyShare.off('gesturesShare')方法取消隔空传送监听事件。
开发步骤
-
导入相关模块。
import { uniformTypeDescriptor as utd } from '@kit.ArkData';import { systemShare, harmonyShare } from '@kit.ShareKit';import { fileUri } from '@kit.CoreFileKit'; -
定义隔空传送分享事件监听/取消监听方法(收到隔空传送分享事件回调后,建议3秒内调用sharableTarget.share()方法发起分享,否则可能导致超时失败)。
private immersiveCallback = (sharableTarget: harmonyShare.SharableTarget) => {let uiContext: UIContext = this.getUIContext();let contextFaker: Context = uiContext.getHostContext() as Context;let filePath = contextFaker.filesDir + '/exampleKnock1.jpg'; // 仅为示例 请替换正确的文件路径let shareData: systemShare.SharedData = new systemShare.SharedData({utd: utd.UniformDataType.HYPERLINK,content: 'https://sharekitdemo.drcn.agconnect.link/ZB3p',thumbnailUri: fileUri.getUriFromPath(filePath),title: '隔空传送分享卡片标题',description: '隔空传送分享卡片描述'});sharableTarget.share(shareData);}private immersiveListening() {harmonyShare.on('gesturesShare', this.immersiveCallback);}private immersiveDisablingListening() {harmonyShare.off('gesturesShare', this.immersiveCallback);} -
进入可分享页面时,注册隔空传送分享监听事件;离开可分享页面(包括应用退至后台等场景)时,取消隔空传送分享监听事件。
// Entry Component 代码片段onPageHide(): void {let uiContext: UIContext = this.getUIContext();let context: Context = uiContext.getHostContext() as Context;context.eventHub.emit('onBackGround');}aboutToAppear(): void {this.immersiveListening();let uiContext: UIContext = this.getUIContext();let context: Context = uiContext.getHostContext() as Context;context.eventHub.on('onBackGround', this.onBackGround);}aboutToDisappear(): void {this.immersiveDisablingListening();let uiContext: UIContext = this.getUIContext();let context: Context = uiContext.getHostContext() as Context;context.eventHub.off('onBackGround', this.onBackGround);}private onBackGround = () => {this.immersiveDisablingListening();}