手上這個 BK 專案的功能已經開發得差不多,進入收尾階段時迎來一個新任務:把介面文字翻譯成多國語言,讓同一套 App 能投放到不同國家、不同門店的環境中使用。
所謂應用本地化,本質上就是分別處理字串、圖片以及 xib / storyboard 這類介面檔案。最常見的教科書做法是:為 xib 上的每個元件(UILabel、UIButton、UITextField 等)關聯一個變數,再透過 NSLocalizedString 這個函數去 Localizable.strings 裡查對應的 key 值;另一種則是乾脆為同一個介面產生多份不同語言的 xib,例如 MainVC.xib(German) 與 MainVC.xib(English)。
問題在於,專案一旦長大,這種方式維護成本會直線上升——正如很多人形容的那樣,tedious and useless。


偽本地化是把待翻譯字串先替換成「看起來像已翻譯」的無意義文字。做法很隨意:丟進機器翻譯跑一遍,或者直接把所有母音字母換成 x。例如 “Press here to continue” 會變成 “Prxss hxrx tx cxntxnxx”。這一步的價值在於——不等翻譯回來,就能提前把介面被截斷、對齊跑掉、換行位置錯誤這類問題挖出來。
帶著偽本地化的版本把每個畫面走過一遍,記錄下所有顯示異常的位置,交給設計與開發同步修正。
把資源交給本地化服務供應商,對方會回傳翻譯完成的檔案,接著依據譯文進行實際的本地化工作。
用版本控制系統記錄每一次變更,這是所有協作環節的基礎。
這一步不用多說,該做的還是要做。
邏輯變更通常不會影響 nib 檔案與本地化成果,但多人協作的專案仍需把彼此的功能變更合併起來。
如果修改了已本地化的文字,整個流程就得重跑一遍,並把新內容再次送給本地化人員。雖然可以重用先前的字串翻譯、效率不至于歸零,但依然麻煩。結論很明確:盡量不要在開發後期才動這類變更。
關於應用本地化的文章網路上已經有很多前輩寫過,這裡不再重複,只列出我自己讀過覺得不錯的幾篇:
1、MJ 的《應用程序本地化》,寫於 2013 年,針對 XCode 5。部分操作介面已經和現在不同,但思路不變。
2、《iOS 應用國際化教程(2014 版)》,時間較新,而且是以 storyboard 為例。
3、RAYWENDERLICH 上的 Internationalization Tutorial for iOS [2014 Edition],品質一向很高,強烈推薦。
真正想聊的是我在 GitHub 上找到的一個類。程式碼優雅得讓人感動。

專案地址就在 GitHub 上(搜尋 OHAutoNIBi18n 即可)。如果你手上有更優秀的類似实现,也歡迎分享。


