如何自訂iOS通訊錄_IOS

來源:互聯網
上載者:User

蘋果給使用者提供了自己的通訊錄,但是根據業務的需求,需要自訂通訊錄,我們就需要根據業務需求來自訂。
首先我們需要知道蘋果的提供的一些Foundation、UIKit架構,瞭解其中的一些特性,可以開啟手機查看蘋果系統提供的原生的通訊錄,可以看到:

1.搜尋方塊
2.右側搜尋條
3.連絡人分組
4.新增連絡人...
5.擷取連絡人頭像及連絡方式

根據需求,可以總結出自訂通訊錄需要做的一些功能,一項大的功能可以差分成一些小的功能,然後一個一個實現,將複雜的問題差分成小問題解決。

1.自訂搜尋方塊
2.擷取首字母
3.許可權判斷
4.排序
5.自訂搜尋
6.自訂連絡人介面
(考慮多值的情況,擷取通訊錄頭像)

簡答介紹下排序:

IOS項目中會用到對通訊錄的連絡人或是會員按姓名為關鍵字排序,因為NSArray並不直接支援對漢字的排序,這就要通過將漢字轉換成拼音完成按A~Z的排序,這看起來是個頭疼的問題,因為牽扯到漢字轉為拼音,擷取漢字的首字的首字母,如將“王”變成“W”。

函數原理是:我們知道,在Objective C語言中,字串是以unicode進行編碼的。在unicode字元集中,漢字的編碼範圍為4E00 到 9FA5 之間(即從第19968開始的20902個字元是中文簡體字元)。我們把這些字元的拼音首字母按照順序都存放在一個char數組中。當我們尋找一個漢字的拼音首字母時,只需把這個漢字的unicode碼(即char強制轉換為int)減去19968,然後用這個數字作為索引去找char數組中存放的字母即可。
給出項目的源碼,注釋很清楚。代碼如:
RYAddressBook.h

#import <Foundation/Foundation.h> #import "RYPersonInfo.h"  typedef void (^AddressBookBlock) (NSArray *personInfos);  @interface RYAddressBook : NSObject  /**  * 將數字轉化為字母 0~26 1~25=a~z 26=#  */ NSString* SpellFromIndex(int index);  /**  * 擷取索引  */ int Index(NSString *firstSpell); /**  * 擷取使用者所有通訊錄資訊  *  * @return 所有通訊錄資料資訊數組  */ + (void)getPersonInfo:(AddressBookBlock)addressBookBlock;  /**  * 根據關鍵字匹配所有使用者資訊  *  * @param keyWord 匹配關鍵字  *  * @return 匹配到的通訊錄資料資訊數組  */ + (void)searchPersonInfo:(NSString *)keyWord addressBookBlock:(AddressBookBlock)addressBookBlock;  /**  * 根據姓名進行數組的重排序  *  * @param personInfos 擷取的通訊錄資料資訊數組  */ + (NSArray *)sortPersonInfos:(NSArray *)personInfos;  @end 

RYAddressBook.m

