最近在接入阿里百川电商sdk，简直是可以用一把眼泪一把鼻涕来形容这个过程，文档很坑。所以，今天我把我接入阿里百川电商sdk的经验和坑写出来，希望对你们有所帮助。
一、注册阿里巴巴无线平台http://baichuan.taobao.com/?spm=a3c0d.7662649.0.0.4Fp7OJ
1、注册完成以后，点击电商sdk
2、点击立即使用
3、创建应用
4、做好准备工作，可以参考这里：http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.8115090.0.0&treeId=129&articleId=105645&docType=1
二、前期的准备工作做完了，现在才是重点（ios 端的接入）
1、下载最新的sdk：http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.LM0ydN&treeId=129&articleId=106383&docType=1
2、iOS百川组件说明(根据自己的项目需求可以自定义的接入，注：必选的就一定要接入)
打包体积说明
目前我们给的压缩包,是包含全部功能的.使用方可以根据需要裁剪.
必选组件+ 人机识别,打包后实际增加的体积在2m左右. 安全相关的三个包体积占比较大,一半左右.体积上暂时没有改善的空间.
基础安全组件(必选)
安全黑匣子（无线保镖），加密&解密，安全签名，风控相关内容；
SGMain.framework (752K)
SecurityGuardSDK.framework (80K)
ut(必选)
组件可用性统计
UTMini.framework (352K)
UTDID.framework (65K)
登陆授权(必选)
AlibabaAuthExt.framework (25K)
AlibabaAuthSDK.framework (247K)
AlibabaAuthSDK.bundle
基础电商组件(必选)
包含打开detail,淘客分润,jsbridge注入等功能.
AlibcTradeSDK.framework (342K)
NBResource.bundle
mtop(必选)
Mtop，网关（稳定的高性能无线RPC网关，网关本身包含了一套安全体系，包括加密传输、防攻击、防刷、防篡改、过载保护等安全策略，同时针对无线网络的特点，在连通性、网络加速、流量方面进行了针对性优化
OpenMtopExt.framework (76K)
OpenMtopSDK.framework (92K)
登陆绑定(可选)
账号绑定免登功能扩展包，仅限于优酷、微博等合作方；使用前请先和@御道确认是否开通账号绑定免登功能
AlibabaAuthBind.framework
alipay:(可选)
支付宝SDK，手机支付宝支付接口开发包主要用来向第三方应用程序提供便捷、安全以及可靠的支付服务。需要使用支付宝极简支付的isv需要该组件,否则会降级到h5支付,功能不会有影响,但是用户体验会降低
AlipaySDK.bundle
AlipaySDK.framework (163K)
applink(可选)
applink，打通“手机淘宝”与三方app的桥梁，实现手机淘宝与三方app之间的往返跳转,包括登陆时跳手淘授权,用手淘打开商品页,店铺等
不包含该组件,上述功能会降级到h5使用.功能无影响,但是用户体验会降低.
该包体检较小,非必要情况不要裁剪.
TBAppLinkSDK.framework (40K)
人机识别–安全(可选)
安全人机功能，用于红包，优惠券站外发放防刷、链路安全。接入优惠券/红包的业务方需要选择该组件。
(红包目前还没专门的组件,会通过h5方式给出发放通道.h5通道依赖人机识别)
SGSecurityBody.framework (161K)
优惠券(可选)
在第三方内容平台内，用户对透出的淘宝／天猫优惠券可通过一键点击将其加入淘宝／天猫卡券。
AlibcTradeContainer.framework (31K)
AlibcCouponComponent.framework (11K)
一键加购(可选)
在第三方内容平台内，用户对透出的淘宝／天猫商品可通过一键点击将其加入淘宝／天猫购物车。
AlibcTradeContainer.framework (31K)
AlibcAddCartComponent.framework (9K)
AliBCWant.bundle
AliBCWant.framework (58K)
3、把sdk导入工程
4、把下载的yw_1222.png图片文件添加到工程中,缺少该文件会导致AlibcTradeSDK初始化失败（注意：图片不要改名字；注意：图片不要改名字；注意：图片不要改名字；）
5、添加依赖库（缺一不可）
还要添加：CoreMotion.framework
6、添加 -lstdc++ -ObjC （一定要添加，不添加初始化会失败，一定要注意大小写）
7、配置URL Types
URL Scheme为tbopen{AppKey},如tbopen123456
是AppKey, 不是AppID哟！
8、在info.plist中,增加LSApplicationQueriesSchemes字段,并添加tbopen,tmall
9、配置ATS, 允许HTTP请求
三、初始化SDK
在 AppDelegate 中初始化SDK
// 百川平台基础SDK初始化，加载并初始化各个业务能力插件
[[AlibcTradeSDK sharedInstance] asyncInitWithSuccess:^{
} failure:^(NSError *error) {
NSLog(@"Init failed: %@", error.description);
}];
// 开发阶段打开日志开关，方便排查错误信息
//默认调试模式打开日志,release关闭,可以不调用下面的函数
[[AlibcTradeSDK sharedInstance] setDebugLogOpen:YES];
// 配置全局的淘客参数
//如果没有阿里妈妈的淘客账号,setTaokeParams函数需要调用
AlibcTradeTaokeParams *taokeParams = [[AlibcTradeTaokeParams alloc] init];
taokeParams.pid = @"mm_XXXXX"; //mm_XXXXX为你自己申请的阿里妈妈淘客pid，一定得填写，不然无法初始化
[[AlibcTradeSDK sharedInstance] setTaokeParams:taokeParams];
//设置全局的app标识，在电商模块里等同于isv_code
//没有申请过isv_code的接入方,默认不需要调用该函数
// [[AlibcTradeSDK sharedInstance] setISVCode:@"your_isv_code"];
// 设置全局配置，是否强制使用h5
[[AlibcTradeSDK sharedInstance] setIsForceH5:YES];
}
在- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {}实现如下代码：
/* 老接口写法 已弃用，建议使用新接口
if (![[AlibcTradeSDK sharedInstance] handleOpenURL:url]) {
// 处理其他app跳转到自己的app
}
return YES;
*/
//新接口写法
if (![[AlibcTradeSDK sharedInstance] application:application
openURL:url
options:options]) {
//处理其他app跳转到自己的app，如果百川处理过会返回YES
}
return YES;
}
在- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString )sourceApplication annotation:(id)annotation{}方法实现如下代码：
/ 老接口写法 已弃用，建议使用新接口
if (![[AlibcTradeSDK sharedInstance] handleOpenURL:url]) {
// 处理其他app跳转到自己的app
}
return YES;
*/
// 新接口写法
if (![[AlibcTradeSDK sharedInstance] application:application
openURL:url
sourceApplication:sourceApplication
annotation:annotation]) {
// 处理其他app跳转到自己的app
}
return YES;
}
设置接口说明
初始化SDK相关接口
初始化百川电商相关组件，该方法异步执行，使用百川电商相关功能前，必须调用初始化。
/**
- 百川电商SDK初始化【异步】
*/
- (void)asyncInitWithSuccess:(void (^)())onSuccess failure:(void (^)(NSError *error))onFailure;
设置SDK API调用默认方式
/**
- 是否走强制H5的逻辑。NO：按照默认规则策略打开页面；YES：全部页面均为H5打开;
- 注意：初始化完成后调用才能生效
- @param isforceH5 （默认为NO）
*/
- (void) setIsForceH5(BOOL isforceH5)
设置SDK 淘客打点策略
/**
- 设置是否使用同步淘客打点。YES：使用淘客同步打点；NO：关闭同步打点，使用异步打点；
- 注意：初始化完成后调用才能生效；一般不需要特别设置,保持默认值即可
- @param isSyncForTaoke（默认为YES）
*/
- (void)setSyncForTaoke(BOOL isSyncForTaoke)
设置淘客全局参数
/**
- 设置全局淘客参数，方便开发者用同一个淘客参数，不需要在show接口重复传入
- 注意：初始化完成后调用才能生效
- @param taokeParams 淘客参数
*/
- (void)setTaokeParams(AliTradeTaokeParams taokeParams)
设置渠道信息
/**
- 设置渠道信息（如果有渠道专享价，需要设置）
- 注意：初始化完成后调用才能生效
- @param typeName : 渠道类型（默认为：0）
- @param channelName : 渠道名称（默认为：null）
*/
- (void)setChannel(NSString* typeName, NSString* channelName)
设置isv 版本
/**
- 设置isv的版本 ，通常为三方app版本，可以不进行设置；默认1.0.0
- 注意：初始化完成后调用才能生效
- @param isvVersion
*/
- (void)setISVVersion(NSString* isvVersion)
调用说明
SDK从3.0.0版本以后，使用百川电商组件提供的AlibcTradeService可以方便的打开交易环节中的各种页面。使用百川SDK的webview打开page，可以实现淘宝账号免登以及电商交易支付流程
show接口
/**
- 使用isv自己的webview打开page，可以实现淘宝账号免登以及电商交易支付流程
- @param parentController webView所在的view controller.
- @param webView isv自己的webview,请先设置好自己的delegate先调用本接口,否则拦截登陆等逻辑会失效
- @param page 想要打开的page
- @param showParams 打开方式的一些自定义参数
- @param taoKeParams 淘客参数
- @param trackParam 链路跟踪参数
- @param tradeProcessSuccessCallback 交易流程中成功回调(加购成功/发生支付)
- @param tradeProcessFailedCallback 交易流程中退出或者调用发生错误的回调
- @return 0: 标识跳转到手淘打开了
1: 标识用h5打开
-1: 标识出错
*/
- (NSInteger) show:(UIViewController * __nonnull)parentController webView:(nullable UIWebView)webView page:(id<AlibcTradePage> __nonnull)page showParams:(nullable AlibcTradeShowParams)showParams taoKeParams:(nullable AlibcTradeTaokeParams )taoKeParams trackParam:(nullable NSDictionary)trackParam
tradeProcessSuccessCallback:(nullable void(^)(AlibcTradeResult * __nullableresult))onSuccess tradeProcessFailedCallback:(nullable
void(^)(NSError * __nullable error))onFailure;
showParams 参数
拉起手淘
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeNative;
showParam.backUrl=@"tbopenXXXXX://";
showParam.isNeedPush=isNeedPush;
拉起天猫
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeNative;
showParam.backUrl=@"tbopenXXXXX://";
showParam.isNeedPush=isNeedPush;
showParam.linkKey = @"tmall_scheme";
//拉起天猫
page参数
其中page参数用于指定需要打开的页面,可以使用的页面类型如下表,由AlibcTradePageFactory生成：
//打开商品详情页
id<AlibcTradePage> page = [AlibcTradePageFactory itemDetailPage: @”
123456”];
//添加商品到购物车
id<AlibcTradePage> page = [AlibcTradePageFactory addCartPage: @"123456"];
//根据链接打开页面
id<AlibcTradePage> page = [AlibcTradePageFactory page: @"http://h5.m.taobao.com/cm/snap/index.html?id=527140984722"
];
//打开店铺
id<AlibcTradePage> page = [AlibcTradePageFactory shopPage: @”12333333”];
//打开我的订单页
id<AlibcTradePage> page = [AlibcTradePageFactory myOrdersPage: 0 isAllOrder:YES];
//打开我的购物车
id<AlibcTradePage> page = [AlibcTradePageFactory myCartsPage];
//淘客信息
AlibcTradeTaokeParams *taoKeParams=[[AlibcTradeTaokeParams alloc] init];
taoKeParams.pid=nil;
//
//打开方式
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeAuto;
[[AlibcTradeSDK sharedInstance].tradeService show: self.navigationController page:page showParams:showParam taoKeParams: nil trackParam: trackParam tradeProcessSuccessCallback:self.onTradeSuccess tradeProcessFailedCallback:self.onTradeFailure];
使用自己的webview打开商品详情页
id<AlibcTradePage> page = [AlibcTradePageFactory itemDetailPage: @”123456”];
//淘客信息
AlibcTradeTaokeParams taoKeParams=[[AlibcTradeTaokeParams alloc] init];
taoKeParams.pid= nil;
//打开方式
AlibcTradeShowParams showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeAuto;
// YourWebViewController类中,webview的delegate设置不能放在viewdidload里面,必须在init的时候,否则函数调用的时候还是nil
YourTradeWebViewController* myView = [[YourTradeWebViewController alloc] init];
NSInteger ret = [[AlibcTradeSDK sharedInstance].tradeService show: myView webView: myView.webView page:page showParams:showParam taoKeParams: taoKeParams trackParam:nil tradeProcessSuccessCallback:self.onTradeSuccess tradeProcessFailedCallback:self.onTradeFailure];
//返回1,说明h5打开,否则不应该展示页面
if(ret ==1) {
[self.navigationController pushViewController:view animated:YES];
}
到这里基本上可以了，但是你真机发现会报错，原因就是你少设置了一步，光访问当没有告诉：把Enable Bitcode设置为NO
到这里大功告成！
希望能帮到你！
