- 近期有新项目需求，要做类似“什么值得买” 类似的跳转手淘详情页。因此要接入阿里百川SDK，在此记录一下接入过程及踩到的坑。
- 阿里百川介绍
阿里百川开放淘系电商能力，帮助APP开发者在各种场景下快速、低成本搭建无线电商导购业务，开发用户消费需求，实现商业变现。
1 注册及创建应用
1.1 注册
直接使用淘宝账号登陆即可
登陆后点击“立即使用”按钮
Snip20180315_3.png
然后根据个人情况填写资料，获取邮箱验证码，注册成功！！！
1.2 创建应用
创建应用，内容根据实际情况填写，Bundel ID 一定要跟项目的Bundel ID匹配上！！！
Snip20180315_5.png
1.3 获得AppKey
创建完成后记录AppKey, 用于稍后SDK集成
Snip20180315_8.png
2 集成SDK
2.1 Cocoapod 集成
在装载pod之前先在终端添加阿里百川官方源
pod repo add AliBCSpecs http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git
pod init，然后在podfile中添加指定源及SDK名， ...pod install 机械化，就不逼逼了....
platform :ios, '8.0'
use_frameworks!
target "nuCangShanBaiCuangTest" do
source 'https://github.com/CocoaPods/Specs.git'
pod 'AFNetworking'
#使用官方提供的源
source 'http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git'
pod 'AlibcTradeSDK'
end
3 配置SDK
3.1 生成安全图片
百川SDK需要在SDK控制台生成一张与项目Bundle ID对应的安全图片拖入项目内作为SDK初始化验证。
Snip20180315_9.png
Snip20180315_11.png
Snip20180315_12.png
然后将图片直接拖入项目的主目录
Snip20180315_14.png
再确认BundleResources中是否有yw_1222.jpg文件
Snip20180315_18.png
3.2 导入依赖库
Targets --> BuildPhases --> linkBinaryWithLibraries 点击+ 添加下图中所有依赖库
Snip20180315_16.png
3.3 设置 URL Types
Targets --> info --> URL Types 添加一条记录, URL Schemes填入tbopen+你的AppKey，如tbopen123456
Snip20180315_20.png
3.4 配置infoPlist
在info.plist中,增加LSApplicationQueriesSchemes字段,并添加tbopen,tmall
Snip20180315_22.png
Snip20180315_23.png
4 初始化SDK
跟其他SDK相似，都在applicationDidFinishLaunching内完成初始化
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 外部使用只能用Release环境
[[AlibcTradeSDK sharedInstance] setEnv:AlibcEnvironmentRelease];
// 百川平台基础SDK初始化，加载并初始化各个业务能力插件
[[AlibcTradeSDK sharedInstance] asyncInitWithSuccess:^{
NSLog(@"初始化成功");
} failure:^(NSError *error) {
NSLog(@"初始化失败");
}];
#warning 初始化时候, 在log中确认 AlibcTradeSDK 资源/环境检查 , 确保配置完成
// 开发阶段打开日志开关，方便排查错误信息
[[AlibcTradeSDK sharedInstance] setDebugLogOpen:YES];
return YES;
}
5 跳转处理
为了正常使用百川内置的应用跳转处理，需要调用百川SDK的方法。建议优先调用百川处理，如果百川已处理，可以直接返回YES；当然，也可以继续处理，比如记录应用跳转来源日志等。
- 以下代码不现实,会导致通过手淘授权登陆,跳回来没反应等问题
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
//3.1.1接口
if (![[AlibcTradeSDK sharedInstance] application:application
openURL:url
sourceApplication:sourceApplication
annotation:annotation]) {
// 处理其他app跳转到自己的app
}
return YES;
}
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
//3.1.1接口
if (![[AlibcTradeSDK sharedInstance] application:application
openURL:url
options:options]) {
//处理其他app跳转到自己的app，如果百川处理过会返回YES
...
}
return YES;
}
6 简单跳转淘宝商品详情页
以下是简单跳转到淘宝商品详情页的测试代码
- (IBAction)testClick:(UIButton *)sender {
AlibcWebViewController *view = [[AlibcWebViewController alloc] init];
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeNative;
//8位数appkey
showParam.backUrl=@"tbopen24822047://";
showParam.isNeedPush=YES;
showParam.nativeFailMode=AlibcNativeFailModeJumpH5;
//项目中page为后台返回的淘宝链接或商品ID
id<AlibcTradePage> page = [AlibcTradePageFactory page:@"taobao://item.taobao.com/item.htm?id=10015759383"];
// show方法为跳转的入口 返回一个integer类型的状态码
// 0: 标识跳转到手淘打开了
// 1: 标识用h5打开
// -1: 标识出错
NSInteger ret =[[AlibcTradeSDK sharedInstance].tradeService show:self webView:view.webView page:page showParams:showParam taoKeParams:nil trackParam:nil tradeProcessSuccessCallback:nil tradeProcessFailedCallback:nil];
NSLog(@"ret-----%ld",ret);
if (ret == 1) {
[self.navigationController pushViewController:view animated:YES];
}
}
基本使用过程介绍就到此为止，希望能帮到大家！
