iOS开发之AddressBookUI框架详解

简介: iOS开发之AddressBookUI框架详解

一、关于AddressBookUI框架


   AddressbookUI是iOS开发框架中提供的一套通讯录界面组件。其中封装好了一套选择联系人,查看联系人的界面,在需要时开发者可以直接调用。当然对于联系人界面,开发者也可以进行完全的自定义,下面链接博客中介绍了如何使用AddressBook框架操作通讯录与联系人。


https://my.oschina.net/u/2340880/blog/1930414


   AddressBookUI框架主要提供了如下几个类:


ABNewPersonViewController:新建联系人界面视图控制器


ABPeoplePickerNavigationController:从通讯录选择联系人界面视图控制器


ABPersonViewController:联系人详情界面视图控制器


ABUnknownPersonViewController:一个未在当前通讯录中的联系人查看界面,可以添加和编辑


二、ABNewPersonViewController新建联系人界面


   ABNewPersonViewController类的使用非常简单,示例如下:


ABNewPersonViewController *picker = [[ABNewPersonViewController alloc] init];

picker.newPersonViewDelegate = self;

[self presentModalViewController:picker animated:YES];

效果如下图所示:


image.png


ABNewPersonViewController解析如下:


//代理

@property(nonatomic,assign,nullable) id<ABNewPersonViewControllerDelegate> newPersonViewDelegate;

//通讯录实例 只读

@property(nonatomic,readwrite,nullable) ABAddressBookRef addressBook;

//联系人 只读

@property(nonatomic,readwrite,nullable) ABRecordRef displayedPerson;

//联系人组 只读

@property(nonatomic,readwrite,nullable) ABRecordRef parentGroup;

联系人的新建回调可以在代理方法中处理,如下:


@protocol ABNewPersonViewControllerDelegate <NSObject>

//新建联系人完成后的回调

- (void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(nullable ABRecordRef)person;

@end

三、ABPeoplePickerNavigationController选择联系人界面


   ABPeoplePickerNavigationController是用户通讯录界面,开发者在需要用户选择联系人时,可以直接调用这个界面来让用户进行选择,示例如下:


ABPeoplePickerNavigationController *vc = [[ABPeoplePickerNavigationController alloc] init];

vc.peoplePickerDelegate = self;

[self presentViewController:vc animated:YES completion:nil];

效果如下图:


image.png


ABPeoplePickerNavigationController解析如下:


//代理

@property(nonatomic,assign,nullable) id<ABPeoplePickerNavigationControllerDelegate> peoplePickerDelegate;

//需要展示的用户联系人属性字段  数组中为属性的ID 在AddressBook框架介绍的博客中有讲解

@property(nonatomic,copy,nullable) NSArray<NSNumber*> *displayedProperties;

//通讯录实例

@property(nonatomic,readwrite,nullable) ABAddressBookRef addressBook;

//设置一个筛选条件 过滤掉不可显示的联系人

@property(nonatomic,copy,nullable) NSPredicate *predicateForEnablingPerson;

//设置一个筛选条件 过滤掉不可选择的联系人

@property(nonatomic,copy,nullable) NSPredicate *predicateForSelectionOfPerson;

//设置一个筛选条件 过滤掉不可显示的属性

@property(nonatomic,copy,nullable) NSPredicate *predicateForSelectionOfProperty;

用来进行联系人筛选的属性定义如下:


extern NSString * const ABPersonNamePrefixProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonGivenNameProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonMiddleNameProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonFamilyNameProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonNameSuffixProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonPreviousFamilyNameProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonNicknameProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonPhoneticGivenNameProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonPhoneticMiddleNameProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonPhoneticFamilyNameProperty NS_AVAILABLE_IOS(8_0);    

extern NSString * const ABPersonOrganizationNameProperty NS_AVAILABLE_IOS(8_0);        

extern NSString * const ABPersonDepartmentNameProperty NS_AVAILABLE_IOS(8_0);      

extern NSString * const ABPersonJobTitleProperty NS_AVAILABLE_IOS(8_0);          

extern NSString * const ABPersonBirthdayProperty NS_AVAILABLE_IOS(8_0);        

extern NSString * const ABPersonNoteProperty NS_AVAILABLE_IOS(8_0);      

extern NSString * const ABPersonPhoneNumbersProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonEmailAddressesProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonUrlAddressesProperty NS_AVAILABLE_IOS(8_0);  

extern NSString * const ABPersonDatesProperty NS_AVAILABLE_IOS(8_0);    

extern NSString * const ABPersonInstantMessageAddressesProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonRelatedNamesProperty NS_AVAILABLE_IOS(8_0);    

extern NSString * const ABPersonSocialProfilesProperty NS_AVAILABLE_IOS(8_0);

extern NSString * const ABPersonPostalAddressesProperty NS_AVAILABLE_IOS(8_0);

ABPeoplePickerNavigationControllerDelegate中方法解释如下:


//选中联系人进行回调

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker didSelectPerson:(ABRecordRef)person;

//选择联系人属性

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier;

//取消选择

- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker;

四、ABPersonViewController联系人详情界面


   ABPersonViewController是联系人的详情展示界面,简单使用如下:


CFErrorRef error = NULL;

ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, &error);