它的核心思路是透過 method swizzling,在 awakeFromNib 之後自動把各類 UIKit 元件上的文字拿去查本地化詞典,完全不需要手動為每個控制項綁變數。以下是我做過小幅修改的 OHAutoNIBi18n.m,在不改動 frame 的前提下,為 UILabel、UIButton、UITextField 加上字級自適應:
//
// OHAutoNIBi18n.m
//
// Created by Olivier on 03/11/10.
// Copyright 2010 FoodReporter. All rights reserved.
//
#import <objc/runtime.h>
#import <UIKit/UIKit.h>
static inline NSString* localizedString(NSString* aString);
static inline void localizeUIBarButtonItem(UIBarButtonItem* bbi);
static inline void localizeUIBarItem(UIBarItem* bi);
static inline void localizeUIButton(UIButton* btn);
static inline void localizeUILabel(UILabel* lbl);
static inline void localizeUINavigationItem(UINavigationItem* ni);
static inline void localizeUISearchBar(UISearchBar* sb);
static inline void localizeUISegmentedControl(UISegmentedControl* sc);
static inline void localizeUITextField(UITextField* tf);
static inline void localizeUITextView(UITextView* tv);
static inline void localizeUIViewController(UIViewController* vc);
@interface NSObject(OHAutoNIBi18n)
-(void)localizeNibObject;
@end
@implementation NSObject(OHAutoNIBi18n)
#define LocalizeIfClass(Cls) if ([self isKindOfClass:[Cls class]]) localize##Cls((Cls*)self)
-(void)localizeNibObject
{
LocalizeIfClass(UIBarButtonItem);
else LocalizeIfClass(UIBarItem);
else LocalizeIfClass(UIButton);
else LocalizeIfClass(UILabel);
else LocalizeIfClass(UINavigationItem);
else LocalizeIfClass(UISearchBar);
else LocalizeIfClass(UISegmentedControl);
else LocalizeIfClass(UITextField);
else LocalizeIfClass(UITextView);
else LocalizeIfClass(UIViewController);
if (self.isAccessibilityElement == YES)
{
self.accessibilityLabel = localizedString(self.accessibilityLabel);
self.accessibilityHint = localizedString(self.accessibilityHint);
}
// Call the original awakeFromNib method
[self localizeNibObject]; // swizzling 之後,這裡實際呼叫的是原本的 awakeFromNib
}
+(void)load
{
Method localizeNibObject = class_getInstanceMethod([NSObject class], @selector(localizeNibObject));
Method awakeFromNib = class_getInstanceMethod([NSObject class], @selector(awakeFromNib));
method_exchangeImplementations(awakeFromNib, localizeNibObject);
}
@end
static inline NSString* localizedString(NSString* aString)
{
if (aString == nil || [aString length] == 0)
return aString;
// 以數字開頭的字串不翻譯
if ([[NSCharacterSet decimalDigitCharacterSet] characterIsMember:[aString characterAtIndex:0]])
return aString;
#if OHAutoNIBi18n_DEBUG
static NSString* const kNoTranslation = @"$!"; // 不可能出現的哨兵值
NSString* tr = [[NSBundle mainBundle] localizedStringForKey:aString value:kNoTranslation table:nil];
if ([tr isEqualToString:kNoTranslation])
{
if ([aString hasPrefix:@"."])
return aString; // 以 . 開頭的多為設計期佔位符,程式碼稍後會替換
NSLog(@"No translation for string '%@'", aString);
tr = [NSString stringWithFormat:@"$%@$", aString];
}
return tr;
#else
return [[NSBundle mainBundle] localizedStringForKey:aString value:nil table:nil];
#endif
}
static inline void localizeUIBarButtonItem(UIBarButtonItem* bbi)
{
localizeUIBarItem(bbi);
NSMutableSet* locTitles = [[NSMutableSet alloc] initWithCapacity:[bbi.possibleTitles count]];
for(NSString* str in bbi.possibleTitles)
[locTitles addObject:localizedString(str)];
bbi.possibleTitles = [NSSet setWithSet:locTitles];
#if ! __has_feature(objc_arc)
[locTitles release];
#endif
}
static inline void localizeUIBarItem(UIBarItem* bi)
{
bi.title = localizedString(bi.title);
}
static inline void localizeUIButton(UIButton* btn)
{
NSString* title[4] = {
[btn titleForState:UIControlStateNormal],
[btn titleForState:UIControlStateHighlighted],
[btn titleForState:UIControlStateDisabled],
[btn titleForState:UIControlStateSelected]
};
[btn.titleLabel setAdjustsFontSizeToFitWidth:YES];
[btn setTitle:localizedString(title[0]) forState:UIControlStateNormal];
if (title[1] == [btn titleForState:UIControlStateHighlighted]) [btn setTitle:localizedString(title[1]) forState:UIControlStateHighlighted];
if (title[2] == [btn titleForState:UIControlStateDisabled]) [btn setTitle:localizedString(title[2]) forState:UIControlStateDisabled];
if (title[3] == [btn titleForState:UIControlStateSelected]) [btn setTitle:localizedString(title[3]) forState:UIControlStateSelected];
}
static inline void localizeUILabel(UILabel* lbl)
{
lbl.adjustsFontSizeToFitWidth = YES;
lbl.text = localizedString(lbl.text);
}
static inline void localizeUINavigationItem(UINavigationItem* ni)
{
ni.title = localizedString(ni.title);
ni.prompt = localizedString(ni.prompt);
}
static inline void localizeUISearchBar(UISearchBar* sb)
{
sb.placeholder = localizedString(sb.placeholder);
sb.prompt = localizedString(sb.prompt);
sb.text = localizedString(sb.text);
NSMutableArray* locScopesTitles = [[NSMutableArray alloc] initWithCapacity:[sb.scopeButtonTitles count]];
for(NSString* str in sb.scopeButtonTitles)
[locScopesTitles addObject:localizedString(str)];
sb.scopeButtonTitles = [NSArray arrayWithArray:locScopesTitles];
#if ! __has_feature(objc_arc)
[locScopesTitles release];
#endif
}
static inline void localizeUISegmentedControl(UISegmentedControl* sc)
{
NSUInteger n = sc.numberOfSegments;
for(NSUInteger idx = 0; idx<n; ++idx)
[sc setTitle:localizedString([sc titleForSegmentAtIndex:idx]) forSegmentAtIndex:idx];
}
static inline void localizeUITextField(UITextField* tf)
{
tf.adjustsFontSizeToFitWidth = YES;
tf.text = localizedString(tf.text);
tf.placeholder = localizedString(tf.placeholder);
}
static inline void localizeUITextView(UITextView* tv)
{
tv.text = localizedString(tv.text);
}
static inline void localizeUIViewController(UIViewController* vc)
{
vc.title = localizedString(vc.title);
}
tips:本地化時還需要注意以下幾點:
1、別忘了有從右到左閱讀的語言(如阿拉伯語、希伯來語),版面需要鏡像處理。
2、不要預設逗號就是千位分隔符、句點就是小數點,不同地區的習慣可能剛好相反。
3、數字與日期都要做格式化處理,輸入與輸出兩端都要顧到,建議直接使用 NSNumberFormatter、NSDateFormatter 並指定 locale。
把基礎建設做對之後,剩下的就交給翻譯人員了。
Apple 官方文件:Localizing Your App
Apple 官方文件:Internationalize Your App
Apple 官方文件:Data Formatting Guide
Apple 官方文件:Internationalization Programming Topics
Apple 官方文件:Internationalization and Localization