小马拉大车 AppLinkSDK接入指南(iOS)

拓荒前准备 1.注册App

点我肯求 见效后将取得appkey和appsecret小马拉大车

2.下载SDK

点击下载SDK

SDK里包括含有一个Framework文献

3.搭建拓荒环境 [1] 建立Xcode工程 [2] 将framework拖入神气工程

(如下图所示)

[3] 修改Other Link Flag：增多 -ObjC、-all_load

(如下图所示)

[4] 设定URL Scheme

用于App间的跳转，底下会先容到

在Xcode中注册URL Scheme(如下图所示)(名字自选，“TBAppLinkSDK”仅为示例)

Demo

点我下载

备注

测试需要手淘app集会完成，维持appLink功能的手淘包已于2015.9.10好负责线上。请壮盛手机淘宝app已完成测试。

入手拓荒 入手拓荒时，请去利用市集下载最新版的手淘测试 1.开动化SDK

国内自拍2019在线

(如上图所示)小马拉大车

SDK开动化淡薄在app启动时完成，开动化进程中需要的要道参数包括Appkey、BackURL、pid、type。

appKey: 现在appKey与百川（TOP）的appkey一致

BackURL: 即上头建树的URL Scheme，举例TBAppLinkDemo://

pid&type：淘客参数，用于引流佣金结算，非淘客App请忽略

appScret:加密干系，若接入了百川黑匣子不错忽略此项(具体看底部Q&A)

2. 覆写AppDelegate的handleOpenURL(可选)

(如下图所示)

从授权页面复返后会带来对应的业务参数，在这里经管.

3.建树AppLink-JSSDK维持(可选)

若不需要在WebView中跳转得手淘可跳过

形式1：对于使用UIWebView偏激子类作念为webview拓荒的app，推选使用以下方法。该形式只需要在开动化SDK一同建树下即可。

[TBAppLinkSDK setupUIWebViewForAppLinkJsSDK];

形式2: 若使用我方的UIWebViewDelegate，请使用以下方法

[[TBAppLinkSDK sharedInstance] setWebView:webview withDelegate:delegate];

4.建树跳转失败模式

在iOS客户端上，只须用户未安设手淘时才会出现跳转失败。SDK提供了3种形式来经管跳转失败的情况

TBAppLinkJumpFailedModeDownLoadTaobao:教导用户下载并安设手淘，默许模式. TBAppLinkJumpFailedModeOpenH5:SDK自动将app左迁到Web模式，在3方app里面使用UIWebView掀开相应的页面。 TBAppLinkJumpFailedModeNone:SDK不作念任何经管，SDK使用方可监控jumpDetail:等跳转方法的复返值TBError不为nil，并进行干系经管。

[TBAppLinkSDK sharedInstance].jumpFailedMode = TBAppLinkJumpFailedModeDownLoadTaobao;

5.加密形式(可选)

若有黑匣子，参照底下建树.无黑匣子跳过.

//typedef NSString* (^TBAppLinkCreateSignBlock)(NSString *);
//@property (nonatomic， copy)     TBAppLinkCreateSignBlock       createSignBlock;
[TBAppLinkSDK sharedInstance].createSignBlock = ^(NSString *info){
    OpenSecurityGuardParamContext *request = [OpenSecurityGuardParamContext createParamContextWithAppKey:appKey
                                                                                               paramDict:params
                                                                                             requestType:OPEN_ENUM_SIGN_TOP_OLD];
     return [[[OpenSecurityGuardManager getInstance] getSecureSignatureComp] signRequest:request authCode:kAuthCode];
};

接口诠释

各接口手淘版块维持情况

接口称呼 手淘版块维持情况 跳转到确定 5.4.0及以上 跳转到店铺 5.4.0及以上 跳转到指定URI 5.4.0及以上 授权 5.4.3及以上 跳转到确定

跳转时必须建树itemId.

e，type，backurl等参数非必需，不传则默许为SDK开动化时的参数.

iOS:

TBDetailParam *tbDetailParam = [[TBShopParam alloc] initWithItemId:itemId]; //传入商品的itemId(必选)
tbDetailParam.e = @"xxxx"; //e为淘客参数 (可选)
tbDetailParam.type = @"2"; //type为淘客参数 (可选)
tbDetailParam.extraParam[@"xxxx"] = @"this is extension param" //膨胀参数(可选)
[[TBAppLinkSDK sharedInstance] jumpDetail:tbDetailParam];

跳转到店铺

跳转时必须建树shopId.

e，type，backurl等参数非必需，不传则默许为SDK开动化时的参数.

iOS:

TBShopParam *tbShopParam = [[TBShopParam alloc] initWithShopId:shopId]; //shopId(必选)
tbShopParam.e = @"xxxx"; // e为淘客参数 (可选)
tbShopParam.type = @"2"; // type为淘客参数 (可选)
tbShopParam.extraParam[@"xxxx"] = @"this is extension param" //膨胀参数(可选)
[[TBAppLinkSDK sharedInstance] jumpShop:tbShopParam];

跳转到指定URI

遵守等同于在手机淘宝顶用扫一扫参加.不错参加确定，店铺，会场等.

跳转时必须建树url.

e，type，backurl等参数非必需，不传则默许为SDK开动化时的参数.

iOS:

NSString *url = @"?id=22316128099"; //
TBURIParam *tbUriParam = [[TBURIParam alloc] initWithURI:url]; 
tbUriParam.backURL = @"";
[[TBAppLinkSDK sharedInstance] jumpTBURI:tbUriParam];

授权

跳得手机淘宝进行授权，见效后复返authcode.

iOS:

TBAuthParam *param = [[TBAuthParam alloc] initWithRedirectURI:@""];//其中redirectURI为左迁的H5授权回跳地址(手淘未安设时)，在肯求appkey时可获取.

//版块1.1.1之后将复返authInfo，1.1.1之前复返的mixnick&icon将不再维持
[[TBAppLinkSDK sharedInstance] doAuth:param  Complete:^(NSError *error，NSDictionary *authInfo) {  
                NSString *authcode = [authInfo objectForKey:@"authcode"];
                //do something you want
 }];

拿到authcode去同样token等值的请参考:?spm=0.0.0.0.LF3ZsH&treeId=1&articleId=102635&docType=1

AppLink SDK 版块升级概要

1.0.0 郑再版

1.1.0 适配iOS9 增多bitcode版

1.1.3 doAuth复返的mixNick改为authcode

1.1.4 bugFix:栽培bundleName中语问题

1.1.5 跳过手淘启动闪屏页小马拉大车

FAQ 对于此文档暂时还莫得FAQ