App 要走向國際市場,多語言是基本配備。實作上大致有兩種方向:一是在 App 內提供語言切換選項讓使用者自己選;二是直接跟隨系統語言自動切換。第一種完全靠自己的設計發揮,本文聚焦在第二種,也就是 iOS 原生的本地化機制,共分四個部分。
1. 建立 InfoPlist.strings
點擊 New File,在左側選擇 iOS 的 Resource,右側選擇 Strings File,命名為 InfoPlist(檔名必須完全一致),就會產生 InfoPlist.strings。
2. 加入語言
選中該檔案,開啟 Xcode → View → Utilities → File Inspector,在 Localization 中點擊「+」,加入 Chinese (zh-Hans);English 通常會自動出現。展開檔案左側的三角形,就能看到兩個語言版本。
3. 分別填入名稱
/* InfoPlist.strings (English) */ CFBundleDisplayName = "Program"; /* InfoPlist.strings (Chinese) */ CFBundleDisplayName = "應用程式";
4. 修改 Info.plist
新增一個屬性 Application has localized display name,型別設為 Boolean,值設為 YES。這一步是告訴系統「名稱請去 strings 檔裡找」,漏掉就會失效。
1. 建立 Localizable.strings
同樣透過 New File → Strings File 建立,命名為 Localizable(建議沿用這個名稱,因為後續 API 預設就是找它)。
2. 加入語言與內容
/* Localizable.strings (English) */ "welcome" = "Click on the screen to continue..."; /* Localizable.strings (Chinese) */ "welcome" = "點擊螢幕繼續...";
3. 在程式碼中讀取
CCLabelTTF *label = [CCLabelTTF labelWithString:NSLocalizedString(@"welcome", nil)
fontName:@"Marker Felt"
fontSize:18];
CGSize size = [[CCDirector sharedDirector] winSize];
label.position = ccp(size.width / 2, size.height / 2 + 30);
[self addChild:label];
若你的檔案名稱是自訂的(例如 wang.strings),則要改用 NSLocalizedStringFromTable() 指定表名:
NSLocalizedStringFromTable(@"welcome", @"wang", nil)
方法 A:透過 strings 檔間接對應
/* Localizable.strings (English) */ "BtnCancel" = "BtnCancelEn.png"; /* Localizable.strings (Chinese) */ "BtnCancel" = "BtnCancelCn.png";
CCSprite *btnCancel = [CCSprite spriteWithSpriteFrameName:NSLocalizedString(@"BtnCancel", nil)]; btnCancel.position = ccp(s.width / 2, s.height / 2 - 40); [self addChild:btnCancel z:2 tag:104];
方法 B:使用 Xcode 的 .lproj 機制(推薦)
點選要本地化的圖片(例如 icon.png),開啟 Xcode → View → Utilities → File Inspector,在 Localization 中點擊「+」加入 Chinese (zh-Hans)。此時檔案左側會出現展開箭頭,分別顯示 (English) 與 (Chinese) 兩份同名圖片;專案資料夾中也會產生 en.lproj 與 zh-Hans.lproj 目錄,各存放對應語言的資源。
這種做法的好處是:程式碼完全不必改動,永遠寫 @"icon.png",系統會依語言自動挑選正確的檔案。這也是 Apple 官方推薦的方式。
做法與圖片的方法 B 相同:先在 Localization 中加入語言,再把對應語言的檔案放進 en.lproj 與 zh-Hans.lproj,之後照常引用即可。plist、html、json 等任何資源檔都適用。
幾個容易出錯的地方值得先記住。第一,NSLocalizedString 的第二個參數(comment)雖然常寫 nil,但養成填寫習慣能讓 genstrings 產生的翻譯檔更易懂。第二,strings 檔的語法相當嚴格,分號、雙引號、等號少一個就會導致整份檔案讀取失敗,且失敗時不會報錯,只會靜靜地顯示出 key 本身。第三,繁體中文的語言代碼是 zh-Hant,與簡體的 zh-Hans 是兩個獨立在地化版本,若有兩岸三地市場需求需分別維護。