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

如上圖,登錄界面裡除了常規的號碼輸入框,前面還有一個區號,用來標明這個號碼屬於哪個國家或地區。區號的概念可以查維基百科,這裡不展開。
看到這裡你可能會說:這有什麼難的,按列表渲染不就完了?真要這麼做,有兩個繞不開的坎:
好在這件事不必全靠自己扛。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 字段其實並非必需,放著只是為了可讀)。
動手之前,先橫向調研一下。
微信

問題還不少:

中文環境下依然怪怪的,但至少沒犯微信的第二個錯誤。
人家的工程師比較聰明(或者說比較懶)——乾脆不做索引。
接下來,我們把上面這些坑一個一個填掉。
先定義一個 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;
}
兩步走:
kCFStringTransformToLatin);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 的那一小段邏輯。
本文的方案並非終局。想要更好的體驗,還得深入瞭解各國的語言與文化習慣。由此可見,國際化從來都不只是個技術問題,它同時也是個社會工程。