[置顶] 【重点推荐】iOS开发之芝麻信用SDK的超详细使用教程

转自：http://blog.csdn.net/l2i2j2/article/details/51254816

其实每一个第三方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里面来注册应用：

[objc] view
plain copy

[[ALCreditService sharedService] resgisterApp];  

当然，在AppDelegate中和请求芝麻信用分数的Controller中肯定也都需要引入头文件

[objc] view
plain copy

#import <ZMCreditSDK/ALCreditService.h>  

接下来就是正式使用芝麻信用SDK了

①我们把用户的信息（姓名、手机号、身份证号码）通过APP传给公司的服务器（这一步其实基本不属于芝麻信用的使用范畴，现在哪个APP获取不到用户的个人信息？！我们这里其实只传了姓名和身份证号码，其实有了身份证号码，芝麻信用自然就能锁定到那个唯一的人）只要能够获取到姓名和身份证号码，服务器那边就能传给我们一个经过加密的param和一个经过加密的sign

注意2：界面跳转是基于navigationController的push功能，并且使用的是系统的nav bar，如果商户端有对nav bar作自定义，请在调用SDK之前，进行nav bar的调整。

[objc] view
plain copy

- (void)buttonAction:(UIButton *)button {  

    // ①把用户数据传给服务器，即传入参数（字典）  

    //（如果后台从别的页面已经获取到用户的这些数据了，此处也可以不传参数，这就看你跟后台怎么商量了；IDCardNumber和userName是后台给你的，不是固定死的）  

    NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:@"18位身份证号码", @"IDCardNumber", @"用户姓名", @"userName", nil 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 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

[objc] view
plain copy

// ②芝麻信用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就能请求的到芝麻信用分数）

[objc] view
plain copy

- (void)result:(NSMutableDictionary*)dic{  

    // ③从第二步中芝麻信用返回给我们的字典就是这的dic，你可以试着打印看一下  

    // ③把params提交给服务器，服务器就能把芝麻信用分数返回给我们了，这里dict的key：params也是后台给你的，不是固定的。  

    NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:dic[@"params"], @"params", nil 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 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