vcf 是通訊錄常見的匯出格式,全名為 vCard。若要把 iPhone 通訊錄裡的資料轉成 vcf,最簡單的方式是透過 iCloud 網頁版匯出;但如果你想在 App 內用程式碼完成,也完全可以——先讀出通訊錄資料,再逐筆組裝成 vCard 字串即可。
-(NSString *)generateVCardStringWithContacts:(CFArrayRef)contacts {
NSInteger counter = 0;
NSString *vcard = @"";
for (CFIndex i = 0; i < CFArrayGetCount(contacts); i++) {
ABRecordRef person = CFArrayGetValueAtIndex(contacts, i);
NSString *firstName = (NSString *)ABRecordCopyValue(person, kABPersonFirstNameProperty);
firstName = (firstName ? firstName : @"");
NSString *lastName = (NSString *)ABRecordCopyValue(person, kABPersonLastNameProperty);
lastName = (lastName ? lastName : @"");
NSString *middleName = (NSString *)ABRecordCopyValue(person, kABPersonMiddleNameProperty);
NSString *prefix = (NSString *)ABRecordCopyValue(person, kABPersonPrefixProperty);
NSString *suffix = (NSString *)ABRecordCopyValue(person, kABPersonSuffixProperty);
NSString *nickName = (NSString *)ABRecordCopyValue(person, kABPersonNicknameProperty);
NSString *firstNamePhonetic = (NSString *)ABRecordCopyValue(person, kABPersonFirstNamePhoneticProperty);
NSString *lastNamePhonetic = (NSString *)ABRecordCopyValue(person, kABPersonLastNamePhoneticProperty);
NSString *organization = (NSString *)ABRecordCopyValue(person, kABPersonOrganizationProperty);
NSString *jobTitle = (NSString *)ABRecordCopyValue(person, kABPersonJobTitleProperty);
NSString *department = (NSString *)ABRecordCopyValue(person, kABPersonDepartmentProperty);
NSString *compositeName = [NSString stringWithFormat:@"%@%@", firstName, lastName];
if (i > 0) {
vcard = [vcard stringByAppendingFormat:@"\n"];
}
vcard = [vcard stringByAppendingFormat:@"BEGIN:VCARD\nVERSION:3.0\nN:%@;%@;%@;%@;%@\n",
firstName, lastName, middleName, prefix, suffix];
vcard = [vcard stringByAppendingFormat:@"FN:%@\n", compositeName];
if (nickName)
vcard = [vcard stringByAppendingFormat:@"NICKNAME:%@\n", nickName];
if (firstNamePhonetic)
vcard = [vcard stringByAppendingFormat:@"X-PHONETIC-FIRST-NAME:%@\n", firstNamePhonetic];
if (lastNamePhonetic)
vcard = [vcard stringByAppendingFormat:@"X-PHONETIC-LAST-NAME:%@\n", lastNamePhonetic];
// 工作資訊
if (organization)
vcard = [vcard stringByAppendingFormat:@"ORG:%@;%@\n",
(organization ? organization : @""), (department ? department : "")];
if (jobTitle)
vcard = [vcard stringByAppendingFormat:@"TITLE:%@\n", jobTitle];
// 電子郵件
ABMultiValueRef emails = ABRecordCopyValue(person, kABPersonEmailProperty);
if (emails) {
for (int k = 0; k < ABMultiValueGetCount(emails); k++) {
NSString *label = (NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(emails, k));
NSString *email = (NSString *)ABMultiValueCopyValueAtIndex(emails, k);
NSString *labelLower = [label lowercaseString];
if ([labelLower isEqualToString:@"home"])
vcard = [vcard stringByAppendingFormat:@"EMAIL;type=INTERNET;type=HOME:%@\n", email];
else if ([labelLower isEqualToString:@"work"])
vcard = [vcard stringByAppendingFormat:@"EMAIL;type=INTERNET;type=WORK:%@\n", email];
else {
// 類型無法解析時,用 itemN 搭配 X-ABLabel 標記
counter++;
vcard = [vcard stringByAppendingFormat:@"item%d.EMAIL;type=INTERNET:%@\nitem%d.X-ABLabel:%@\n",
counter, email, counter, label];
}
}
}
// 電話
ABMultiValueRef phoneNumbers = ABRecordCopyValue(person, kABPersonPhoneProperty);
if (phoneNumbers) {
for (int k = 0; k < ABMultiValueGetCount(phoneNumbers); k++) {
NSString *label = (NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(phoneNumbers, k));
NSString *number = (NSString *)ABMultiValueCopyValueAtIndex(phoneNumbers, k);
NSString *labelLower = [label lowercaseString];
if ([labelLower isEqualToString:@"mobile"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=CELL:%@\n", number];
else if ([labelLower isEqualToString:@"home"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=HOME:%@\n", number];
else if ([labelLower isEqualToString:@"work"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=WORK:%@\n", number];
else if ([labelLower isEqualToString:@"main"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=MAIN:%@\n", number];
else if ([labelLower isEqualToString:@"homefax"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=HOME;type=FAX:%@\n", number];
else if ([labelLower isEqualToString:@"workfax"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=WORK;type=FAX:%@\n", number];
else if ([labelLower isEqualToString:@"pager"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=PAGER:%@\n", number];
else if ([labelLower isEqualToString:@"other"])
vcard = [vcard stringByAppendingFormat:@"TEL;type=OTHER:%@\n", number];
else {
counter++;
vcard = [vcard stringByAppendingFormat:@"item%d.TEL:%@\nitem%d.X-ABLabel:%@\n",
counter, number, counter, label];
}
}
}
// 地址
ABMultiValueRef address = ABRecordCopyValue(person, kABPersonAddressProperty);
if (address) {
for (int k = 0; k < ABMultiValueGetCount(address); k++) {
NSString *label = (NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(address, k));
NSDictionary *dic = (NSDictionary *)ABMultiValueCopyValueAtIndex(address, k);
NSString *labelLower = [label lowercaseString];
NSString *country = [dic valueForKey:(NSString *)kABPersonAddressCountryKey];
NSString *city = [dic valueForKey:(NSString *)kABPersonAddressCityKey];
NSString *state = [dic valueForKey:(NSString *)kABPersonAddressStateKey];
NSString *street = [dic valueForKey:(NSString *)kABPersonAddressStreetKey];
NSString *zip = [dic valueForKey:(NSString *)kABPersonAddressZIPKey];
NSString *countryCode = [dic valueForKey:(NSString *)kABPersonAddressCountryCodeKey];
NSString *type = @"";
NSString *labelField = @"";
counter++;
if ([labelLower isEqualToString:@"work"])
type = @"WORK";
else if ([labelLower isEqualToString:@"home"])
type = @"HOME";
else if (label && [label length] > 0)
labelField = [NSString stringWithFormat:@"item%d.X-ABLabel:%@\n", counter, label];
vcard = [vcard stringByAppendingFormat:@"item%d.ADR;type=%@:;;%@;%@;%@;%@;%@\n%@item%d.X-ABADR:%@\n",
counter, type, (street ? street : @""), (city ? city : @""),
(state ? state : @""), (zip ? zip : @""), (country ? country : @""),
labelField, counter, (countryCode ? countryCode : @"")];
}
}
// 其餘欄位(url、IM、照片)此處省略,需要時可自行補齊
vcard = [vcard stringByAppendingString:@"END:VCARD"];
}
return vcard;
}
最省事的做法是用 UIDocumentInteractionController,也就是 QuickLook 來顯示檔案。系統會自動解析,並提供「加入通訊錄」選項。
若要自己解析,可以按行拆解:
// 解析 vcf
-(void)parseVCardString:(NSString *)vcardString {
NSArray *lines = [vcardString componentsSeparatedByString:@"\n"];
for (NSString *line in lines) {
if ([line hasPrefix:@"BEGIN"]) {
NSLog(@"parse start");
} else if ([line hasPrefix:@"END"]) {
NSLog(@"parse end");
} else if ([line hasPrefix:@"N:"]) {
NSArray *upperComponents = [line componentsSeparatedByString:@":"];
NSArray *components = [[upperComponents objectAtIndex:1] componentsSeparatedByString:@";"];
NSString *lastName = [components objectAtIndex:0];
NSString *firstName = [components objectAtIndex:1];
NSLog(@"name %@ %@", lastName, firstName);
} else if ([line hasPrefix:@"EMAIL;"]) {
NSArray *components = [line componentsSeparatedByString:@":"];
NSString *emailAddress = [components objectAtIndex:1];
NSLog(@"emailAddress %@", emailAddress);
} else if ([line hasPrefix:@"TEL;"]) {
NSArray *components = [line componentsSeparatedByString:@":"];
NSString *phoneNumber = [components objectAtIndex:1];
NSLog(@"phoneNumber %@", phoneNumber);
}
}
}
Address Book 這套 C API 在 iOS 9 之後已被 CNContact(Contacts 框架)取代,新專案請優先採用 Contacts。若要沿用舊 API,記得每一個 Copy 開頭的呼叫都必須對應一次 CFRelease,否則會累積記憶體洩漏。
另外,vCard 的字尾規範建議使用 CRLF(\r\n),部分較嚴格的解析器(如 Outlook)對單獨的 \n 相容性不佳。組字串時若使用 stringByAppendingFormat: 反覆拼接,資料量大時效能不佳,建議改用 NSMutableString。