跨平台应用开发进阶(三十九)uni-app实现内容分享_uniapp uni-share

一、前言

APP开发过程中，需要实现分享功能。

常用的分享实现方法包括：

• 系统分享组件；
• uniShare SDK调用；

二、系统分享组件

uni.shareWithSystem(OBJECT)
1

调用系统分享组件发送分享消息，不需要配置分享SDK。分享效果为标题+链接+图片形式，不支持摘要。

注意事项⚠️

• Android端当msg参数中设置图片（imageUrl属性）时，分享类型自动变为为image，在分享时可能只会发送图片（如微信）；没有设置图片时分享类型则认为是文本text。
• Android端高版本无法分析私有路径的图片，只能分享来自相册的图片（使用 uni.chooseImage 选择图像时请设置为原图）。
• iOS端不同的分享程序对分享内容有要求，如微信分享时必须添加链接地址href，否则微信分享失败。 注：iOS8.0及以上系统触发成功回调则表示发送消息成功。

// iOS应用系统自带分享方式
	uni.shareWithSystem({
	  type: "text",
	  summary: this.detailData.resourceName + summary,
	  href: href,
	  imageUrl: "../../../static/logo.png",
	  success(){
	      console.log('分享成功');
	    // 分享完成，请注意此时不一定是成功分享
	  },
	  fail(){
	      console.log('分享失败');
	    // 分享失败
	  },
	  complete() {
		  console.log('分享完成');
	  }
	});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

三、uniShare SDK调用

uni-app提供了uniShare组件实现分享。uni-app的App引擎已经封装了微信、QQ、微博的分享SDK，开发者可以直接调用相关功能。其相对于系统分享组件来说，可设置参数更多。分享效果为标题+摘要+链接+图片形式。

import UniShare from 'uni_modules/uni-share/js_sdk/uni-share.js';
const uniShare = new UniShare();
.....

// Android系统应用uniShare SDK调用方式
androidShare(href, summary, imageUrl) {
uniShare.show({
    content: { //公共的分享参数配置  类型（type）、链接（herf）、标题（title）、summary（描述）、imageUrl（缩略图）
        type: 0,
        href,
        title: this.detailData.resourceName,
        summary,
        imageUrl
    },
    menus: [
        {
            "img": "/static/wx.png",
            "text": "微信好友",
            "share": { //当前项的分享参数配置。可覆盖公共的配置如下：分享到微信小程序，配置了type=5
                "provider": "weixin",
                "scene": "WXSceneSession"
            }
        },
        {
        	"img": "/static/pyq.png",
        	"text": "朋友圈",
        	"share": {
        		"provider": "weixin",
        		"scene": "WXSceneTimeline"
        	}
        },
        // {
        //     "img": "/static/wb.png",
        //     "text": "微博",
        //     "share": {
        //         "provider": "sinaweibo"
        //     }
        // },
        {
            "img": "/static/hb.png",
            "text": "分享海报",
            "share": "sharePoster",
			"detailData": {...this.detailData, messageFlag: this.messageFlag}
        },
        {
            "img": "/static/lj.png",
            "text": "分享链接",
            "share": "copyurl"
        },
		{
			"img": "/static/more.png",
			"text": "更多",
			"share": "shareSystem"
		}					
    ],
    cancelText: "取消"
}, e => { //callback
    console.log(uniShare.isShow);
    console.log(e);
})
},
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

实现效果如下：

四、题外话

4.1 不支持的分享类型

在iOS平台应用uniShare SDK调用方式实现微信分享时，给出如下错误提示信息：

出现以上问题的原因是未在微信开发者平台注册应用。

4.2 微信转发链接不显示图片和描述文字

APP转发至微信后，微信内打开内容点击右上角分享功能，发现微信转发链接不显示图片和描述文字，只显示标题，内容可正常查看。

DCloud官方给出的解决方案是：要分享的网页使用 weixin-js-sdk 来配置。

五、拓展阅读

• uni.shareWithSystem(OBJECT)
• uni-share SDK
• uni.share
• DCloud问答社区（转发微信分享图片内容都没了）
• wein-js-sdk 下载
• 微信开发者平台