您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發:vCard 檔案的生成與解析

編輯:iOS 開發綜合

vcf 是通訊錄常見的匯出格式,全名為 vCard。若要把 iPhone 通訊錄裡的資料轉成 vcf,最簡單的方式是透過 iCloud 網頁版匯出;但如果你想在 App 內用程式碼完成,也完全可以——先讀出通訊錄資料,再逐筆組裝成 vCard 字串即可。

一、生成 vcf 檔

-(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;
}

二、解析 vcf 檔

最省事的做法是用 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。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved