百川SDK升级，请先查看百川SDK升级指南，更多问题咨询百川小开 

百川通用问题FAQ

1、新百川SDK进行了哪些升级?

新百川SDK针对用户的安全隐私进行了全面加固，保障了用户使用电商功能服务时隐私的安全性。

 

2 、老百川SDK不升级有影响吗？

为了平滑升级，旧版百川电商SDK（版本号3.x.x.x及以下版本）会保留到2019年9月30日（不含）。

自2019年9月30日起（含），阿里百川电商SDK的旧版本服务将逐步停止。

 

3、升级新版百川SDK，媒体的安全图片需要重新生成吗？

新版百川SDK安全图片不论之前是否是V5版本的安全图片。都需登录百川平台，重新生成V5版本安全

图片，并替换应用內的现有图片。

 

4、原来百川提供强制H5展示功能，为何现在没有了？

通过百川输出阿里系的H5页面，如有外部输出诉求，需经过阿里业务对接，方可对外输出。

如媒体以前有阿里业务同学进行对接，可对其进行反馈，经过业务评估进行对外输出。若无对接同学，则

百川目前提供详情、购物车(电商高级功能)等H5页面应用內打开。后续将开放更多H5页面对外输出。

 

5、用户未安装手淘、用户行为是什么？

媒体可以自定义将H5页面在应用内降级打开，但不建议此操作，原则上淘宝不支持开发者在端内完成H5的完整购物链路，降级H5打开，后续页面链路很可能出现流程错误的情况，导致消费者使用出现问题。
如果引导下载手淘，如果触达消费者多维淘宝新用户，媒体可以自行考虑将为消费者打开：新人福利社 https://mos.m.taobao.com/activity_newer (此页面在套件“淘宝客基础页面包”中)，引导手淘拉新，会有相应的拉新奖励哦！(以实际当月拉新公告为准)https://tbk.bbs.taobao.com/list.html?topicId=0&page=0&size=20&type=1&order=0

设置示例：

iOS

 Android

 

6、新百川电商SDK提供API与以前有什么变化？

使用电商API打开媒体开发页面，仍然保持应用內打开，使用方法是openByUrl。

openByUrl 中的identity作为业务标识，目前支持传入"trade"，后续会有平台申请。

目前开放商品详情（部分场景）及购物车使用百川API，支持在媒体应用內打开，使用方法是

openByBizCode。API 中的 bizCode 目前支持传入 "detail" "cart"，后续会逐步开放其他bizCode。 

 

7、淘宝客私域用户管理能力相关API授权流程说明

一：标准版SDK授权参考以下流程

1）在百川控制台申请“淘宝客基础页面包”套件

2）申请通过后，在确保百川授权成功后，使用百川的openByUrl接口加载私域用户授权URL，具体查看无线端授权规范文档拼接URL（AlibcTrade.openByUrl，请使用最新版本的SDK）

3）回跳url的code，4.0需要从服务端获取，是到媒体自己的服务器，由回跳的媒体服务端自己接收处理。

二：旗舰版SDK授权参考客户端文档，使用Top Native授权

注意：旗舰版（Android：5.0.0.13、iOS：5.0.0.4及以后）不再支持URL方式授权，改为Top Native授权。

 

8. 联盟私域授权页面（Oauth），点击授权无反应

应该是授权URL拼接的问题，建议按照文档的两种拼接方式分别尝试下 https://open.taobao.com/doc.htm?docId=105590&docType=1 ,也可以尝试更换拼接的URI。

 

9. 授权的时候不能跳转手淘，提示或报错“API未授权”

按照正常流程申请AppKey，参考文档媒体接入百川说明-iOS&Android开通电商业务产品权限，电商SDK开通后尝试过段时间再试

 

10. code获取方式

1.标准版SDK中的 bizCode 目前支持传入 "detail" "cart"

2.旗舰版SDK中的code需要在套件平台查看，具体可参考新版百川套件平台使用说明

 

11. 授权时应用图标设置

电商SDK授权应用图标在百川控制台--系统设置--应用设置--应用图标设置中添加，点击保存

联盟二次授权应用图标，需要在淘宝联盟开放平台进入后台，在后台应用管理-应用设置-基本信息，上传应用图标即可

 

 

Android版本百川电商SDK问题： 

1、H5授权登录错误：406 服务竟然出错了

接入SDK最新版本时需在套件平台生成V6版本的安全图片

在以上场景确认无误的情况下，请检查下后台的电商业务产品权限是否开通，开通教程在接入指南文档上有说明，开通后可能会有延迟，请过段时间再试。

 

2、没有手淘，H5加载优惠券页面，显示宝贝不见了

目前该类页面只支持唤端 如果没有安装手淘会跳转引导下载页（设置失败模式为H5会导致错误页面） 后续会逐步支持应用内h5打开 

 

3、初始化失败 AlibcSecurity init ErrorCode = 203

这个错误是因为找不到安全图片的报错，建议按照下面方法检查处理下：

1）打包后报的，shrinkResources false//设置为false，true的话，安全图片可能会被删除；

2）在Android studio中报错，有可能是instant run导致；

3）可能是资源被混淆了；

