
本文為投稿文章,作者:龔凱。原文:iOS 國際化。
在真正動手之前,我對國際化的理解僅停留在「用 NSLocalizedString 把字符串加載進來」。直到公司項目要求增加英文版,並且要支持在應用內無死角切換語言,我才把沿途的坑一一踩過,並記錄於此。
系統:iOS 7 - iOS 9;開發環境:Swift 2 + Xcode 7;配套 Demo:LocalDemo。

這個 Demo 展示的效果是:切換語言後,界面文字、圖片乃至搜索引擎都會隨之變化。建議先下載運行看效果,再往下閱讀。
國際化的思路各平台大同小異,核心都是為每種語言單獨準備一份資源。iOS 通過 xxx.lproj 目錄來隔離各語言資源,這裡的資源可以是圖片、文本、Storyboard 或 Xib。
先看 Demo 的物理目錄結構。
Base(暫時無需理會)

English

中文

每種語言對應一個「語言代碼.lproj」文件夾,加載時只需取對應文件夾下的資源。這一步系統可以自動完成,也可以手動指定。
值得注意的是:源碼中若多個目錄都存在國際化資源,就會產生多個同名 .lproj;但編譯打包後,它們會集中合併到 app 根目錄下的 xxx.lproj 中。

路徑:PROJECT › Info › Localizations,添加需要支持的語言。

開啟 Use Base Internationalization 後,每個國際化資源文件都會多出一個 Base 選項,它把 String、Storyboard、Xib 作為一個基礎模板——後文 Storyboard 的方案二正是基於 Base Storyboard。
點擊「+」添加語言時,Xcode 會詢問是否為現有資源建立對應的語言文件,直接 Finish 即可。

這部分針對代碼中的字符串,例如提示消息、UI 標題等。
我們用 Localizable.strings 存儲各語言文本,它是 iOS 默認加載的文件。若想用自定義文件名,在調用 NSLocalizedString 時指定 tableName 即可——不過項目規模不大時,沒必要拆模塊自找麻煩。
在資源文件的屬性面板中,通過 Localization 添加語言,此時文件會變成可展開狀態,下面掛著各語言副本,把對應翻譯填進去即可。

Base 選項之所以可能不勾選:對 Strings 文件而言 Base 意義不大,去掉它還能讓 Base.lproj 少一個文件,包體略微減小。這一點對圖片尤其明顯。
每套語言一份 strings,內容格式為 "key" = "value";,注意結尾的分號不可省。
代碼中的用法:
NSLocalizedString("首頁", comment: "")
NSLocalizedString("好友", comment: "")
NSLocalizedString("我", comment: "")還有一個省事的做法:中文 strings 可以不做。因為 key 本身就是中文,當系統找不到對應語言的 strings 或 value 時,會直接返回 key。這樣我們只需維護一份英文副本即可。
兩種方案:自定義命名,或原生支持。
注意:新版 Xcode 中 Images.xcassets 不支持國際化(屬性面板沒有 Localization),Xcode 5 之前是支持的。
方案一:靠字符串 key 拼接

UIImage(named: NSLocalizedString("search_logo", comment: ""))不推薦。一是做法笨重、工作量更大,二是無法在 Storyboard 或 XIB 中使用。
方案二:原生支持

同樣去掉 Base 副本。需要注意的是,在 XIB 或 Storyboard 中引用此類圖片時,只寫名稱無法實時預覽,必須帶上後綴,例如 avater.png。
代碼調用方式不變,系統會自動去對應語言的 .lproj 中查找:
UIImage(named: "avater")
建議的存放約定:需要國際化的圖片放在自定義 Group 中,不需要的放在 Images.xcassets。
相較前兩者,Storyboard 的國際化略麻煩,同樣有兩種方案。
方案一:每種語言維護一套 Storyboard

在文件檢查器中可把語言切換為 strings 或 Storyboard(默認 strings)。若選擇 Interface Builder Storyboard,各語言界面彼此獨立、互不影響。
方案二:Base Storyboard + 各語言 strings

