前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >iOS开发之Accounts框架详解 原

iOS开发之Accounts框架详解 原

作者头像
珲少
发布2018-08-15 14:41:02
8090
发布2018-08-15 14:41:02
举报
文章被收录于专栏:一“技”之长一“技”之长

iOS开发之Accounts框架详解

    Accounts框架是iOS原生提供的一套账户管理框架,其支持Facebook,新浪微博,腾讯微博,Twitter和领英账户管理的功能。需要注意,在iOS 11及以上系统中,将此功能已经删除,因此Accounts.framework实际上已经没有太大的意义,其只在iOS 11之前的系统上可用。

一、Accounts框架概览

从上图可以看出,Accounts框架中最重要的3个类是ACAccountCredential类、ACAccount类和ACAccountStore类。后面我们着重介绍这3个类。

      首先先来看ACAccountType类,这个类用来定义账户类型,如下:

代码语言:javascript
复制
@interface ACAccountType : NSObject
//类型描述
@property (readonly, nonatomic) NSString *accountTypeDescription;
//标识符
@property (readonly, nonatomic) NSString *identifier;
//此类账户是否已经授权
@property (readonly, nonatomic) BOOL     accessGranted;
@end

需要注意,这个类中的属性都是只读的,这也就是说,开发者不能够直接使用这个类进行对象的构建,需要借助ACAccountStore类来创建ACAccountType实例,后面会介绍。

      ACErrorCode定义了错误码的意义,如下:

代码语言:javascript
复制
typedef enum ACErrorCode {
    ACErrorUnknown = 1,//未知错误
    ACErrorAccountMissingRequiredProperty,  // 缺少必选属性错误
    ACErrorAccountAuthenticationFailed,     // 授权失败
    ACErrorAccountTypeInvalid,              // 授权无效
    ACErrorAccountAlreadyExists,            // 账户已经存在
    ACErrorAccountNotFound,                 // 账户未找到
    ACErrorPermissionDenied,                // 没有权限
    ACErrorAccessInfoInvalid,               // 信息失效
    ACErrorClientPermissionDenied,          // 客户端没有权限
    ACErrorAccessDeniedByProtectionPolicy,  // 无法取得证书
    ACErrorCredentialNotFound,              // 证书未找到
    ACErrorFetchCredentialFailed,           // 请求证书失败
    ACErrorStoreCredentialFailed,           // 存储证书失败
    ACErrorRemoveCredentialFailed,          // 删除证书失败
    ACErrorUpdatingNonexistentAccount,      // 更新失败
    ACErrorInvalidClientBundleID,           // 无效的BundleID
    ACErrorDeniedByPlugin,                  // 权限被阻止
    ACErrorCoreDataSaveFailed,              // 数据库存储失败
    ACErrorFailedSerializingAccountInfo,    //序列化数据失败
    ACErrorInvalidCommand,                  //无效的命令
    ACErrorMissingTransportMessageID,       //缺少安全信息
    ACErrorCredentialItemNotFound,          // 证书缺少字段
    ACErrorCredentialItemNotExpired,        // 证书字段失效
} ACErrorCode;

二、进行账户操作

    在iOS 11以下的系统中,在设置中可以找到账户管理选项,如下图:

点击相应的社交平台,通过账号密码可以进行登录。这里一旦设置登录,那么在第三方应用程序中便可以通过Accounts框架来获取授权信息。

    首先,要使用Accounts框架,需要导入相应头文件,如下:

代码语言:javascript
复制
#import <Accounts/Accounts.h>

但应用程序首次使用用户社交平台的账户时,需要获取用户的授权,示例代码如下:

代码语言:javascript
复制
//创建操作对象
ACAccountStore *accountStore = [[ACAccountStore alloc] init];
//通过操作对象 构建社交平台类型示例  这里采用的新浪微博
ACAccountType *accountType = [accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierSinaWeibo];
//进行用户授权请求
[accountStore requestAccessToAccountsWithType: accountType options:nil completion:^(BOOL granted, NSError *error) {
   if (error) {
        NSLog(@"error = %@", [error localizedDescription]);
   }      
   dispatch_async(dispatch_get_main_queue(), ^{
      if(granted){
         NSLog(@"授权通过了");
    });
}];

获取用户授权界面如下图所示:

一旦用户授权通过,可以使用如下方法获取到用户的社交平台账户信息:

代码语言:javascript
复制
ACAccountStore *accountStore = [[ACAccountStore alloc] init];
ACAccountType *accountType = [accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierSinaWeibo];
NSArray *twitterAccounts = [accountStore accountsWithAccountType:accountType];

Accounts框架支持的社交平台类型ID如下:

代码语言:javascript
复制
NSString * const ACAccountTypeIdentifierTwitter;//Twitter
NSString * const ACAccountTypeIdentifierFacebook;//Facebook
NSString * const ACAccountTypeIdentifierSinaWeibo;//新浪微博
NSString * const ACAccountTypeIdentifierTencentWeibo;//腾讯微博
NSString * const ACAccountTypeIdentifierLinkedIn;//领英

在调用requestAccessToAccountsWithType方法时,可以传入一个字典参数,某些社交平台的授权需要配置一些额外参数,例如:

代码语言:javascript
复制
//facebook相关
NSString * const ACFacebookAppIdKey;//设置appid
NSString * const ACFacebookPermissionsKey;//设置权限key
NSString * const ACFacebookAudienceKey; //权限key
NSString * const ACFacebookAudienceEveryone;//公开权限
NSString * const ACFacebookAudienceFriends;//好友权限
NSString * const ACFacebookAudienceOnlyMe;//私人权限
//领英相关
NSString * const ACLinkedInAppIdKey;//领英appid
NSString * const ACLinkedInPermissionsKey; //设置权限key
//腾讯微博
NSString *const ACTencentWeiboAppIdKey; //设置appid

三、用户信息相关类解析

ACAccount类解析如下:

代码语言:javascript
复制
@interface ACAccount : NSObject
- (instancetype)initWithAccountType:(ACAccountType *)type;//构造方法
@property (readonly, weak, NS_NONATOMIC_IOSONLY) NSString      *identifier;//标识符
@property (strong, NS_NONATOMIC_IOSONLY)   ACAccountType       *accountType;//账户类型
@property (copy, NS_NONATOMIC_IOSONLY)     NSString            *accountDescription;//账户描述
@property (copy, NS_NONATOMIC_IOSONLY)     NSString            *username;//用户名
@property (readonly, NS_NONATOMIC_IOSONLY)  NSString           *userFullName;//完整名称
@property (strong, NS_NONATOMIC_IOSONLY)   ACAccountCredential *credential;//授权凭证
@end

ACAccountCredential类解析如下:

代码语言:javascript
复制
@interface ACAccountCredential : NSObject
//构造方法
- (instancetype)initWithOAuthToken:(NSString *)token tokenSecret:(NSString *)secret;
- (instancetype)initWithOAuth2Token:(NSString *)token 
                       refreshToken:(NSString *)refreshToken
                         expiryDate:(NSDate *)expiryDate;
//token
@property (copy, nonatomic) NSString *oauthToken;
@end

四、ACAccountStore类解析

代码语言:javascript
复制
@interface ACAccountStore : NSObject
//所有账户列表
@property (readonly, weak, NS_NONATOMIC_IOSONLY) NSArray *accounts;
//根据id获取账户
- (ACAccount *)accountWithIdentifier:(NSString *)identifier;
//根据id获取账户类型对象
- (ACAccountType *)accountTypeWithAccountTypeIdentifier:(NSString *)typeIdentifier;
//获取指定类型的所有账户
- (NSArray *)accountsWithAccountType:(ACAccountType *)accountType;
//进行账户存储
- (void)saveAccount:(ACAccount *)account withCompletionHandler:(ACAccountStoreSaveCompletionHandler)completionHandler;
//进行账户使用权限申请
- (void)requestAccessToAccountsWithType:(ACAccountType *)accountType
                  withCompletionHandler:(ACAccountStoreRequestAccessCompletionHandler)handler NS_DEPRECATED(NA, NA, 5_0, 6_0);
- (void)requestAccessToAccountsWithType:(ACAccountType *)accountType
                                options:(NSDictionary *)options
                             completion:(ACAccountStoreRequestAccessCompletionHandler)completion;
//如果账户权限已经过期 调用此方法进行刷新
- (void)renewCredentialsForAccount:(ACAccount *)account completion:(ACAccountStoreCredentialRenewalHandler)completionHandler;
//删除账户
- (void)removeAccount:(ACAccount *)account withCompletionHandler:(ACAccountStoreRemoveCompletionHandler)completionHandler;
@end

千里之遥始于足下,冰冻三尺非一日之寒 ——共勉

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • iOS开发之Accounts框架详解
    • 一、Accounts框架概览
      • 二、进行账户操作
        • 三、用户信息相关类解析
          • 四、ACAccountStore类解析
          相关产品与服务
          云数据库 Redis
          腾讯云数据库 Redis(TencentDB for Redis)是腾讯云打造的兼容 Redis 协议的缓存和存储服务。丰富的数据结构能帮助您完成不同类型的业务场景开发。支持主从热备,提供自动容灾切换、数据备份、故障迁移、实例监控、在线扩容、数据回档等全套的数据库服务。
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档