1、前期准备
(1)创建百川应用。(可参考官方文档)
需注意BundleID要提前注册好,注册应用时要填写正确的BundleID。
(2)下载安全图片。(可参考官方文档)
安全图片是用于app身份识别的,按照最新的官方文档下载V5版安全图片,就不会踩坑。
但要注意的是,下载后的安全图片的名字为yw_1222.jpg,如果直接将安全图片拖入工程中会报 code:10010,身份图片识别错误,导致SDK初始化失败。
正确的做法是将图片重新命名yw_1222_baichuan.jpg,然后再拖入工程中。
(3)开通产品权限。(可参考官方文档)
到控制台 -> 对应的应用 -> 我的产品后台 开通百川电商SDK
2、接入阿里百川电商SDK
(1)创建Swift 工程
需注意的是,电商SDK都是用OC写的,Swift项目中引入OC需要桥接文件,将OC文件的头文件写入到桥接文件中。
创建桥接文件:
在项目中command + n 创建新文件,文件类型选择OC,这样编译器会自动创建桥接文件,点击确定即可。
因为SceneDelegate是iOS13之后出现的,项目不可能只选择支持iOS13,所以干脆直接将SceneDelegate删除掉,SceneDelegate删除网上一查就有,不必多说,这样工程就创建完毕。
(2)项目集成SDK
只记录 Cocoapods 方式集成。
- 添加百川的源
打开终端输入命令:pod repo add AliBCSpecs http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBC - Podfile文件中添加
source 'http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git'
pod 'AlibcTradeSDK','4.0.1.5'
pod 'AliAuthSDK','1.1.0.39-bc'
pod 'mtopSDK','3.0.0.4'
pod 'securityGuard','5.4.173'
pod 'AliLinkPartnerSDK','4.0.0.24'
pod 'BCUserTrack','5.2.0.16-appkeys'
pod 'UTDID','1.1.0.16'
pod 'WindVane','8.5.0.46-bc10'
pod 'AlipaySDK', '2.0.0-bc'
(3)配置工程
-
添加系统库
Build Phases -> Link Binary With Libraries
-
添加编译参数
-ObjC -lstdc++
(4)添加资源文件
添加安全图片
将下载并修改名字的安全图片拖拽到工程中-
添加plist文件 mtopsdk_configuration.plist
-
配置URL Types
URL Schemes 形式为tbopen + appkey
-
配置Info.plist
增加LSApplicationQueriesSchemes字段,并添加tbopen,tmall
配置ATS, 允许HTTP请求.
-
设定Bitcode
在Targets->Build Settings中设置Bitcode为No
3.淘宝授权登陆功能使用
(1)初始化SDK
在桥接文件中添加头文件
#import
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
/**
问题: 初始化失败 code: 10010 安全图片识别失败
下载的安全图片不能直接拖到项目中
需要重新进行命名
*/
//开启日志 排查错误
AlibcTradeSDK.sharedInstance()?.setDebugLogOpen(true)
// AlibcTradeSDK.sharedInstance()?.setIsvVersion("2.2.2")
// AlibcTradeSDK.sharedInstance()?.setIsvAppName("ALBCTest")
AlibcTradeSDK.sharedInstance()?.asyncInit(success: {
print("初始化成功")
}, failure: { (error) in
print(error)
})
return true
}
(2)处理跳转
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
if AlibcTradeSDK.sharedInstance()!.application(app, open: url, options: nil) {
///处理其他App跳回本App
}
return true
}
(3)进行淘宝授权
在桥接文件中添加头文件
#import
#import
if !(ALBBCompatibleSession.sharedInstance()?.isLogin())! {
ALBBSDK.sharedInstance()?.setH5Only(false)
ALBBSDK.sharedInstance()?.auth(self, successCallback: {
print("---------------- 成功了")
let user = ALBBCompatibleSession.sharedInstance()?.getUser()
print(user?.nick! as Any)
}, failureCallback: { (error) in
print("++++++++++++++++ 失败了")
print(error as Any )
})
} else {
print("---------------- 成功了")
let user = ALBBCompatibleSession.sharedInstance()?.getUser()
print(user as Any)
}
官方网址:https://baichuan.taobao.com