iOS集成阿里百川SDK跳转手淘及天猫

• 近期有新项目需求，要做类似“什么值得买” 类似的跳转手淘详情页。因此要接入阿里百川SDK，在此记录一下接入过程及踩到的坑。
• 阿里百川介绍
  阿里百川开放淘系电商能力，帮助APP开发者在各种场景下快速、低成本搭建无线电商导购业务，开发用户消费需求，实现商业变现。

1 注册及创建应用

登陆百川电商SDK官网

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

获得一张以yw_1222命名的jpg格式图片

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

然后再配置ATS, 允许HTTP请求

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 *)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 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];
    }
    
}

基本使用过程介绍就到此为止，希望能帮到大家！