一、初始化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];
二、处理应用跳转
为了正常使用百川内置的应用跳转处理,需要调用百川SDK的方法。建议优先调用百川处理,如果百川已处理,可以直接返回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
}
iOS9+的新系统API
/ 老接口写法 已弃用,建议使用新接口
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)