更新记录

1.0.0（2021-08-18）

初次发布插件

平台兼容性

原生插件通用使用流程：

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

Facebook登录，分享功能Android插件（插件有问题请联系QQ：1684729125）

插件使用条件前准备

• 登录Facebook开发者官网注册账号，新建应用等，开发者官网地址：https://developers.facebook.com/
• Facebook登录配置文档地址：https://developers.facebook.com/docs/facebook-login/android
• Facebook分享配置文档地址：https://developers.facebook.com/docs/sharing/android
• Facebook登录配置中第五项：
  • 此处使用Uniapp官方默认类：io.dcloud.PandoraEntryActivity（将软件包名称和默认类与应用进行关联）
• Facebook登录配置中第六项：
  • 可通过插件的方法获取，后面会详情。（为应用提供开发和发布密钥散列）

插件配置(uniapp项目中android原生插件配置)

引用插件

var ShareModule = uni.requireNativePlugin('GT-Facebook_ShareModule');
var LoginModule = uni.requireNativePlugin('GT-Facebook_LoginModule');
var AndroidUtilModule = uni.requireNativePlugin('GT-Facebook_AndroidUtilModule');

获取密钥散列KeyHash

/**
 * 获取密钥散列
 * packageName 项目包名
 */
doLoadKeyHash(){
    AndroidUtilModule.loadKeyHash(ret => {
        console.log('loadKeyHash result: ',ret);
    });
},

Facebook登录使用方法

/**
 * 退出登录
 */
doLoginout(){
    uni.showLoading({
        title: 'loading...',
        mask: true
    });
    LoginModule.logout(ret => {
        uni.hideLoading();
        if(ret){
            util.toast('退出登录成功');
        }else{
            util.toast('退出登录失败');
        }
    });
},

/**
 * 检查是否已登录
 */
doCheckLogin(){
    uni.showLoading({
        title: 'loading...',
        mask: true
    });
    LoginModule.isLogin(ret => {
        uni.hideLoading();
        if(ret){
            util.toast('已登录');
        }else{
            util.toast('未登录');
        }
    });
},

/**
 * 登陆
 * @param {Object} e
 */
doLogin(e) {
    let that = this;
    console.log('click to login.');
    uni.showLoading({
        title: 'loading...',
        mask: true
    });
    LoginModule.handleLogin(ret => {
        uni.hideLoading();
        if (ret.code == 200) {
            if (ret.msg) {
                let result = JSON.parse(ret.msg);
                console.log('result: ',result);
                util.toast('登录成功,email: '+result.email);
            } else {
                util.toast('Failed to obtain login information, please try again later');
            }
        } else if (ret.code == 1001) {
            util.toast('Cancel login');
        } else {
            util.toast(`error: ${ret.msg}`);
        }
    });
},

Facebook分享相关方法

/**
 * 分享链接
 * @param {Object} e
 */
doShareUrl(e) {
    let that = this;
    let mUrl = 'https://www.baidu.com';
    let mQuote = '百度一下，你就知道!';
    uni.showLoading({
        title: 'loading...',
        mask: true
    });
    ShareModule.handleShare(
        {
            shareType: '0',
            shareUrl: mUrl,
            shareQuote: mQuote
        },
        ret => {
            uni.hideLoading();
            if (ret.code == 200) {
                util.toast('Share success');
            } else if (ret.code == 1001) {
                util.toast('Cancel sharing');
            } else {
                util.toast('error: ' + ret.msg, 2000);
            }
        }
    );
},

/**
 * 分享项目内图片
 */
doShareLocalImg() {
    let that = this;
    console.log('click to share');
    uni.showLoading({
        title: 'loading...',
        mask: true
    });
    ShareModule.handleShare(
        {
            shareType: '1',
            shareImgPath: '/static/share.jpg'
        },
        ret => {
            uni.hideLoading();
            if (ret.code == 200) {
                util.toast('Share success');
            } else if (ret.code == 1001) {
                util.toast('Cancel sharing');
            } else {
                util.toast('error: ' + ret.msg, 2000);
            }
        }
    );
},
/**
 * 选择本地图片分享
 */
doChooseImg() {
    let that = this;
    uni.chooseImage({
        count: 1,
        sizeType: ['original', 'compressed'],
        sourceType: ['album'], //从相册选择
        success: function(res) {
            if (res && res.tempFilePaths.length > 0) {
                uni.showLoading({
                    title: 'loading...',
                    mask: true
                });
                ShareModule.handleShare(
                    {
                        shareType: '1',
                        shareImgPath: res.tempFilePaths[0]
                    },
                    ret => {
                        uni.hideLoading();
                        if (ret.code == 200) {
                            util.toast('Share success');
                        } else if (ret.code == 1001) {
                            util.toast('Cancel sharing');
                        } else {
                            util.toast('error: ' + ret.msg, 2000);
                        }
                    }
                );
            }
        }
    });
},

/**
 * 分享视频
 */
doShareVideo() {
    let that = this;
    console.log('click to share');
    uni.chooseVideo({
        count: 1,
        sourceType: ['album'],
        success: function(res) {
            // console.log('path: ',res.tempFilePath);
            uni.showLoading({
                title: 'loading...',
                mask: true
            });
            ShareModule.handleShare(
                {
                    shareType: '3',
                    shareVideoPath: res.tempFilePath
                },
                ret => {
                    uni.hideLoading();
                    if (ret.code == 200) {
                        util.toast('Share success');
                    } else if (ret.code == 1001) {
                        util.toast('Cancel sharing');
                    } else {
                        util.toast('error: ' + ret.msg, 2000);
                    }
                }
            );
        }
    }); 
}

Facebook分享方法参数说明

结果码参数说明(登录、分享均适用)

登录回调方法参数说明

分享回调方法参数说明

备注及其他问题

• 如果使用分享提示没有权限，请在facebook开发者后台把应用修改为发布状态。如果需要使用其他facebook账号测试，请把账号添加为测试用户
• Facebook登录与分享都需要科学上网才能测试使用
• 如果使用各种免费的上网方法，IP地址会经常变化，新注册的facebook账号用不了多久就会被封号。
• 测试使用插件要使用自定义基座