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

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

[[ALCreditService sharedService] resgisterApp];

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

#import 

接下来就是正式使用芝麻信用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  _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  _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