CFArrayRef peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook);

ABRecordRef person = CFArrayGetValueAtIndex(peopleArray, 0);

ABPersonViewController *viewController = [[ABPersonViewController alloc] init];

viewController.personViewDelegate = self;

viewController.displayedPerson = person;

viewController.allowsActions = NO;

viewController.allowsEditing = YES;

viewController.displayedProperties = @[[NSNumber numberWithInt:kABPersonPhoneProperty]];

[self presentViewController:viewController animated:YES completion:nil];

界面如下:


目录
相关文章
|
移动开发 网络协议 小程序
基于开源IM即时通讯框架MobileIMSDK:RainbowChat-iOS端v10.0版已发布
RainbowChat是一套基于开源IM即时通讯聊天框架 MobileIMSDK 的产品级移动端IM系统。RainbowChat源于真实运营的产品,解决了大量的屏幕适配、细节优化、机器兼容问题。RainbowChat可能是市面上提供im即时通讯聊天源码的,唯一一款同时支持TCP、UDP两种通信协议的IM产品。与姊妹产品RainbowTalk和RainbowChat-Web 技术同源,历经考验。
215 0
基于开源IM即时通讯框架MobileIMSDK:RainbowChat-iOS端v10.0版已发布
|
11月前
|
iOS开发 开发者
uniapp开发ios打包Error code = -5000 Error message: Error: certificate file(p12) import failed!报错问题如何解决
uniapp开发ios打包Error code = -5000 Error message: Error: certificate file(p12) import failed!报错问题如何解决
656 67
uniapp开发ios打包Error code = -5000 Error message: Error: certificate file(p12) import failed!报错问题如何解决
|
10月前
|
JavaScript 搜索推荐 Android开发
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
407 8
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
|
12月前
|
iOS开发 开发者 MacOS
深入探索iOS开发中的SwiftUI框架
【10月更文挑战第21天】 本文将带领读者深入了解Apple最新推出的SwiftUI框架,这一革命性的用户界面构建工具为iOS开发者提供了一种声明式、高效且直观的方式来创建复杂的用户界面。通过分析SwiftUI的核心概念、主要特性以及在实际项目中的应用示例,我们将展示如何利用SwiftUI简化UI代码,提高开发效率,并保持应用程序的高性能和响应性。无论你是iOS开发的新手还是有经验的开发者,本文都将为你提供宝贵的见解和实用的指导。
335 66
|
10月前
|
人工智能 程序员 API
iOS|记一名 iOS 开发新手的前两次 App 审核经历
啥,这玩意也有新手保护期?
293 0
|
12月前
|
存储 监控 API
app开发之安卓Android+苹果ios打包所有权限对应解释列表【长期更新】-以及默认打包自动添加权限列表和简化后的基本打包权限列表以uniapp为例-优雅草央千澈
app开发之安卓Android+苹果ios打包所有权限对应解释列表【长期更新】-以及默认打包自动添加权限列表和简化后的基本打包权限列表以uniapp为例-优雅草央千澈
1191 11
|
开发框架 Android开发 iOS开发
安卓与iOS开发中的跨平台策略:一次编码,多平台部署
在移动应用开发的广阔天地中,安卓和iOS两大阵营各占一方。随着技术的发展,跨平台开发框架应运而生,它们承诺着“一次编码,到处运行”的便捷。本文将深入探讨跨平台开发的现状、挑战以及未来趋势,同时通过代码示例揭示跨平台工具的实际运用。
359 3
|
Java 调度 Android开发
安卓与iOS开发中的线程管理差异解析
在移动应用开发的广阔天地中,安卓和iOS两大平台各自拥有独特的魅力。如同东西方文化的差异,它们在处理多线程任务时也展现出不同的哲学。本文将带你穿梭于这两个平台之间,比较它们在线程管理上的核心理念、实现方式及性能考量,助你成为跨平台的编程高手。
|
存储 前端开发 Swift
探索iOS开发:从新手到专家的旅程
本文将带您领略iOS开发的奇妙之旅,从基础概念的理解到高级技巧的掌握,逐步深入iOS的世界。文章不仅分享技术知识,还鼓励读者在编程之路上保持好奇心和创新精神,实现个人成长与技术突破。
|
存储 iOS开发
iOS开发之EventKit框架的应用(一)
iOS开发之EventKit框架的应用
950 0
iOS开发之EventKit框架的应用(一)