基础SDK集成与初始化

更新时间:2016/07/11 访问次数:119171

1、集成准备

1、入驻百川,下载SDK,具体流程:点击查看

2、下载示例Demo工程 点击下载,了解SDK集成的具体代码


2、集成

2.1 工程配置

1、Copy控制台下载的SDK包里yw_1222.jpg 图片文件到Bundle Resources里

image
2、在URL Types的URL Schemes里添加填写 tbopen+应用appkey,例如tbopen23015524

image

2.2 引入SDK

1、添加以下基础库(dylib结尾的库xcode更新为.tbd,具体参考Demo工程)
还需要:CoreMotion.framework

image

2、添加所有SDK下载包里的*.framework文件 到Link Libraries

3、Copy所有SDK下载包里*.bundle等资源文件到Bundle Resources

4、设置Link Flags

在Target->Build Setting->Linking->Other Linker Flags中添加-ObjC,-Istdc++选项

image

**********************

3、初始化

从2.0.0版本开始TaeSDK更名为ALBBSDK,老用户的已有代码使用新版SDK需要在头文件导入点做如下修改:

#import <TaeSDK/TaeSDK.h>

改为

#import <ALBBSDK/TaeSDK.h>

2.0.0版本以后新用户导入基础SDK头文件,只需:

#import <ALBBSDK/ALBBSDK.h>

1、在初始化SDK前可以设置一些全局配置:

[[ALBBSDK sharedInstance] setDebugLogOpen:YES];//开发阶段打开日志开关,方便排查错误信息
    [[ALBBSDK sharedInstance] setUseTaobaoNativeDetail:NO];//优先使用手淘APP打开商品详情页面,如果没有安装手机淘宝,SDK会使用H5打开
    [[ALBBSDK sharedInstance] setViewType:ALBB_ITEM_VIEWTYPE_TAOBAO];//使用淘宝H5页面打开商品详情
    [[ALBBSDK sharedInstance] setISVCode:@"my_isv_code"];//设置全局的app标识,在电商模块里等同于isv_code,可以用来跟踪交易订单

2、获取友盟和高德地图SDK的appkey(如果在控制台选择了高德或友盟组件,百川会自动生成对应平台的appkey)

NSString *umengKey=[[ALBBSDK sharedInstance] getUMengAPIKey];//获取百川平台生成的友盟 appkey
    NSString *gaoDeAPIKey=[[ALBBSDK sharedInstance] getGaoDeAPIKey];//获取百川平台生成的高德 appkey

3、SDK初始化,加载各个业务插件SDK

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
    self.window.backgroundColor = [UIColor whiteColor];
    MainViewController *mainViewController = [[MainViewController alloc]init];
    UINavigationController *navController = [[UINavigationController alloc]initWithRootViewController:mainViewController];
    self.window.rootViewController = navController;
    [self.window makeKeyAndVisible];
    
    //百川平台基础SDK初始化,加载并初始化各个业务能力插件
    [[ALBBSDK sharedInstance] setDebugLogOpen:YES];//开发阶段打开日志开关,方便排查错误信息
    [[ALBBSDK sharedInstance] setUseTaobaoNativeDetail:NO];//优先使用手淘APP打开商品详情页面,如果没有安装手机淘宝,SDK会使用H5打开
    [[ALBBSDK sharedInstance] setViewType:ALBB_ITEM_VIEWTYPE_TAOBAO];//使用淘宝H5页面打开商品详情
    [[ALBBSDK sharedInstance] setISVCode:@"my_isv_code"];//设置全局的app标识,在电商模块里等同于isv_code
     
    NSString *umengKey=[[ALBBSDK sharedInstance] getUMengAPIKey];//获取百川平台生成的友盟 appkey
    NSString *gaoDeAPIKey=[[ALBBSDK sharedInstance] getGaoDeAPIKey];//获取百川平台生成的高德 appkey
    
    //基础SDK初始化
    [[ALBBSDK sharedInstance] asyncInit:^{
        NSLog(@"init success");
    } failure:^(NSError *error) {
        NSLog(@"init failure, %@", error);
    }];
  
    return YES;
}

4、监听处理其他app的跳转,注意此处必须调用,建议用户优先调用百川的处理,如果百川处理过,可以直接return YES,当然也可以继续处理,比如记录app跳转来源日志

-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    
    BOOL isHandledByALBBSDK=[[ALBBSDK sharedInstance] handleOpenURL:url];//处理其他app跳转到自己的app,如果百川处理过会返回YES
    
    return YES;
    
}

也可以实现IOS9的新系统API

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
    
    BOOL isHandledByALBBSDK=[[ALBBSDK sharedInstance] handleOpenURL:url];//处理其他app跳转到自己的app,如果百川处理过会返回YES
    
    return YES;

}

FAQ

关于此文档暂时还没有FAQ
返回
顶部