4）4.0.0.15版本开始，Android安全图片更名为：yw_1222_baichuan.jpg，需开发者手动修改。

 

4、通过电商SDK唤起手淘后，没有显示返回小把手

请认真阅读下4.0开发文档，需要设置backURL

 

5、初始化失败 AlibcSecurity init ErrorCode = 123

1）请先对照下4.X版本开发文档，看依赖是否为最新的
2）Android studio版本在3.5.0以上时可能会出现这个问题，可以把gradle plugin版本降到3.5.0 以下关闭instantrun即可
3）如果保持用3.5.0 android studio运行调试，可以卸载app，然后第一次通过 ./gradlew assembleDebug 打出完整apk，并安装运行，后面再使用android studio IDE中 debug按钮运行。

4）高版本目前只支持V1签名，需要在 build. gradle里指定V1签名

 

6、初始化失败 AlibcSecurity init  ErrorCode = 202

安全图片的问题，请确保获取安全图片的APK包名、签名文件与使用的项目一致

 

7、上传APK失败，怎么解决？

请尝试以下方法：

1）降低APK大小

2）退出重新登录

3）使用空包，包名、签名信息和正式项目保持一致

4）平台目前仅支持RSA算法签名，请检查签名算法

 

8、授权时返回code：111 ,msg： busy control

这个是正常的，建议不要频繁调用登录。

 

9、msg:安全初始化失败 code:1

初始化失败需要提供具体的日志，可以使用"AlibcSecurity"进行过滤。依据日志，对照Android部分的相关建议进行排查解决该问题。

 

10、授权报错：loginService对象为空

 一般是初始化失败导致的，请检查初始化。

 

 

11. 初始化失败，报错AlibcSecurity init  ErrorCode = 212

当前安全图片的版本太低，请升级新版本图片，V6的安全图片可在百川套件平台获取

 

iOS版本百川电商SDK问题： 

1、iOS升级SDK因安全图片问题初始化报错Error Domain=com.baichaun code=100101加载身份图片失败

集成最新版本的SDK按照iOS集成文档集成，安全图片放到工程目录下即可，安全图片已升级，下载下来的安全图片需要改一下名字，yw_1222_baichuan.jpg，如集成'securityGuard','5.5.50'或之后的版本请使用V6的安全图片，在套件平台下载，初始化的方法走成功的回调就算初始化成功

 

2、跳转到手淘点击小把手没有反应

尝试不要设置backURL，URL Types按照文档设置，AppKey为百川对应应用的

 

3、升级SDK之后初始化崩溃

需要按照文档在项目中新建一个mtopsdk_configuration.plist文件，也可以下载demo，将demo中的文件拷贝到自己的项目，具体参考iOS集成文档，demo下载

 

4、pod下的SDK编译不过问题

需要添加编译参数-ObjC -lstdc++

按照文档检查所有库的版本均与文档一致，具体查看iOS集成文档

  

5、授权不能拉起手淘，H5授权提示“缺少协议参数x-sign”

一般是安全图片的问题， 在套件平台重新下载，更换安全图片，如集成'securityGuard','5.5.50'或之后的版本请使用V6的安全图片，按照iOS集成文档将SDK升级至最新版本

 

6、授权的时候不能跳转到手淘，提示“未知APP应用”

按照正常流程申请AppKey，参考文档媒体百川接入说明，电商SDK开通后尝试过段时间再试

 

7、到手淘授权失败，报104的错误

一般是国行手机的用户第一次安装app时因为没有网络权限，初始化SDK失败 需要加上网络权限判断了，保证有网络后再初始化百川SDK，处理应用跳转部分的代码写的有问题，参考iOS开发文档应用跳转部分；

也有可能是手淘没有登录，用户取消授权，或者手淘版本低，建议升级到最新版本的手淘。

 

8、授权的时候不能跳转到手淘授权，提示“亲，你的网络不太顺畅哦”

一般是初始化失败导致的，在确定初始化成功后再完成授权的过程，.最好是在获取到网络权限之后再做初始化

 

9、不能跳转手淘授权，H5授权提示“错误的响应，服务端下发数据为空或数据不是mtop格式的数据”

初始化的问题，电商SDK要先初始化，在保证初始化成功之后再做授权

 

10、iOS跳转到手淘授权失败，报错AlibabaAuthSDK code=1003“（null）”

跳转手淘授权失败，报1003的错误，一般出现在xcode11新创建的项目中，将处理回跳的方法放到sceneDelegate即可，具体参考iOS集成文档XCode 11 ，iOS 13 适配部分

 

11、iOS授权的时候提示“请求失败”

需要配置ATS, 允许HTTP请求. 具体配置可参考iOS集成文档

 

12、iOS用openByURL方式打开应用授权链接出现页面加载不全，或者授权报错client_id is empty

参考iOS集成文档将SDK升级至最新版本，用isLogin判断在登录状态下再调用应用授权，绑定自己webview 的情况，要在客户端自己webview 创建的时候开启这个功能[WVURLProtocolService setSupportWKURLProtocol:YES]; webview 关闭的时候关闭这个功能[WVURLProtocolService setSupportWKURLProtocol:NO];，文档URL调用电商API红色字体部分也有说明

FAQ

关于此文档暂时还没有FAQ