Localization - 如何在 App 內切換不同語言

是我太奇怪還是世界很無奈

2024/10/09 更新2023/10/10 發佈閱讀 9 分鐘

實際切換效果

建立 LocalizationManager

首先創建一個 Manager 控管內部切換語言，這邊我命名為 LocalizationManager ，他是一個 Singleton ，跟著 App 一起存亡

上一篇有提到，每新增一個語言就會多一個語言資料夾，因此當使用者切換語言的時候，要將讀取的資料夾路徑做變換，讓 Manager 去讀取切換的語言資料夾，達到切換語言的功能

資料夾結尾都是.lproj

最終想要達成從外部呼叫 LocalizationManager.shared.language = .english 簡單明瞭的方式切換語言，開始寫程式吧！

建立 enum

建立 enum Language ，把所有會切換的語言列入

enum Language: String {
        case english = "en"
        case chineseT = "zh-Hant"
        case chineseS = "zh-Hans"
        case system
        
        var segmentNum: Int {
            switch self {
            case .english:
                return 0
            case .chineseT:
                return 1
            case .chineseS:
                return 2
            case .system:
                return 3
            }
        }
}

建立變數

// 當系統語言開頭為 "ZH" 之外的語言都給英語的路徑
var languageForBundle: Language = {
        if let systemLanguage = Locale.preferredLanguages.first {
            if systemLanguage.hasPrefix("zh") {
                if systemLanguage.contains("Hant") || systemLanguage.contains("Trad") {
                    return .chineseT
                }
                return .chineseS
            }
        }
        return .english
}()

// 當 language 有變動時儲存至 UserDefaults ，當有已存的語言就讀取，沒有則判定為系統語言    
var language: Language = {
        // read saved language
        let languageString = UserDefaults.standard.string(forKey: UDKey.language.rawValue)
        if let language = Language(rawValue: languageString ?? "") {
            return language
        }
        // no saved so read system
        return .system
}(){
        didSet {
            UserDefaults.standard.setValue(language.rawValue, forKey: UDKey.language.rawValue)
        }
}

在 manager 內建立兩個變數，languageForBundle 讀取本機系統目前的語言，language 則是讀取使用者在 App 內部選取的語言，如果使用者沒有選擇語言則跟隨本機系統目前的語言

外部如何呼叫並實現功能

建立一個 function （給予 Key 會去抓目標語言的檔案內對應的 value）

func strWithKey(key: String) -> String? {
        var resource: String
        
        // 透過 language 獲得的值去取得語言名稱 ex: zh-Hant
        if self.language == .system {
            resource = self.languageForBundle.rawValue
        } else {
            resource = self.language.rawValue
        }
        
        // 獲得路徑
        guard let path = Bundle.main.path(forResource: resource, ofType: "lproj"),
              let bundle = Bundle(path: path) else { return nil }
        
        let str = bundle.localizedString(forKey: key, value: "", table: nil)
        return str
}

ViewController 呼叫

// ViewController
// 用 SegmentedControl 切換語言
@IBAction func changeLanguage(_ sender: UISegmentedControl) {
        
        switch sender.selectedSegmentIndex {
        // en, ch-tra, ch-sim, system
        case 0:
            LocalizationManager.shared.language = .english
        case 1:
            LocalizationManager.shared.language = .chineseT
        case 2:
            LocalizationManager.shared.language = .chineseS
        case 3:
            LocalizationManager.shared.language = .system
        default:
            break
        }
        
        reloadText()
}

private func reloadText() {
        greetingLabel.text = (LocalizationManager.shared.strWithKey(key: LocalizedKey.label_greeting.str) ?? "") + (name ?? "")
        buyDiamondsLabel.text = LocalizationManager.shared.strWithKey(key: LocalizedKey.label_buyDiamond.str)
        changeLanLabel.text = LocalizationManager.shared.strWithKey(key: LocalizedKey.label_language.str)
        
        restoreBtn.setTitle(LocalizationManager.shared.strWithKey(key: LocalizedKey.btn_restore.str), for: .normal)
        hasLogedInBtnState(LogInDataManager.shared.hasAccountNPasswd())
        
        lanSegment.setTitle(LocalizationManager.shared.strWithKey(key: LocalizedKey.label_system.str), forSegmentAt: 3)
       
        tableView.reloadData()
}