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

國際化實踐:如何優雅處理全球電話區號列表

編輯:iOS 開發基礎

作者:裡脊串 授權本站轉載。

問題從哪裡來

前陣子在折騰產品國際化(i18n),其中一塊很不起眼的骨頭是電話號碼的國際化——我們的產品直接拿手機號當主賬號,而號碼前面必然跟著一個區號。

如上圖,登錄界面裡除了常規的號碼輸入框,前面還有一個區號,用來標明這個號碼屬於哪個國家或地區。區號的概念可以查維基百科,這裡不展開。

看到這裡你可能會說:這有什麼難的,按列表渲染不就完了?真要這麼做,有兩個繞不開的坎:

  • 既然要支持多語言,那麼不同語言環境下同一個國家的名稱是不同的——「中國」在簡中裡是「中國」,英文裡是「China」,韓文裡又是另一串字符;更麻煩的是,它們在各自語言下的排序位置也完全不同。
  • 如果想按「國家 × 語言」逐一維護一張靜態表,工作量指數級上升,一般團隊根本扛不住。

好在這件事不必全靠自己扛。iOS 已經幫我們解決了一半:可以根據國家代碼,取出某個國家在當前區域下的本地化名稱。

// 獲取當前 locale
NSLocale *locale = [NSLocale currentLocale];

// 獲取所有 ISO 國家代碼
NSArray *countryArray = [NSLocale ISOCountryCodes];
for (NSString *countryCode in countryArray) {
    // 根據當前 locale 與國家代碼,取得該國家的本地化名稱
    NSString *localName = [locale displayNameForKey:NSLocaleCountryCode value:countryCode];
}

隨手驗證一下,分別用簡中、英文、日文三種 locale 打印前幾個國家:

NSArray *countryArray  = [NSLocale ISOCountryCodes];
NSArray *languageArray = @[@"zh_CN", @"en_US", @"ja_JP"];
for (NSString *languege in languageArray) {
    NSLocale *locale = [[NSLocale alloc] initWithLocaleIdentifier:languege];
    for (int i = 0; i < 5; ++i) {
        NSString *countryCode = countryArray[i];
        NSString *displayName = [locale displayNameForKey:NSLocaleCountryCode value:countryCode];
        NSLog(@"%@\t%@\t%@", languege, countryCode, displayName);
    }
}

輸出結果:

zh_CN AD 安道爾
zh_CN AE 阿拉伯聯合酋長國
zh_CN AF 阿富汗
zh_CN AG 安提瓜和巴布達
zh_CN AI 安圭拉
en_US AD Andorra
en_US AE United Arab Emirates
en_US AF Afghanistan
en_US AG Antigua and Barbuda
en_US AI Anguilla
ja_JP AD アンドラ
ja_JP AE アラブ首長國連邦
ja_JP AF アフガニスタン
ja_JP AG アンティグア・バーブーダ
ja_JP AI アンギラ

系統替我們搞定的是「名稱的本地化」。剩下的一半——「地區 → 區號」的映射——得自己準備。這部分反而簡單,網上現成的 JSON 一大把,我也是撿現成的用(diallingcode.json):

[
    {
        "name": "Afghanistan",
        "dial_code": "+93",
        "code": "AF"
    },
    {
        "name": "Albania",
        "dial_code": "+355",
        "code": "AL"
    },

    ...

    {
        "name": "Virgin Islands, British",
        "dial_code": "+1 284",
        "code": "VG"
    },
    {
        "name": "Virgin Islands, U.S.",
        "dial_code": "+1 340",
        "code": "VI"
    }
]

維護這麼一張表成本很低,放本地 bundle 或掛在服務器上都行(name 字段其實並非必需,放著只是為了可讀)。

看看別人是怎麼做的

動手之前,先橫向調研一下。

微信

問題還不少:

  • 左圖是中文環境,按拼音分組的思路對了,但組內排序卻錯了——以「阿」開頭的國家並沒有排在一起。
  • 右圖是法語環境,那些帶變音符的拉丁字母沒有被正確歸類。

Twitter

中文環境下依然怪怪的,但至少沒犯微信的第二個錯誤。

Facebook

人家的工程師比較聰明(或者說比較懶)——乾脆不做索引。

接下來,我們把上面這些坑一個一個填掉。

動手寫代碼

先定義一個 model 承載國家相關信息:

@interface MMCountry : NSObject
@property (nonatomic, strong) NSString *name;      // 國家名(本地化後)
@property (nonatomic, strong) NSString *code;      // 國家代碼
@property (nonatomic, strong) NSString *latin;     // 國家名的拉丁化寫法(僅含基本拉丁字母)
@property (nonatomic, strong) NSString *dial_code; // 區號
@end

第一步,從配置文件讀出區號,並以國家代碼為 key 建索引:

NSData *data = [NSData dataWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"diallingcode" ofType:@"json"]];
NSError *error = nil;
NSArray *arrayCode = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
if (error) {
    return;
}

// 讀取文件
NSMutableDictionary *dicCode = [@{} mutableCopy];
for (NSDictionary *item in arrayCode) {
    MMCountry *c = [MMCountry new];
    c.code      = item[@"code"];
    c.dial_code = item[@"dial_code"];
    [dicCode setObject:c forKey:c.code];
}

第二步,把本地化名稱補上去:

