更新记录

2.2.0(2023-08-11)

优化v3版本分享功能,增加更多可分享类型支持,目前已支持绝大多数文件类型。

2.0.0(2023-08-02)

新增增强版本,可配置是否调起系统分享功能

1.2.6(2023-07-21)

兼容其他插件

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


luanqing-share

温馨提示:可下载demo示例工程或加作者咨询

QQ: 835588741/1660584265 微信: 15921627041

注意

1/ 需要在uniapp项目配置中开启微信分享功能
2/ 目前仅支持Android端 ,后续空闲了再开发IOS端
3/ 推荐使用V3版本api,v3版本不用初始化,只有一个shareFile2WX_V3方法,更简洁。v1版本分享可带app icon图标,但文件大小存在限制,微信官方是1M的大小限制

API 3 简要说明

名称 说明 默认值 是否必须
shareFile2WX_V3 调用开始分享

API 3 shareFile2WX_V3参数简要说明

名称 说明 默认值 是否必须
filePath String, 要分享的文件的全路径
type String, 要分享的模式,'wx_chat'是直接分享到微信聊天,'weixin'是可选择的分享到微信聊天或朋友圈等环境,'system'将会列出所有可分享的途径 'system'
filePath function, 可监听插件返回的日志

示例代码

    var shareObj = uni.requireNativePlugin("luanqing-share");

   shareObj.shareFile2WX_V3(realFilePath, 'wx_chat', (res=>{
     console.error("插件日志:", res);
   }));  

    # 包含获取真实路径的示例代码,如果已有在本地存在可以不用下载,这里仅仅是示例
    uni.downloadFile({
        url:'https://lmg.jj20.com/up/allimg/4k/s/02/2109250006343S5-0-lp.jpg',
        success(e) {
            console.error("下载成功:",e);
            // 获得文件临时路径
            var tempFilePath = e.tempFilePath;

            # 转换为真实路径
            plus.io.resolveLocalFileSystemURL(tempFilePath, function(entry) {
              var realFilePath = entry.toLocalURL();

              shareObj.shareFile2WX_V3(realFilePath, 'wx_chat', (res=>{
                 console.error("插件日志:", res);
              }));  
            });
        },
        fail(e) {
            console.error("下载失败:",e);
            uni.hideLoading();
        }
    })

-------------------------------------- 版本分割 --------------------------------------

API 1 简要说明

名称 说明 默认值 是否必须
init 初始化插件
shareFile2WX 开始分享
函数具体用法以及参数介绍
<!-- 初始化函数,建议放在uniapp页面的 onReady|onShow 方法中,appid为微信开放平台上注册的appid  -->
init({ appid : 微信开放平台的appid })  

<!-- 开始分享时调用, fullPath为完整的全路径,如:/storage/emulated/0/Android/data/包名/apps/__UNI__XXXXXX/doc/uniapp_temp_1658384704345/download/test.xlsx, 传入fullPath后可以不用再传uniPath和uniAppId -->
<!-- 如果是使用uni.downloadFile 下载后的临时文件路径,需要传uniPath和uniAppId,uniPath即为临时文件路径(tempFilePath),uniAppId是manifest.json中的DCloud appid -->
<!-- scene 分享场景, 可选”favorite“(微信收藏) 或不填,默认分享到好友列表 聊天页面 -->
shareFile2WX({ fullPath:"...", uniPath:"...", uniAppId:"__UNI__XXXXXX", scene: "xx" })

使用方法:

<script>
    var shareObj = uni.requireNativePlugin("luanqing-share");

    export default {
        methods: {
            // 开始下载
            download(){
                const $that = this;
                // downloadFile是Get请求,只要配置好后可以直接下载,笔者这里是后端接口返回excel文件的二进制文件流,因此通过配置Content-Type 和 Accept来处理下载下来的格式
                uni.downloadFile({
                    url: 'https://xxxx/xxx/xxx/xxx/xxx?id=xxx',
                    header: {
                        'Content-Type': 'application/xlsx; charset=UTF-8', // 默认值
                        'Accept': 'xlsx/xlsx',
                    },
                    success: (res) => {
                        ////console.log("下载成功:",res.tempFilePath);
                        $that.share2WeChat(res.tempFilePath);
                    }
                })
            },
            // 执行分享
            share2WeChat(path){
                // 获取DCloud AppId
                let appid = uni.getSystemInfoSync().appId;
                shareObj.shareFile2WX({uniPath:path,uniAppId:appid});
            }
        }
    }
</script>

上海栾青网络科技有限公司

15921627041 (同微信)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问