更新记录

1.3(2022-10-19)

升级Android端SDK到最新版本,适配Android 11。

1.2(2022-03-09)

修复安卓分享小程序图片模糊问题。

查看更多

平台兼容性

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

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


企业微信授权登录和分享插件接口

注意:

A、管理员登录企业微信管理后台,选择企业应用

B、选择已有应用或添加应用,进入应用详情页面。

C、选择“企业微信授权登录”,在设置界面填写Android的签名&包名和iOS的Bundleid,设置完成后系统自动生成应用程序schema。

1、插件对象

//SDK插件对象
var sdkwx = uni.requireNativePlugin('Wework-SdkWX');

2、初始化注册到企业微信,onLoad中调用一次即可

//初始化注册到企业微信
var schema = "wwauth1e933be11645237c000012";//应用跳转标识,显示在具体应用下的 Schema字段
var appid = "WW1e933be11645237c";//企业唯一标识。创建企业后显示在,我的企业 CorpID字段
var agentid = "1000012";//应用唯一标识。显示在具体应用下的 AgentId字段
sdkwx.registerApp(schema, appid, agentid);

3、检测是否安装企业微信

//检测是否安装企业微信
sdkwx.isAppInstalled(function(ret){
    console.log(ret);
    if (ret == true) {
        //已安装
    } else {
        //未安装
    }
});

4、打开企业微信

//打开企业微信
sdkwx.openApp(function(ret){
    console.log(ret);
    if (ret == true) {
        //成功
    } else {
        //失败
    }
});

5、授权登录

//授权登录
var state = "test12345678";//用于保持请求和回调的状态,授权请求后原样带回给第三方。建议设置为简单的随机数加session进行校验
sdkwx.auth(state, function(res){
    console.log(res);
    var state = res.state;//状态原样返回
    var errCode = res.errCode;//错误码
    if (errCode == 0) {
        //成功
        var code = res.code;//授权临时票据
    } else if (errCode == 1) {
        //取消
    } else {
        //错误
        var errMsg = res.errMsg;//错误消息
    }
});

6、分享文本

//分享文本
var text = "分享文本测试";
sdkwx.shareText(text);

7、分享图片

//分享图片
var filename = "logo.png";
var path = plus.io.convertLocalFileSystemURL("_www/static/logo.png");
sdkwx.shareImage(filename, path);

8、分享文件

//分享文件
var filename = "readme.pdf";
var path = plus.io.convertLocalFileSystemURL("_www/static/readme.pdf");
sdkwx.shareFile(filename, path);

9、分享视频

//选择视频
uni.chooseVideo({
    count: 1, 
    sizeType: ['original', 'compressed'],
    sourceType: ['camera','album'], //从相册选择
    success: function (res) {
        var videoPath = plus.io.convertLocalFileSystemURL(res.tempFilePath);
        console.log(videoPath);
        //分享视频
        var filename = "video.mp4";
        sdkwx.shareVideo(filename, videoPath);
    }
});

10、分享链接

//分享链接
var thumbUrl = "https://www.baidu.com/img/flexible/logo/pc/result@2.png";
var webpageUrl = "https://www.baidu.com";
var title = "测试标题";
var description = "测试描述";
sdkwx.shareLink(thumbUrl, webpageUrl, title, description);

11、分享小程序

//分享小程序
var imagePath = plus.io.convertLocalFileSystemURL("_www/static/logo.png");
sdkwx.shareMiniProgram({
    username:"gh_dde54cb88ce7@app",//必须是应用关联的小程序,注意要有@app后缀
    title:"测试_MaHow",
    hdImageData:imagePath,
    path:"/pages/plugin/index.html?plugid=1cbd3b7c8674e61769436b5e354ddb2f"
}, function(res){
    console.log(res);
    var errCode = res.errCode;//错误码
    if (errCode == 0) {
        //成功
    } else if (errCode == 1) {
        //取消
    } else {
        //错误
        var errMsg = res.errMsg;//错误消息
    }
});

12、在manifest.json配置中,ios设置, UrlScheme设置 应用跳转标识,显示在具体应用下的 Schema字段

/* ios打包配置 */
"ios" : {
    "urltypes" : "wwauth1e933be11645237c000012"
}

隐私、权限声明

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

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

插件自身不采集任何数据,插件使用的企业微信移动端SDK采集数据请参考其官方说明:https://work.weixin.qq.com

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

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