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

深入 iOS 國際化:從 .lproj 原理到應內無死角切換語言

編輯:iOS 開發基礎

本文為投稿文章,作者:龔凱。原文:iOS 國際化。

在真正動手之前,我對國際化的理解僅停留在「用 NSLocalizedString 把字符串加載進來」。直到公司項目要求增加英文版,並且要支持在應用內無死角切換語言,我才把沿途的坑一一踩過,並記錄於此。


環境說明

系統:iOS 7 - iOS 9;開發環境:Swift 2 + Xcode 7;配套 Demo:LocalDemo。

這個 Demo 展示的效果是:切換語言後,界面文字、圖片乃至搜索引擎都會隨之變化。建議先下載運行看效果,再往下閱讀。


原理:以 .lproj 組織資源

國際化的思路各平台大同小異,核心都是為每種語言單獨準備一份資源。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 與 XIB 的國際化


相較前兩者,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。

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