uni-app APP 分享插件：zhouWei-APPshare 使用指南

本文介绍 DCloud 插件市场的一款热门 uni-app 分享插件， zhouWei-APPshare。该插件支持 APP 内分享到微信好友、朋友圈、QQ、新浪微博等多个平台，帮助开发者快速集成原生分享功能。

插件简介

zhouWei-APPshare 是一款专为 uni-app 开发的 APP 原生分享插件，插件包体积仅 26KB，支持 uni_modules 规范。该插件在 DCloud 插件市场已获得 4,455 人下载，收藏人数达 465 人，是 uni-app 分享功能集成的优质选择。

支持平台

平台	支持情况
Android	✓ 支持
iOS	✓ 支持
微信小程序	× 不支持
H5	× 不支持
其他小程序	× 不支持

注意：此插件仅适用于 Android 和 iOS 原生 APP 环境，不支持小程序和 H5 平台。

核心特性

多平台分享：支持微信好友、朋友圈、QQ、新浪微博
多种分享类型：图文、纯文字、纯图片、音乐、视频、小程序
小程序分享：支持分享微信小程序卡片（需在微信开放平台绑定）
轻量易用：插件包仅 26KB，API 简洁
回调支持：支持分享成功/失败的回调处理

安装方法

方式一：通过 HBuilderX 导入（推荐）

打开 HBuilderX
点击「工具」→「插件安装」
搜索 zhouWei-APPshare 或插件 ID 1645
点击安装即可

方式二：下载 ZIP 手动导入

在插件市场下载 ZIP 包
解压到项目的 uni_modules 目录下
确保目录结构为 uni_modules/zhouWei-APPshare/

注意：导入 uni_modules 规范插件需要使用 3.1.0 以上版本的 HBuilderX。

配置说明

在 manifest.json 文件中配置分享参数：

打开 manifest.json
找到「App SDK 配置」→「分享」
配置对应平台的 AppID 和密钥：
- 微信分享：填写微信开放平台申请的 AppID
- QQ 分享：填写腾讯开放平台申请的 AppID
- 新浪微博：填写微博开放平台申请的 AppKey

重要：不配置参数时，在自定义基座中只会显示「复制」和「更多」选项。配置完成后需要重新打包才能生效。

使用示例

基础用法

vue

<template>
  <button type="default" @click="onShare">APP分享</button>
</template>

<script>
// 引入分享方法
import appShare, { closeShare } from '@/uni_modules/zhouWei-APPshare/js_sdk/appShare';

export default {
  methods: {
    onShare() {
      let shareData = {
        shareUrl: "https://kemean.com/",
        shareTitle: "分享的标题",
        shareContent: "分享的描述",
        shareImg: "http://qn.kemean.cn/upload/202004/18/example.jpg",
        appId: "wxd0e0881530ee4444",      // 分享小程序时必传
        appPath: "pages/home/home",        // 小程序页面路径
        appWebUrl: "https://kemean.com/",  // 兼容低版本的网页链接
      };

      // 调用分享
      let shareObj = appShare(shareData, res => {
        console.log("分享成功回调", res);
        // 分享成功后关闭弹窗
        closeShare();
      });

      // 也可以定时关闭
      setTimeout(() => {
        shareObj.close();
      }, 5000);
    }
  }
}
</script>

API 参数说明

shareData 参数

参数名称	类型	必填	说明
shareUrl	String	条件	分享的地址（type 为 0 时必传）
shareTitle	String	是	分享的标题
shareContent	String	否	分享的描述（type 为 1 时必传）
shareImg	String	条件	分享的图片（type 为 0、2、5 时必传）
mediaUrl	String	条件	分享的音视频地址（type 为 3、4 时必传）
type	Number	否	分享形式，见下方 type 说明

type 值说明

值	说明	支持平台
0	图文	微信、新浪微博
1	纯文字	全平台支持
2	纯图片	全平台支持
3	音乐	微信、QQ
4	视频	微信、新浪微博
5	小程序	微信聊天界面

平台默认值

平台	默认 type
新浪微博	0（图文）
微信好友	0（图文）
微信朋友圈	0（图文）
QQ	1（纯文字）
微信小程序	5（小程序）

分享小程序必传参数（type 为 5 时）

注意：小程序必须是在微信开放平台与 App 绑定的才行。

参数名称	类型	必填	说明
appId	String	是	微信小程序原始 ID
appPath	String	是	点击链接进入的页面
appWebUrl	String	是	兼容低版本的网页链接
appType	Number	否	0-正式版，1-测试版，2-体验版

常见问题

Q1: 运行示例报错？

答：不要在 H5、小程序等浏览器环境中运行，此插件只适合在 Android、iOS 原生 APP 上运行。

Q2: 分享图标不显示？

答：插件里面 static 文件夹中的图片需要放到项目根目录的 static 文件夹里面。直接导入插件时如果结构有问题，请手动调整。

Q3: 分享出去的图片不显示？

答：本分享插件使用的是官方分享 API，如有分享问题，请仔细研究官方的分享 API 文档。注意新浪微博分享图片仅支持本地路径。

Q4: 分享到朋友圈的 scene 值？

答：分享到朋友圈时应使用 WXSceneTimeline。

更新记录

v2.0.3（2021-07-12）：修改关闭回调 bug
v2.0.2（2021-06-25）：修复图标不显示问题
v2.0.1（2021-06-07）：修改图片不显示 bug

许可协议

MIT 协议

字节笔记本