以一個基礎 Storyboard 作為模板,其中所有文本類資源(如 UILabel 的 text)都會被抽取到各語言的 strings 文件中。做國際化時只需編輯對應的 strings。
首選方案二。方案一意味著每改一個界面元素都要同步改所有語言的 Storyboard,成本相當於維護多個項目;方案二只需改 Base Storyboard。
但方案二有個前提:strings 一旦生成,Base Storyboard 後續的增刪不會自動同步。若新增或刪除了一個 UILabel,strings 不會跟著變。
好在 Xcode 提供了 ibtool:
ibtool Main.storyboard --generate-strings-file ./NewTemp.string
不過它生成的是 Base(默認語言)的 strings,並會覆蓋原有文件。所以做法是:把新生成的內容與舊文件做合併——新增項追加、刪除項註釋掉。這一步可以交由 AutoGenStrings.py 腳本完成,再掛到 Xcode 的 Run Script 上,讓每次 Build 都自動保證 strings 與 Base Storyboard 一致。

應用啟動時會讀取 NSUserDefaults 中 key 為 AppleLanguages 的值。它是一個字符串數組,保存 App 支持的語言列表,第一項即當前默認語言。首次安裝啟動時,該 key 會被初始化的系統語言編碼,例如簡體中文是 zh-Hans。
// 獲取當前語言
(NSUserDefaults.standardUserDefaults().valueForKey("AppleLanguages") as! Array)[0]理論上改這個值就能切換語言,但這裡有兩個坑:蘋果未提供修改 App 默認語言的公開 API,只能通過 NSUserDefaults 手動改;而且改完必須重啟 App 才生效——框架在首次加載時似乎對 AppleLanguages 做了內存緩存。
// 設置當前語言 var def = NSUserDefaults.standardUserDefaults() def.setValue(["zh-Hans"], forKey: "AppleLanguages") def.synchronize()
那麼如何做到改完立刻生效、無需重啟?關鍵在於:Storyboard、圖片、字符串的加載其實都走 NSBundle.mainBundle()。只要在切換語言後把它替換為當前語言的 bundle,系統後續加載的自然就是新語言資源。
而 .lproj 目錄本身可以用一個 NSBundle 表示:
import Foundation
/// 調用 onLanguage 後,把 mainBundle 替換為當前語言的 bundle
private let _bundle: UnsafePointer = unsafeBitCast(0, UnsafePointer.self)
class BundleEx: NSBundle {
override func localizedStringForKey(key: String, value: String?, table tableName: String?) -> String {
if let bundle = languageBundle() {
return bundle.localizedStringForKey(key, value: value, table: tableName)
} else {
return super.localizedStringForKey(key, value: value, table: tableName)
}
}
}
extension NSBundle {
private struct Static {
static var onceToken: dispatch_once_t = 0
}
func onLanguage() {
dispatch_once(&Static.onceToken) {
object_setClass(NSBundle.mainBundle(), BundleEx.self)
}
}
/// 當前語言的 bundle
func languageBundle() -> NSBundle? {
return Languager.standardLanguager().currentLanguageBundle
}
}其中 Languager 來自開源庫 iOS-i18n,我把其中的國際化部分做了封裝,有興趣可以參閱。
指定運行語言:若希望首次安裝時不跟隨系統語言,可在 Xcode 的 scheme 中指定。

Storyboard 支持實時預覽,效果如下。

IB 中 UIImageView 國際化無效:為 UIImageView 擴展一個屬性,再在 User Defined Runtime Attributes 中傳入 imageName。
extension UIImageView {
var locale: String {
get { return "" }
set(newlocale) { self.image = localizedImage(newlocale) }
}
}IB 中 UITextView 國際化無效:思路相同,把 self.text 作為 key 去 strings 中取對應 value。
extension UITextView {
var locale: Bool {
get { return true }
set(newlocale) { self.text = localized(self.text) }
}
}LaunchScreen.xib 無法國際化:目前並不支持。繞法是自己寫一個 LaunchViewController,代價是啟動時會有一段黑屏,因此更建議不要在啟動頁放國際化文案。
iOS 國際化——通過腳本使 storyboard 翻譯自增;Working with Localization;How to force NSLocalizedString to use a specific language。