其实每一个第三方SDK的使用都差不多,看着官方给的开发文档和Demo就能依样画瓢自己做出来。我只是希望帮助一下刚入行不久的新人。
先附上官方文档的地址:芝麻信用iOS开发文档
一、先做一些必备的工作
由于需要导入的Framework比较多,先创建一个Frameworks分组(分组和文件夹可不一样哦)
1. 将资源bundle导入工程
H5Service.bundle
Poseidon.bundle
直接把下载到的这两个文件拖进Frameworks分组中
2. 向工程中导入SDK Framework文件
ZMCreditSDK.framework
ZMDependUponSDK.framework
注意1:如果商户引入支付宝钱包SDK,则不需要再引入ZMBuildUponSDK.framework, 因为这样可以解决相同类库冲突的问题
注意:这两个文件导入之前一定要把他复制到你的项目中去,一般就放项目根目录下就行,跟xcodeproj文件在同一目录下
这里需要选择Add Others,然后会弹出文件选择框,把刚刚复制到项目根目录下的这两个framework选进来就行了
(第三步中的其他依赖库,都是系统的,直接search就行了,第三步就不贴图了)
3. 导入其他依赖库
SDK中依赖了其他基础库来保证正常运行,请添加如下依赖库:
MobileCoreServices.framewrok
CFNetwork.framework
MessageUI.framework
EventKit.framework
AssetsLibrary.framework
CoreMotion.framework
Libz.dylib (Xcode 7 之后是libz.tbd)
SystemConfiguration.framework
CoreTelephony.framework
二、开始使用芝麻信用SDK
自己先把流程走一遍,一切都会变的很容易。(流程见下图)
首先,在AppDelegate里面来注册应用:
[[ALCCreditService sharedService] resgisterApp];
当然,在AppDelegate中和请求芝麻信用分数的Controller中肯定也都需要引入头文件
#import <ZMCreditSDK/ALCreditService.h>
接下来就是正式使用芝麻信用SDK了
①我们把用户的信息(姓名、手机号、身份证号码)通过APP传给公司的服务器(这一步其实基本不属于芝麻信用的使用范畴,现在哪个APP获取不到用户的个人信息?!我们这里其实只传了姓名和身份证号码,其实有了身份证号码,芝麻信用自然就能锁定到那个唯一的人)只要能够获取到姓名和身份证号码,服务器那边就能传给我们一个经过加密的param和一个经过加密的sign
注意2:界面跳转是基于navigationController的push功能,并且使用的是系统的nav bar,如果商户端有对nav bar作自定义,请在调用SDK之前,进行nav bar的调整。
- (void)buttonAction:(UIButton *)button { // ①把用户数据传给服务器,即传入参数(字典) //(如果后台从别的页面已经获取到用户的这些数据了,此处也可以不传参数,这就看你跟后台怎么商量了;IDCardNumber和userName是后台给你的,不是固定死的) NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:@"18位身份证号码", @"IDCardNumber", @"用户姓名", @"userName", nil]; // 创建网络请求管理对象 AFHTTPSessionManager *manager = [AFHTTPSessionManager manager]; // 申明返回的结果是json类型 manager.responseSerializer = [AFJSONResponseSerializer serializer]; // 申明请求的数据是json类型 manager.requestSerializer = [AFJSONRequestSerializer serializer]; // 如果报接受类型不一致请替换一致text/html或别的 manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"text/html", nil]; [manager POST:URL parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData> _Nonnull formData) { } progress:^(NSProgress * _Nonnull uploadProgress) { } success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) { // ②芝麻信用SDK提供的方法,就是这么简单,就一行代码,搞定。(APP ID由公司给你,这个是固定的,写死就行) // ②这里只要传三个参数就行,app id、sign、params,芝麻信用会返回给我们一个字典,在result中 [[ALCreditService sharedService] queryUserAuthReq:@"APP ID" sign:responseObject[@"sign"] params:responseObject[@"param"] extParams:nil selector:@selector(result:) target:self]; } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) { }]; }
②根据SDK给的方法,把第二步获取到的这两个参数和APP ID传进去,这些就被传到芝麻信用的服务器,然后会返回给我们授权token,字段名也是sign和params
// ②芝麻信用SDK提供的方法,就是这么简单,就一行代码,搞定。(APP ID由公司给你,这个是固定的,写死就行) // ②这里只要传三个参数就行,app id、sign、params,芝麻信用会返回给我们一个字典,在result中 [[ALCreditService sharedService] queryUserAuthReq:@"APP ID" sign:responseObject[@"sign"] params:responseObject[@"param"] extParams:nil selector:@selector(result:) target:self];
这一步的代码不用复制,就在第一步的AFN网络请求成功后写这一行代码(上面第一步中有)
③我们再把params提交给公司的服务器,然后服务器就能通过这个token获取到用户的芝麻信用分数,最后把分数返回给我们就好了。(我们这里只传了params就能请求的到芝麻信用分数)
- (void)result:(NSMutableDictionary*)dic{ // ③从第二步中芝麻信用返回给我们的字典就是这的dic,你可以试着打印看一下 // ③把params提交给服务器,服务器就能把芝麻信用分数返回给我们了,这里dict的key:params也是后台给你的,不是固定的。 NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:dic[@"params"], @"params", nil]; // 创建网络请求管理对象 AFHTTPSessionManager *manager = [AFHTTPSessionManager manager]; // 申明返回的结果是json类型 manager.responseSerializer = [AFJSONResponseSerializer serializer]; // 申明请求的数据是json类型 manager.requestSerializer = [AFJSONRequestSerializer serializer]; // 如果报接受类型不一致请替换一致text/html或别的 manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"text/html", nil]; [manager POST:URL parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData> _Nonnull formData) { } progress:^(NSProgress * _Nonnull uploadProgress) { } success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) { // 看看这里是不是打印出了你想要的芝麻分数了呢 NSLog(@"%@", responseObject); } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) { }]; }
注意3:由于sdk里面有用到c编译,请把调用queryUserAuthReq的controller后缀名改成.mm