#import "RYAddressBook.h"  @interface RYAddressBook ()  @property (nonatomic, copy) AddressBookBlock addressBookBlock;  @end  @implementation RYAddressBook  NSString* SpellFromIndex(int index) {  if (index == 26)  return @"#";  else  return [NSString stringWithFormat:@"%c", [@"A" characterAtIndex:0]+index]; }  int Index(NSString *firstSpell) {  int i = [firstSpell characterAtIndex:0] - [@"a" characterAtIndex:0];   if ([firstSpell isEqualToString:@"#"] || i < 0 || i > 26) {  return 26;  }   return [firstSpell characterAtIndex:0] - [@"a" characterAtIndex:0]; }  /**  * 擷取使用者所有通訊錄資訊  */ + (void)getPersonInfo:(AddressBookBlock)addressBookBlock {  [[self alloc] getPersonInfo:addressBookBlock]; }  /**  * 根據關鍵字匹配所有使用者資訊  */ + (void)searchPersonInfo:(NSString *)keyWord addressBookBlock:(AddressBookBlock)addressBookBlock {  [[self alloc] searchPersonInfo:keyWord addressBookBlock:addressBookBlock]; }  /**  * 根據姓名進行數組的重排序  */ + (NSArray *)sortPersonInfos:(NSArray *)personInfos {  return [[self alloc] sortPersonInfos:personInfos]; }  - (void)getPersonInfo:(AddressBookBlock)addressBookBlock {  self.addressBookBlock = addressBookBlock;  [self searchPersonInfo:@""]; }  - (void)searchPersonInfo:(NSString *)keyWord addressBookBlock:(AddressBookBlock)addressBookBlock {  self.addressBookBlock = addressBookBlock;  [self searchPersonInfo:keyWord]; }  - (NSArray *)sortPersonInfos:(NSArray *)personInfos {  if (![personInfos isKindOfClass:[NSArray class]]) {  return nil;  }   NSMutableArray *arr = [NSMutableArray array];   for (int i = 0; i < 27; i++) {  [arr addObject:[NSMutableArray array]];  }   for (NSObject *obj in personInfos) {    if (![obj isKindOfClass:[RYPersonInfo class]]) {   continue;  }    RYPersonInfo *personInfo = (RYPersonInfo *)obj;    NSMutableArray *subArr = [arr objectAtIndex:Index(personInfo.firstSpell)];  [subArr addObject:personInfo];  }   return arr; }  /**  * 根據關鍵字查詢通訊錄資訊  */ - (void)searchPersonInfo:(NSString *)keyWord {  CFErrorRef error = NULL;  ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, &error);   // 開始查詢通訊錄  ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {    if (granted) {   [self filterContentForSearchText:keyWord];  }  }); }  /**  * 開始匹配通訊錄資訊  */ - (void)filterContentForSearchText:(NSString*)searchText {  //如果沒有授權則退出  if (ABAddressBookGetAuthorizationStatus() != kABAuthorizationStatusAuthorized) {  return;  }   NSArray *blockArray = [NSArray array];   CFErrorRef error = NULL;  ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, &error);   if([searchText length]==0)  {  //查詢所有  blockArray = (__bridge NSArray *)ABAddressBookCopyArrayOfAllPeople(addressBook);    } else {    //條件查詢  CFStringRef cfSearchText = (CFStringRef)CFBridgingRetain(searchText);  blockArray = CFBridgingRelease(ABAddressBookCopyPeopleWithName(addressBook, cfSearchText));    CFRelease(cfSearchText);  }   // 類型轉換  blockArray = transformElements(blockArray);   // 返回BlockArray  self.addressBookBlock(blockArray); }  /**  * 將所有元素轉化為JXPersonInfo類型數組  */ NSArray* transformElements(NSArray* arr) {  NSMutableArray *rtnArray = [NSMutableArray array];  for (int i = 0; i < arr.count; i++) {  ABRecordRef recordRef = CFBridgingRetain([arr objectAtIndex:i]);  RYPersonInfo *personInfo = [RYPersonInfo personInfoWithABRecordRef:recordRef];    [rtnArray addObject:personInfo];  }  return rtnArray; } @end 

RYPersonInfo.h

#import <Foundation/Foundation.h> #import <AddressBook/AddressBook.h>  @interface RYPersonInfo : NSObject  /**  * 單值資訊  */ #define PROPERTY_STR_READONLY(name) @property (nonatomic, copy) NSString *name; // 姓 PROPERTY_STR_READONLY(firstName) // 名 PROPERTY_STR_READONLY(lastName) // 中間名 PROPERTY_STR_READONLY(middlename) // 全名 PROPERTY_STR_READONLY(fullName) // 搜尋索引 PROPERTY_STR_READONLY(firstSpell) // 首碼 PROPERTY_STR_READONLY(prefix) // 尾碼 PROPERTY_STR_READONLY(suffix) // 暱稱 PROPERTY_STR_READONLY(nickname) // 姓_音標 PROPERTY_STR_READONLY(firstnamePhonetic) // 名_音標 PROPERTY_STR_READONLY(lastnamePhonetic) // 中間名_音標 PROPERTY_STR_READONLY(middlenamePhonetic) // 公司 PROPERTY_STR_READONLY(organization) // 工作 PROPERTY_STR_READONLY(jobtitle) // 部門 PROPERTY_STR_READONLY(department) // 生日 PROPERTY_STR_READONLY(birthday) // 備忘錄 PROPERTY_STR_READONLY(note) // 第一次建立使用者資訊的時間 PROPERTY_STR_READONLY(firstknow) // 最後一次更改使用者資訊的時間 PROPERTY_STR_READONLY(lastknow) // 名片類型(company/person) PROPERTY_STR_READONLY(kind)  // 多值資訊 #define PROPERTY_ARR_READONLY(name) @property (nonatomic, strong) NSArray *name; // 郵箱 PROPERTY_ARR_READONLY(email) // 地址 PROPERTY_ARR_READONLY(address) // 日期 PROPERTY_ARR_READONLY(dates) // iMessage PROPERTY_ARR_READONLY(iMessage) // 電話號碼 PROPERTY_ARR_READONLY(phone) // URL連結 PROPERTY_ARR_READONLY(url)  #define PROPERTY_IMG_READONLY(name) @property (nonatomic, strong) UIImage *name; // 圖片 //PROPERTY_IMG_READONLY(image) /**  * 初始化方法  *  * @param ref 連絡人屬性  *  * @return 執行個體對象  */ - (id)initWithABRecordRef:(ABRecordRef)ref;  /**  * 初始化類方法  *  * @param ref 連絡人屬性  *  * @return 執行個體對象  */ + (id)personInfoWithABRecordRef:(ABRecordRef)ref;  @end 

