更新记录

1.1.0(2024-04-19)

新增支持File路径转化Uri方法,支持分享通过uniapp的API获取的图片路径

1.0.1(2022-11-02)

1、更新插件上架说明


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.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原生插件配置”->”云端插件“列表中删除该插件重新选择


WhatsApp分享,Telegram分享,android分享,File路径转化,File转Uri(插件有问题请联系QQ:1684729125)

插件说明(详情请参考示例项目)

  1. 插件仅支持android版本
  2. 插件支持WhatsApp,Telegram分享文本,图片功能
  3. 分享图片的参数为图片Uri,按Demo中使用GT-ShareAppPlatform_Choose选择图片即可。不适用该方法,能保证是传图片的Uri给插件即可。
  4. 本插件未判断WhatsApp、Telegram是否安装,可在uniapp代码中增加判断,否则未安装APP会报错。

回调参数说明

参数 说明 示例
code 结果码 1002
msg 回调结果 success
data 回调结果 content://xxx

结果码参数说明

Code 说明
200 成功结果码
201 取消选择图片
400 失败

使用插件代码如下

引用插件
var appShare = uni.requireNativePlugin('GT-ShareAppPlatform_Share');
var GtChooseImg = uni.requireNativePlugin('GT-ShareAppPlatform_Choose');
File路径转Uri,以chooseImage方法返回的file:///xxx 路径为例,转化为content:// 地址
/**
 * WhatsApp分享File路径图片
 * uniapp chooseImage选择图片返回的路径,保存图片返回路径等
 * file:/// 
 */
doShareWhatsAppImgByFile() {
    let that = this;
    that.showLoading();
    uni.chooseImage({
        count: 1,
        sizeType: ['original', 'compressed'],
        sourceType: ['album'], //从相册选择
        success: function(res) {
            // 路径转化  file:///  转化为  content://
            appShare.file2Uri(res.tempFilePaths[0], cRes => {
                if (cRes.code == 200) {
                    console.log('file2Uri result: ', cRes);
                    appShare.shareWhatsAppImg(cRes.data, ret => {
                        console.log('doShareTgImg result: ', ret);
                        uni.hideLoading(); 
                    });
                } else {
                    uni.hideLoading();
                    that.showToast(cRes.msg || "出错啦");
                }
            });
        }
    });
},
WhatsApp分享
//分享文本
appShare.shareWhatsAppTxt('测试WhatsApp文本分享:https://www.baidu.com', ret => {
    console.log('doShareWhatsAppTxt result: ', ret);
    uni.hideLoading();
});
//分享图片
GtChooseImg.chooseImg(ret => {  //先选择图片,回调结果为图片Uri
    console.log('chooseImg result: ',ret);
    if(ret.code==200){
        appShare.shareWhatsAppImg(ret.msg, ret => {
            console.log('doShareTgImg result: ', ret);
            uni.hideLoading();
        });
    }else{
        this.showToast(ret.msg || "出错啦");
    }
})
Telegram分享
//分享文本
appShare.shareTgTxt('测试Telegram文本分享:https://www.baidu.com', ret => {
    console.log('doShareTgTxt result: ', ret);
    uni.hideLoading();
});
//分享图片
GtChooseImg.chooseImg(ret => {
    console.log('chooseImg result: ',ret);
    if(ret.code==200){
        appShare.shareTgImg(ret.msg, ret => {
            console.log('doShareTgImg result: ', ret);
            uni.hideLoading();
        });
    }else{
        this.showToast(ret.msg || "出错啦");
    }
})

隐私、权限声明

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

Android: 读取本地文件:“android.permission.READ_EXTERNAL_STORAGE” 访问网络:“android.permission.INTERNET”

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

插件不采集任何数据

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

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