NSLocale *locale = [NSLocale currentLocale];
NSArray *countryArray = [NSLocale ISOCountryCodes];
NSMutableDictionary *dicCountry = [@{} mutableCopy];
for (NSString *countryCode in countryArray) {
    if (dicCode[countryCode]) {
        MMCountry *c = dicCode[countryCode];
        c.name = [locale displayNameForKey:NSLocaleCountryCode value:countryCode];
        if ([c.name isEqualToString:@"台灣"]) {
            c.name = @"中國台灣";
        }

        // 把名稱拉丁字母化
        c.latin = [self latinize:c.name];

        [dicCountry setObject:c forKey:c.code];
    } else {
        // 找不到說明配置文件不全,可以按需補全
        NSLog(@"missed %@ %@", [locale displayNameForKey:NSLocaleCountryCode value:countryCode], countryCode);
    }
}

關鍵在 latinize: 這個方法——它解決了微信的第二個問題,讓非基本拉丁字母也能按基本拉丁字母歸類:

- (NSString *)latinize:(NSString *)str {
    NSMutableString *source = [str mutableCopy];

    CFStringTransform((__bridge CFMutableStringRef)source, NULL, kCFStringTransformToLatin, NO);
    // 微信的錯誤做法:只針對漢字處理,其他字符不管
    // CFStringTransform((__bridge CFMutableStringRef)source, NULL, kCFStringTransformMandarinLatin, NO);

    CFStringTransform((__bridge CFMutableStringRef)source, NULL, kCFStringTransformStripDiacritics, NO);
    return source;
}

兩步走:

  1. 先把文字轉成拉丁字母(kCFStringTransformToLatin);
  2. 再去掉拉丁字母上的變音符(kCFStringTransformStripDiacritics)。

微信栽的第一個跟頭就在這裡:它在第一步只對漢字做了處理,其他字符原封不動,導致第二步拿不到乾淨的基本拉丁字符(參見上面註釋掉的 kCFStringTransformMandarinLatin)。

驗證一下這兩步的效果,還是原來那三個 locale:

zh_CN AD 安道爾 | an dao er
zh_CN AE 阿拉伯聯合酋長國 | a la bo lian he qiu zhang guo
zh_CN AF 阿富汗 | a fu han
zh_CN AG 安提瓜和巴布達 | an ti gua he ba bu da
zh_CN AI 安圭拉 | an gui la
en_US AD Andorra | Andorra
en_US AE United Arab Emirates | United Arab Emirates
en_US AF Afghanistan | Afghanistan
en_US AG Antigua & Barbuda | Antigua & Barbuda
en_US AI Anguilla | Anguilla
ja_JP AD アンドラ | andora
ja_JP AE アラブ首長國連邦 | arabu shou zhang guo lian ban
ja_JP AF アフガニスタン | afuganisutan
ja_JP AG アンティグア・バーブーダ | antigua・babuda
ja_JP AI アンギラ | angira

可以看到,系統會依據不同語言的特點,把同一個國家在不同語種下的寫法轉成不同的拉丁字母形式。

第三步,按 A–Z 分組:

NSMutableDictionary *dicSort = [@{} mutableCopy];
for (MMCountry *c in dicCountry.allValues) {
    NSString *indexKey = @"";

    if (c.latin.length > 0) {
        indexKey = [[c.latin substringToIndex:1] uppercaseString];
        char c = [indexKey characterAtIndex:0];
        if ((c < 'A') || (c > 'Z')) {
            continue;
        }
    } else {
        continue;
    }

    NSMutableArray *array = dicSort[indexKey];
    if (!array) {
        array = [NSMutableArray array];
        dicSort[indexKey] = array;
    }
    [array addObject:c];
}

第四步,每組內部重新排序:

for (NSString *key in dicSort.allKeys) {
    NSArray *array = dicSort[key];
    array = [array sortedArrayUsingComparator:^NSComparisonResult(MMCountry *obj1, MMCountry *obj2) {
        return [obj1.name localizedStandardCompare:obj2.name];
    }];
    dicSort[key] = array;
}

dicSort 就是最終要交給 UI 的結果集。

這裡正是微信犯的第二個錯誤:它按 latin 字段排序(即上面註釋掉的那段寫法),於是同一個漢字開頭的國家被拆得七零八落。正確做法是用 localizedStandardCompare:——這是 iOS 為我們準備好的本地化比較函數,它會按當前語言習慣處理標點、變音符、數字等細節。

舉個例子:阿爾巴尼亞、愛爾蘭、阿魯巴,拼音分別是 aerbabiya、aierlan、aluba。如果按拼音字符串排序,三者會被拆散;用 localizedStandardCompare: 則能正確聚在一起。

最終效果:

是不是比某些大廠的實現靠譜一些?

還有值得再想的地方

代碼寫完了,問題卻沒真正結束。有一個前提我一直沒敢下定論:憑什麼一定要按 A–Z 索引?

看看 Twitter 在日文和韓文環境下的處理:

更理想的做法,是依據各語言自身的排序規則生成對應的索引(比如日文用五十音、韓文用韓字母)。說實話,看到 Twitter 在中文環境下的表現,我也無法確定它在日韓環境下的結果是否正確。

真要這麼做,改動量並不大——只需要替換生成 indexKey 的那一小段邏輯。

小結

本文的方案並非終局。想要更好的體驗,還得深入瞭解各國的語言與文化習慣。由此可見,國際化從來都不只是個技術問題,它同時也是個社會工程。

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