RYPersonInfo.m

#import "RYPersonInfo.h"  #define nullStrToEmpty(str) \ [str rangeOfString:@"null"].location==0? @"" : str  /**  * 單值資訊  */ #define GET_PROPERTY_METHOD(property, property_key) \ - (NSString *)property {\ return (NSString *)CFBridgingRelease(ABRecordCopyValue(_recordRef, property_key));\ }  /**  * 多值資訊  */ #define DICT_ADD_STR_FOR_KEY(dict, str, key) \ if (str) {\ [dict setObject:str forKey:key];\ } #define GET_PROPERTY_SIGLE_VALUE_METHOD(property, property_key)\ - (NSArray *)property\ {\ NSMutableArray *rtnArray = [NSMutableArray array];\ \ ABMultiValueRef ref = ABRecordCopyValue(_recordRef, property_key);\ long count = ABMultiValueGetCount(ref);\ for (int i = 0; i < count; i++)\ {\ NSString* label = (__bridge NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(ref, i));\ NSString* content = (__bridge NSString*)ABMultiValueCopyValueAtIndex(ref, i);\ NSMutableDictionary *dict = [NSMutableDictionary dictionary];\ DICT_ADD_STR_FOR_KEY(dict, content, label);\ \ [rtnArray addObject:dict];\ }\ return rtnArray;\ }  @interface RYPersonInfo ()  @property (nonatomic , assign)ABRecordRef recordRef;  @end  @implementation RYPersonInfo  - (id)initWithABRecordRef:(ABRecordRef)ref {  if (self = [super init]) {  _recordRef = ref;  }  return self; }  + (id)personInfoWithABRecordRef:(ABRecordRef)ref {  return [[[self class] alloc] initWithABRecordRef:ref]; }  GET_PROPERTY_METHOD( firstName , kABPersonFirstNameProperty); GET_PROPERTY_METHOD( lastName , kABPersonLastNameProperty); GET_PROPERTY_METHOD( middlename , kABPersonMiddleNameProperty); GET_PROPERTY_METHOD( prefix , kABPersonPrefixProperty); GET_PROPERTY_METHOD( suffix , kABPersonSuffixProperty); GET_PROPERTY_METHOD( nickname , kABPersonNicknameProperty); GET_PROPERTY_METHOD( organization , kABPersonOrganizationProperty); GET_PROPERTY_METHOD( jobtitle , kABPersonJobTitleProperty); GET_PROPERTY_METHOD( department , kABPersonDepartmentProperty); GET_PROPERTY_METHOD( birthday , kABPersonBirthdayProperty); GET_PROPERTY_METHOD( note  , kABPersonNoteProperty); GET_PROPERTY_METHOD( firstknow , kABPersonCreationDateProperty); GET_PROPERTY_METHOD( lastknow , kABPersonModificationDateProperty); GET_PROPERTY_METHOD( firstnamePhonetic , kABPersonFirstNamePhoneticProperty); GET_PROPERTY_METHOD( lastnamePhonetic , kABPersonLastNamePhoneticProperty); GET_PROPERTY_METHOD( middlenamePhonetic, kABPersonMiddleNamePhoneticProperty);  GET_PROPERTY_SIGLE_VALUE_METHOD(email, kABPersonEmailProperty) GET_PROPERTY_SIGLE_VALUE_METHOD(dates, kABPersonDateProperty) GET_PROPERTY_SIGLE_VALUE_METHOD(url , kABPersonURLProperty) GET_PROPERTY_SIGLE_VALUE_METHOD(phone, kABPersonPhoneProperty)  - (NSString *)kind {  NSString *rtnStr = nil;  CFNumberRef recordType = ABRecordCopyValue(_recordRef, kABPersonKindProperty);  if (recordType == kABPersonKindOrganization) {  rtnStr = @"company";  } else {  rtnStr = @"person";  }  return rtnStr; }  - (NSArray *)iMessage {  NSMutableArray *rtnArray = [NSMutableArray array];   ABMultiValueRef instantMessage = ABRecordCopyValue(_recordRef, kABPersonInstantMessageProperty);  for (int i = 1; i < ABMultiValueGetCount(instantMessage); i++)  {  NSString* label = (__bridge NSString*)ABMultiValueCopyLabelAtIndex(instantMessage, i);  NSDictionary* content =(__bridge NSDictionary*) ABMultiValueCopyValueAtIndex(instantMessage, i);    NSMutableDictionary *imessageInfoDict = [NSMutableDictionary dictionary];  NSString* username = [content valueForKey:(NSString *)kABPersonInstantMessageUsernameKey];  NSString* service = [content valueForKey:(NSString *)kABPersonInstantMessageServiceKey];  DICT_ADD_STR_FOR_KEY(imessageInfoDict, username, @"username");  DICT_ADD_STR_FOR_KEY(imessageInfoDict, service, @"service");    NSDictionary *imessageDict = @{label: imessageInfoDict};  [rtnArray addObject:imessageDict];  }  return rtnArray; }  -(NSArray *)address {  NSMutableArray *rtnArray = [NSMutableArray array];   ABMultiValueRef address = ABRecordCopyValue(_recordRef, kABPersonAddressProperty);  long count = ABMultiValueGetCount(address);  for(int i = 0; i < count; i++)  {  NSString* addressLabel = (__bridge NSString*)ABMultiValueCopyLabelAtIndex(address, i);  NSDictionary* personaddress =(__bridge NSDictionary*) ABMultiValueCopyValueAtIndex(address, i);    NSMutableDictionary *addressInfoDict = [NSMutableDictionary dictionary];  NSString* country = [personaddress valueForKey:(NSString *)kABPersonAddressCountryKey];  NSString* city = [personaddress valueForKey:(NSString *)kABPersonAddressCityKey];  NSString* state = [personaddress valueForKey:(NSString *)kABPersonAddressStateKey];  NSString* street = [personaddress valueForKey:(NSString *)kABPersonAddressStreetKey];  NSString* zip = [personaddress valueForKey:(NSString *)kABPersonAddressZIPKey];  NSString* coutntrycode = [personaddress valueForKey:(NSString *)kABPersonAddressCountryCodeKey];  DICT_ADD_STR_FOR_KEY(addressInfoDict, country, @"country");  DICT_ADD_STR_FOR_KEY(addressInfoDict, city,  @"city");  DICT_ADD_STR_FOR_KEY(addressInfoDict, state, @"state");  DICT_ADD_STR_FOR_KEY(addressInfoDict, street, @"street");  DICT_ADD_STR_FOR_KEY(addressInfoDict, zip,  @"zip");  DICT_ADD_STR_FOR_KEY(addressInfoDict, coutntrycode, @"coutntrycode");    NSDictionary *addressDict = @{addressLabel: addressInfoDict};  [rtnArray addObject:addressDict];  }  return rtnArray; }  //- (UIImage *)image //{ // NSData *data = (__bridge NSData*)ABPersonCopyImageData(_recordRef); // return [UIImage imageWithData:data]; //}  #pragma mark - #pragma mark - CustomProperty /**  * 全名  */ - (NSString *)fullName {  return [NSString stringWithFormat:@"%@%@%@",   nullStrToEmpty(self.lastName),   nullStrToEmpty(self.middlename),   nullStrToEmpty(self.firstName)]; } /**  * 首字母  */ - (NSString *)firstSpell {  return getFirstSpell(self.fullName); }  /**  * 輸出模型所有資訊  */ - (NSString *)description {  return [NSString stringWithFormat:@"%@ -- InfoPacket",   self.fullName]; }  /**  * 擷取首字母  */ NSString* getFirstSpell(NSString *fullName) {  NSMutableString *ms = [[NSMutableString alloc] initWithString:fullName];  CFStringTransform((__bridge CFMutableStringRef)ms, 0, kCFStringTransformMandarinLatin, NO);  CFStringTransform((__bridge CFMutableStringRef)ms, 0, kCFStringTransformStripDiacritics, NO);   if (fullName.length > 0)  return [[ms substringWithRange:NSMakeRange(0, 1)] lowercaseString];  else  return @"#"; }  @end 

以上就是本文的全部內容,希望對大家的學習有所協助,也希望大家多多支援雲棲社區。

相關文章

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.