电商服务
百川SDK-iOS接入文档（4.0.0.2）
AlibcTradeSDK 4.0.0.2 iOS 接入说明
接入SDK前, 请先阅读接入准备
新用户:
- 需要参考《媒体接入百川说明-iOS&Android》获取安全图片yw_1222.jpg
老用户:
- 需要参考《媒体接入百川说明-iOS&Android》 重新 获取安全图片yw_1222.jpg, 安全图片已经升级
注意需要仔细阅读下面工程配置，与原有配置有所区别的地方
1. 集成SDK
方式一: Cocoapod方式引入百川SDK
- 请先添加百川的源
pod repo add AliBCSpecs http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git
- 然后在你工程的Podfile添加(具体版本以百川开发者网站为准)
source 'http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git'
pod 'AlibcTradeSDK','4.0.0.2'
pod 'AliAuthSDK','2.0.0.3'
pod 'mtopSDK','3.0.0.4'
pod 'securityGuard','5.4.173'
pod 'AliLinkPartnerSDK','2.0.0.0'
pod 'BCUserTrack','5.2.0.1-appkeys'
pod 'UTDID','1.1.0.16'
// 可选
pod 'AlipaySDK', '2.0.0-bc'
方式二: 非Cocoapod方式引入百川SDK
添加系统库和资源文件
2、配置百川宿主工程
添加系统库
添加编译参数
- -lstdc++
- -ObjC
如图，留意大小写
添加资源文件
- 把下载的yw_1222.png图片文件添加到工程中,缺少该文件会导致AlibcTradeSDK初始化失败
从老的onesdk或者电商sdk3.0升级上来的用户,都需要重新申请安全图片.. 否则会导致网络不通 - 把
- NBResource.bundle
- AlipaySDK.bundle
- AlibabaAuthSDK.bundle
- SmartLink.bundle
添加到工程中
添加plist 文件: mtopsdk_configuration.plist
内容如下：
配置URL Types
URL Scheme为tbopen{AppKey},如tbopen123456
是AppKey, 不是AppID哟！
配置info.plist
- 在info.plist中,增加LSApplicationQueriesSchemes字段,并添加tbopen,tmall
- 配置ATS, 允许HTTP请求.
3.1.1.14 版本开始, 百川已经适配HTTPS, 无需配置允许HTTP访问
设定Bitcode
在Targets->Build Settings中设置Bitcode为No
3. iOS 百川SDK 基础功能使用说明
1、百川SDK初始化
在 AppDelegate 中初始化SDK，引入
#import <AlibcTradeSDK/AlibcTradeSDK.h>
2、处理应用间跳转
为了正常使用百川内置的应用跳转处理，需要调用百川SDK的handleOpenURL:方法。建议优先调用百川处理，如果百川已处理，可以直接返回YES；当然，也可以继续处理，比如记录应用跳转来源日志等。
以上代码不实现,会导致通过手淘授权登陆, 依旧没有登录态等问题
3、调用淘宝授权登录
4、电商相关API使用
页面打开参数组装
淘客参数组装
（注：1、如果走adzoneId的方式分佣打点，需要在extraParams中显式传入taokeAppkey，否则打点失败；2、如果是打开店铺页面(shop)，需要在extraParams中显式传入sellerId，否则同步打点转链失败3、如果adzoneId存在的话 pid参数会失效）
链路跟踪参数
URL 方式调用电商API
openByUrl/openByBizCode API返回值处理，目前只有一种情况需要媒体处理：即当AlibcTradeShowParams 中 isNeedPush 为 YES时.此时需要媒体根据API返回值为1时 （应用內H5打开），在传入的UINavigationController中push新页面
code 方式调用API
