Localization - 讓 App 支援不同語言手把手教學

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

更新於 2024/10/07發佈於 2023/10/08閱讀時間約 8 分鐘

JACQUELINE BRANDWAYN on Unsplash

身為一個菜鳥工程師，將辛苦製作的 App 推向國際，多國語言是肯定要的。Let’s Go Go Go！

專案設定

打開專案內的 Project -> Info -> Localizations 新增你想要增加的語言

增加完後會問你要添加的地方，例如 Main.storyboard 打勾的話，就會幫你把 storyboard 中所有有文字的地方變成一串 key = value 的形式，放進 main.strings 檔案，這個檔案會在你添加的語言資料夾內，所以每加一個語言，就會有一個專屬的資料夾

en 的語言資料夾內

storyboard 多國語文檔

Main 底下會長出語言的檔案

左圖可以看到，"2Gf-sf-0bs.text" = "Password"; 2Gf-sf-0bs這串文字其實是該 label 的 objectID，也是讓程式尋找對應的文字的 Key ，所以如果不知道這邊的文字代表畫面上哪個物件的時候，可以用 objectID 去 stroryboard 確認是哪個物件

在 stroryboard 上點選物件後，Document 欄位會有 objectID

這時候就會想到，阿如果我有些文字是用程式產生的呢？

程式中的文字多國語文檔

新增 Strings File，取名為 Localizable（請務必這樣取名，方便Xcode抓取），接著點選檔案右側的 Localization 將需要的語言打勾，就會幫你產出好幾個檔案

這邊的 Key 命名就看個人習慣，自己是將不同類型的文字前面加上label, btn, alert … 等作區分

記得程式內有使用到 String 文字的地方，就要透過 Key 去讀取對應的 String，才能達到多國語系顯示的目的

App Name 多國語文檔

別忘了幫 App 的大名跟著一起切換，這時候又要新增一個 Strings File，然後 key 為 "CFBundleDisplayName" 記得一定要取這個 Key 不然系統會抓不到

應用時間

// Localizable.string 內的格式
"alert_logInSuccess" = "LogIn Success";
"label_amountOfDiamondsText" = "%d 顆鑽石"; // %d 的地方可以傳入參數

// controller 讀取
let logInSuccessText = NSLocalizedString("PurchaseVC.Alert.logInSuccess", comment: "logIn Success")

let amountOfDiamondsText = NSLocalizedString("PurchaseVC.Label.amountOfDiamondsText", comment: "amountOfDiamondsText")
label.text = String.localizedStringWithFormat(amountOfDiamondsText, amountOfDiamonds) // print 1,000 顆鑽石

直接透過 Key 讀取
單純讀取文字的時候透過 NSLocalizedString("文字對應的KEY", comment: "這邊可以為空，也可以寫這個文字的意思")
讀取的內容需要傳入參數
遇到在數值前後的文字，可以在要轉換的文字中加上 %d，透過NSLocalizedString 取得文字，再透過 String.localizedStringWithFormat(文字, 數值) 就能完美讀取有數值的文字拉
Enum 讀取字串

enum ProductID: String, CaseIterable {
    case diamonds100 = "Item01"
    case aiChatfor1Week = "Item06"
    
    var productName: String {
        switch self {
        case .diamonds100:
            return NSLocalizedString("diamonds100", comment: "diamonds100")
        case .aiChatfor1Week:
            return NSLocalizedString("aiChatfor1Week", comment: "aiChatfor1Week")
    }
}

// Localizable.string 內
"diamonds100" = "100 顆鑽石"
"aiChatfor1Week" = "AI 聊天/ 週";

小撇步

enum 定義 Key 不容易打字錯誤

enum LocalizedKey: String { 
   case label_greeting, label_amountOfDiamondsText, btn_logIn, btn_logOut, alert_noRestore, alert_restoreSuccess, alert_cantBuy, alert_productName, alert_pleaseLogIn, alert_accountNPass 
   case label_psw, label_account, label_language, label_thrLogIn, label_welcome, label_server, label_buyDiamond, btn_restore, label_system 
   
   var str: String { self.rawValue }
}

String Extension

extension String {
    
    var localizable: String {
        // 吃 LanguageManager 被賦予的 languageType
        if let manager = LanguageManager.shareInstance() as? LanguageManager,
           let path = Bundle.main.path(forResource: manager.languageType, ofType: "lproj"), let bundle = Bundle(path: path) {
            return NSLocalizedString(self, tableName: nil, bundle: bundle, value: "", comment: "")
        }
        return self
    }
}

// Localizable file
"memberCenter" = "會員中心";

// call
mylabel.text = "memberCenter".localizable

實作過後分享，Main.strings 的小缺點：
如果有新增的頁面或新增的 label or button，自己手動加 objectID 進去 Main.string 檔案後系統還是會吃不到，我的方式會最後才建立多國語言這個步驟，或是將要新增的文字直接加去 Localizable.strings 內，再拉 label or button 的 IBOutlet 進 ViewController，將文字指派給他

下一篇介紹如何包裝寫成一個完整的 LanguageManager 🤩

參考其他大大文章

在 APP 內切換語系(iOS Localized)

【iOS】#31 多語系設定 Localization

Swift之本地国际化与App内切换语言