萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS App 多語言本地化完整實戰指南

前言:兩種本地化策略

策略描述適用場景
用戶手動切換App 內提供語言選單,強制切換跨國團隊內部工具、特定業務需求
跟隨系統語言 (推薦)自動讀取 `[NSLocale preferredLanguages]` 切換面向大眾的商業 App、符合平台規範

本文聚焦 **系統語言跟隨模式** 的標準實現流程。

核心機制:.lproj 語言包目錄結構

Project/
├── en.lproj/          # 英文 (基準語言)
│   ├── Localizable.strings
│   ├── InfoPlist.strings
│   └── Main.strings (Storyboard/XIB)
├── zh-Hans.lproj/     # 簡體中文
│   ├── Localizable.strings
│   ├── InfoPlist.strings
│   └── Main.strings
├── zh-Hant.lproj/     # 繁體中文
├── ja.lproj/          # 日文
└── ...

四大本地化維度實戰

1. App 名稱本地化 (CFBundleDisplayName)

  1. New File → **Strings File** → 命名 **InfoPlist.strings**
  2. 選中檔案 → File Inspector → **Localization** → `+` 添加語言 (English, Chinese 等)
  3. 編輯各語言版本:

// InfoPlist.strings (English)
CFBundleDisplayName = "MyApp";

// InfoPlist.strings (Chinese)
CFBundleDisplayName = "我的應用";
  1. `Info.plist` 添加 Key:`Application has localized display name` (Boolean) = YES

2. 代碼字串本地化 (Localizable.strings)

  1. New File → **Strings File** → 命名 **Localizable.strings** (固定名稱)
  2. 同樣添加語言版本
  3. 編輯鍵值對:

// Localizable.strings (English)
"welcome" = "Welcome to MyApp!";
"login.button" = "Login";
"error.network" = "Network error, please retry.";

// Localizable.strings (Chinese)
"welcome" = "歡迎使用我的應用!";
"login.button" = "登入";
"error.network" = "網路錯誤,請重試。";
  1. 代碼中使用宏調用:

NSLog(@"%@", NSLocalizedString(@"welcome", nil));
// 或帶註釋給翻譯參考
NSLog(@"%@", NSLocalizedString(@"login.button", @"登入按鈕標題"));

// 自定義表名 (非 Localizable.strings)
NSLocalizedStringFromTable(@"key", @"MyCustomTable", nil);

3. 圖片資源本地化

方法 A:字串映射法(靈活、不改檔名)


// Localizable.strings
"logo.image" = "logo_en.png";      // English
"logo.image" = "logo_cn.png";      // Chinese

// 代碼
UIImage *logo = [UIImage imageNamed:NSLocalizedString(@"logo.image", nil)];

方法 B:資源檔案本地化(官方標準、Xcode 管理)

  1. 選中圖片 (如 `icon.png`) → File Inspector → Localization `+` 添加語言
  2. Xcode 自動建立 `en.lproj/icon.png`、`zh-Hans.lproj/icon.png`
  3. 分別替換各語言版本圖片檔案(檔名相同)
  4. 代碼**完全不用改**:`[UIImage imageNamed:@"icon.png"]` 自動匹配當前語言

推薦方法 B:Xcode 統一管理、編譯期優化、無字串鍵值維護成本。

4. 其他檔案本地化 (HTML、JSON、Plist、Storyboard、XIB)

同圖片方法 B:選中檔案 → Localization 添加語言 → 各語言目錄下替換內容。

  • Storyboard/XIB:會生成 `.strings` 檔 (如 `Main.strings`),包含所有可見文字鍵值,交給翻譯人員處理
  • HTML/Help:各語言目錄放對應 HTML,代碼載入時用 `[[NSBundle mainBundle] pathForResource:ofType:]` 自動解析

進階技巧與避坑

動態切換語言 (不重啟 App)


// 強制切換語言 (需重啟或手動刷新 UI)
[[NSUserDefaults standardUserDefaults] setObject:@[@"zh-Hans", @"en"] forKey:@"AppleLanguages"];
[[NSUserDefaults standardUserDefaults] synchronize];
// 提示用戶重啟 App

不重啟刷新:需手動遍歷視圖重新賦值 `NSLocalizedString`,或用 `NSNotificationCenter` 通知所有視圖更新。

複數形式支援 (Localizable.stringsdict)

針對「1 條消息 / 3 條消息」等複數規則:


// Localizable.stringsdict (Property List 格式)



    messages.count
    
        NSStringLocalizedFormatKey
        %#@count@
        count
        
            NSStringFormatSpecTypeKey
            NSStringFormatSpecTypeKey
            NSStringFormatValueTypeKey
            d
            zero
            無消息
            one
            %d 條消息
            other
            %d 條消息
        
    



NSString *fmt = NSLocalizedString(@"messages.count", nil);
NSString *result = [NSString stringWithFormat:fmt, count];
// count=0 → "無消息", count=1 → "1 條消息", count=5 → "5 條消息"

測試技巧

  • Scheme → Edit Scheme → Run → Options → **Application Language** / **Application Region** 強制指定
  • 雙語開發模式:`NSDoubleLocalizedStrings` (偽本地化,檢測未本地化字串)
  • 截圖自動化:`fastlane snapshot` 多語言自動截圖上傳 App Store

工作流建議

  1. 開發期:所有字串用 `NSLocalizedString`,Storyboard 勾選 Localization
  2. 功能凍結:導出 `Localizable.strings` 交給翻譯 (Xcode 10+ 支援導出 XLIFF)
  3. 翻譯完成:導入 XLIFF / 手動填入各 `.lproj` 目錄
  4. 測試:全語言跑測試、截圖驗證、長字串截斷檢查
  5. 發布:App Store Connect 填寫各語言元數據、關鍵字、截圖
copyright © 萬盛學電腦網 all rights reserved