更新记录
1.18(2019-10-29)
优化android 获取用户信息逻辑,有限检查是否登录,并自动进行登录
1.17(2019-10-21)
完善淘客授权,统一ios及android返回值
1.15(2019-10-08)
-
iOS版本上线,略微调整价格,望谅解
-
完善帮助文档
-
完善案例
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 11.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:9 - 14 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
官方文档
Android下载体验
5+版本需要离线打包,有需要可联系作者37894663
下载安全图片
1.用您的签名任意生成apk,上传到百川官网
2.android 下载安全图片放置目录nativeplugins/PP-ALBC/android/res/drawable/yw_1222.jpg
3.iOS 下载安全图片放置目录nativeplugins/PP-ALBC/ios/yw_1222.jpg (更换后需要重新打包)
4.iOS 另外需要在项目的 manifest.json 文件加入下面代码 (修改后需要重新打包)
//"app-plus" ==> "distribute" ==> "ios" 节点
"ios" : {
"urltypes" : [
{
//AppKey从百川开发者控制台 应用管理 页面获得
//tbopen{AppKey} 24545262为测试案例的Appkey
"urlschemes" : [ "tbopen24545262" ]
}
]
}
调用实例及参数说明(androin ios 调用方式一致)
初始化配置
const PPBC = uni.requireNativePlugin('PP-ALBC');
//以下有值的皆为默认值
PPBC.initOptions({
//淘客信息配置
pid:'',
unionId:'',
subPid:'',
// (注:1、如果走adzoneId的方式分佣打点,需要在extraParams中显式传入taokeAppkey,否则打点失败;
// 2、如果是打开店铺页面(shop),需要在extraParams中显式传入sellerId,否则同步打点转链失败)
adzoneId:'',
taokeAppkey:'',
sellerId:'',
// 自定义参数 trackParams
trackParams:{},
//OpenType(页面打开方式)(Auto和Native)
//Native表示唤端,Auto表示不做设置
openType:'Auto',
//clientType表示唤端类型(taobao和tmall)
//taobao---唤起淘宝客户端;tmall---唤起天猫客户端
clientType:'taobao',
//BACK_URL(返回小把手):唤端返回的scheme(android传入可隐藏"返回小把手")
backUrl:'alisdk://',//(ios无此参数)
//AlibcFailModeType(唤端失败模式(未安装淘宝)) 参数如下
//AlibcNativeFailModeNONE:不做处理;
//AlibcNativeFailModeJumpBROWER:跳转浏览器;
//AlibcNativeFailModeJumpDOWNLOAD:跳转下载页;
//AlibcNativeFailModeJumpH5:应用内webview打开)
failModeType:'AlibcNativeFailModeJumpH5'
}, result => {
console.log(JSON.stringify(result))
});
淘宝客授权
自行拼装地址传入请求地址即可然后按照实例传入 拼装格式:https://oauth.taobao.com/authorize?response_type=token&client_id=25016850&redirect_uri=你的回调地址&state=附加参数&view=wap';
提供的接口代码实例
// 登录
inter('login')
//获取用户信息
inter('getUserInfo')
//我的购物车
inter('myCar')
//跳转商户(shopid)
inter('openShopById',{shopid:'114548164'})
//跳转商品(itemid)
inter('openItemById',{itemid:'563479060793'})
//打开链接(url) 优惠券、淘客授权等,部分页面不支持,请自行尝试
inter('openItemByUrl',{itemurl:'https://s.click.taobao.com/ZgAl20w'})
//淘宝客授权,实例(返回code)
let tkurl='https://oauth.taobao.com/authorize?response_type=code&client_id=23196777&redirect_uri=http://tool.chaozhi.hk/api/authorize.php&state=1024&view=wap';
inter('taokeauth',{authurl:tkurl})
//封装方法
inter(order, param) {
const PPBC = uni.requireNativePlugin('PP-ALBC');
let config = {order: order}
if (typeof param == 'object')
for (let s in param) {
config[s] = param[s]
}
PPBC.show(config, result => {
console.log(JSON.stringify(result))
});
}
参数返回接口
用户信息为例
result={
msg:"获取成功",
code:200,
data:
{
openId:"",
topAccessToken:"",
nick:"",
userid:"",//iOS 无此返回
openSid:"",
topExpireTime:"", //iOS 无此返回
avatarUrl:"",
topAuthCode:""
}
}