百川SDK升级指南

更新时间:2020/02/26 访问次数:41039

 

 

升级前期准备

 

1、所有用户都需登录百川平台,重新生成安全图片(V5版本)

 2、使用电商SDK都需开通电商业务产品权限

 

接入SDK

1、集成新SDK依赖

       iOS 电商SDK接入说明

       Android 电商SDK接入说明

 

2、适配新SDK

(1)初始化SDK 与原有百川SDK初始化方法一致

(2)新电商API适配

       a、原有强制应用內H5打开电商页面功能下线。只保留是否强制唤端选项及默认Auto选项。使用电商API打开媒体开发页面,仍然保持应用內打开,使用方法是openByUrl。openByUrl 中的identity作为业务标识,目前支持传入"trade",后续会有平台申请。

 

       b、 打开商品详情(部分场景)及购物车 需要使用openByBizCode方式,API 中的 bizCode 目前支持传入 "detail" "cart",后续会逐步开放其他的bizCode。

 

       c、目前原阿里系页面需要拉回手机淘宝、未安装手机淘宝,默认会跳转到对应的应用下载页。媒体可以根据需要自定义唤起手淘的失败处理方式,目前提供“降级H5应用內打开” 和 “跳转应用下载页”。

              注:降级H5应用內打开,由于安全策略升级,暂不支持完成整个电商交易流程,请悉知。

 

       d、电商API返回值处理方式变化:
           iOS:
               i:openByUrl/openByBizCode API返回值处理,目前只有一种情况需要媒体处理:即当 AlibcTradeShowParams 中 isNeedPush 为 YES时.此时需要媒体根据API返回值为1时 (应用內H5打开),在传入的UINavigationController中push新页面

               ii:tradeProcessSuccessCallback/tradeProcessFailedCallback 交易流程中成功回调(加购成功/失败(使用+[AlibcTradePageFactory addCartPage:]时)/发生支付) 其余打开方式不返回

           Android:
               i: openByUrl/openByBizCode callback (失败时会返回对应错误码,成功回调只会在交易流程,成功时返回)

 

(3)验证百川新SDK

 

       a、完成接入新百川SDK升级工作以后,首先打开百川SDK的日志输出功能,关注百川初始化是否成功或者关注Toast提示。

              iOS :Xcode console中会有对应的初始化日志 及SDK 初始化方法asyncInitWithSuccess:failure: 也会有错误信息返回,有则请对照排查。


              Android:初始化方法asyncInit onFailure 也会返回对应的失败错误信息。

 

       b、首先验证手淘授权登录,如果提示“网络不通畅” ,或如果安装了手淘,没有拉起手淘授权 请重新去官网生成V5版本安全图片或检查初始化是否成功。

 

       c、验证电商页面打开,如果是应用內打开 页面显示错误,此时通过charles或者IDE控制台抓取页面网络请求,如果错误提示“请求API未授权”,首先需要确认是否在百川控制台开通了“百川电商SDK”产品,如果开通了此权限还显示异常页面,则证明此页面API需要单独申请,目前百川内部管控页面输出,未包含在“百川电商SDK”产品内的页面API暂不开放申请,后续会有专门平台进行申请。现有页面功能目前默认拉回手淘完成。

 

       d、如果测试应用內原阿里系页面无法正常工作,如果是阿里业务同学提供的页面地址,则将情况反馈原有对接人.如果是自行收集阿里系页面,需等平台统一评估才能继续使用。

 

附:百川SDK升级FAQ

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部