ios 国际化配置 ios开发国际化

转载

mob64ca13f8b166 2024-06-17 08:07:14

文章标签 ios 国际化配置 IOS国际化 IOS本地化国际化本地化 文章分类 iOS 移动开发

一个iOS应用程序，如果想要在多个国家和地区的AppleStore上架，是很简单的一件事情。如果想要每个国家和地区的用户都能获得良好的使用体验，首先需要做的一件事情就是能够让用户打开App的第一时间，看到的是自己熟悉的语言。也就是说App能够根据用户当前所使用的语言或者用户手动选择的语言，实时的改变App内的语言。这就是iOS国际化所要实现的目的。

国际化开发的两种情况

1.在App开发之初，就已经有了国际化开发的Future，这种情况下进行国际化是很容易的，只要在开发过程中把需要国际化的字符串进行简单的处理即可。

2.已经开发完毕，开发之初并没有进行国际化适配，突然来需求说需要进行国际化，此时面对项目中成百上千的字符串，内心一定是崩溃的。

接下来，我会分别对这两种情况来说一下开发过程。

注:演示所使用的Xcode版本为7.3。

新启动的工程

项目国际化配置

1.找到Project的Localizations选项，点击加号(+)，添加需要国际化的语言(一般工程中默认支持英文，为了方便演示，我只添加了中文简体支持)。此时会弹出一个选择框，选择你所要支持的Xib文件或StoryBoard文件。不需要支持Xib或StoryBoard文件则不勾选。

这里Use Base Internationalization开启状态下，每个国际化资源文件会有个Base选项，主要针对String，Xib，Storyboard作为一个基础的模板。

ios 国际化配置 ios开发国际化_本地化

是否添加Xib支持

ios 国际化配置 ios开发国际化_IOS本地化_02

添加多语言支持

2.创建多语言文件，一般命名为Localizable.string。如果在开发过程中不指定文件名，系统会默认在Bundle中寻找这个名称的文件。当然，也可以任意命名，在开发过程中手动指定一下文件名即可。

ios 国际化配置 ios开发国际化_国际化_03

添加多语言文件

3.找到并选中刚刚新建的Localizable.string文件，点击Inspector下Localization选项下的Localize按钮，任意选择一个语言(我选择的是English)，然后点击Localize按钮，此时Localization选项会出现应用支持的语言列表，选择需要国际化的语言，Localizable.string文件下则会多出和所选择语言对应的子文件。

ios 国际化配置 ios开发国际化_IOS国际化_04

点击Localize按钮

ios 国际化配置 ios开发国际化_本地化_05

选择语言

ios 国际化配置 ios开发国际化_国际化_06

出现语言列表

ios 国际化配置 ios开发国际化_IOS本地化_07

添加需要国际化的语言

代码中对国际化内容的适配

1.我在ViewController中初始化了一个Label，并用NSLocalized宏对这个Label的字符串进行国际化适配。

- (void)viewDidLoad {
    [super viewDidLoad];
    
    UILabel *localizationLabel = [[UILabel alloc] initWithFrame:CGRectMake(150, 200, 100, 20)];
    [self.view addSubview:localizationLabel];
    
    //利用NSLocalizedString宏对字符串进行国际化适配
    localizationLabel.text = NSLocalizedString(@"Hello", @"description for this key.");
    
}

既然用到了NSLocalizedString宏，我们就有必要了解一下这个宏到底干了什么。

NSLocalizedString宏探秘

点进宏定义文件：

#define NSLocalizedString(key, comment) \
        [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:nil]
#define NSLocalizedStringFromTable(key, tbl, comment) \
        [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:(tbl)]
#define NSLocalizedStringFromTableInBundle(key, tbl, bundle, comment) \
        [bundle localizedStringForKey:(key) value:@"" table:(tbl)]
#define NSLocalizedStringWithDefaultValue(key, tbl, bundle, val, comment) \
        [bundle localizedStringForKey:(key) value:(val) table:(tbl)]

#define NSLocalizedString(key, comment) \
        [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:nil]
#define NSLocalizedStringFromTable(key, tbl, comment) \
        [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:(tbl)]
#define NSLocalizedStringFromTableInBundle(key, tbl, bundle, comment) \
        [bundle localizedStringForKey:(key) value:@"" table:(tbl)]
#define NSLocalizedStringWithDefaultValue(key, tbl, bundle, val, comment) \
        [bundle localizedStringForKey:(key) value:(val) table:(tbl)]

我们会发现国际化相关所定义的4个宏。

NSLocalizedString(key, comment)

NSLocalizedString其实是从mainBundle中默认读取了Localizable.string中的key所对应的value。comment参数则是对key的描述，有利于翻译人员理解这个key所适用的场景。

NSLocalizedStringFromTable(key, tbl, comment)

NSLocalizedStringFromTable则是从mainBundle中读取指定多语言文件中的key所对应的value。tbl参数就是用于指定多语言文件名的参数。

NSLocalizedStringFromTableInBundle(key, tbl, bundle, comment)

NSLocalizedStringFromTableInBundle会读取指定Bundle中所指定的多语言文件中的key所对应的value。bundle参数就是用于传入所指定的Bundle。

NSLocalizedStringWithDefaultValue(key, tbl, bundle, val, comment)

NSLocalizedStringWithDefaultValue则是从指定Bundle中读取指定多语言文件中的key所对应的value，如果取不到对应的value，允许指定一个默认的value。val参数就是用于传入默认的value值。

2.了解了各个宏定义所代表的含义，我们继续往下写。

在Localizable.strings(English)中加入如下键值对：

"Hello" = "Hello";

在Localizable.strings(Chinese(Simplified))中加入如下键值对：

"Hello" = "你好";

编译运行：

系统语言为英文时显示效果：

ios 国际化配置 ios开发国际化_ios 国际化配置_08

英文运行结果

系统语言为中文时显示效果：

ios 国际化配置 ios开发国际化_IOS国际化_09

中文运行结果

可见，文本会随着系统语言的改变而改变。至此，一个简单的可以跟随系统语言切换的Demo就完成了。

已开发多个版本的工程

工程开发了许久，代码也写了几万行了，这时Boss突然说要进行国际化适配。

What the ***!!!

淡定，除了女朋友，还有什么能难道程序猿哥哥的事情呢？

下面开始。

添加应用需要国际化的语言

在Project的Localizations选项，点击加号(+)，添加需要国际化的语言(一般工程中默认支持英文，为了方便演示，我只添加了中文简体支持)。

批量替换字符串

既然要在已有工程上进行适配，首先要做的就是给需要进行国际化的字符串加上NSLocalizedString宏了。

2B程序猿

会一处一处的修改每个文件的每处字符串，直到天荒地老、海枯石烂。

非主流程序猿

各种shell、Python脚本齐上阵。

文艺程序猿

Xcode大法好。正则大法好。

我选择第三种-。-

首先，我们需要一个正则，去匹配工程中所有需要替换的文本。如果你不太了解正则，点我点我！！。

下面这个正则可以匹配到所有符合OC字符串格式的包含有中文的字符串。如果你用Swift，请去掉@。

@"[^"]*[\u4E00-\u9FA5]+[^"\n]*?"

然后，重点来了。Command+Shift+F，进入全局搜索引擎，切换为Replace模式，并把匹配模式改为Regular Expression。

在搜索条件里输入(@"[^"]*[\u4E00-\u9FA5]+[^"\n]*?")，在下面替换内容里输入NSLocalizedString($1, nil)。此处正则表达式两边加括号的目的是为了能够在替换时用$1获取原有字符串的值，在替换时把原有值放入宏定义内key的位置。然后，搜索，可以看到搜索结果，点击Replace All，即可完成替换。

ios 国际化配置 ios开发国际化_IOS国际化_10

正则搜索

生成多语言文件

替换完了原有字符串，下面就是生成多语言文件了。作为一个文艺程序猿，我是不可能一处一处的把项目中的字符串挑出来再写到Localizable.strings文件里的。

好在Xcode自带了一个命令行工具genstrings。我们可以利用这个工具生成所需的多语言文件。

首先，我们需要先新建所需语言的文件夹。

cd 工程目录
mkdir en.lproj
mkdir zh-Hans.lproj

然后，遍历所有.m文件，根据每个文件内的需要国际化的字符串生成key和value。

find . -name *.m | xargs genstrings -o en.lproj
find . -name *.m | xargs genstrings -o zh-Hans.lproj

此时，en.lproj和zh-Hans.lproj文件夹中就应该有了相应的Localizable.string文件了。

我们把这两个文件夹拖到工程里，然后在相应的Localizable.strings文件中，修改每个key所对应的value值就行了(这个应该是翻译干的事儿)。

至此，项目的国际化已经适配完成。

应用内动态更新语言

以上所做的国际化，只会跟随系统语言进行改变，并且需要Kill掉App重新打开才会有效果。如果有一种需求，在应用内有一个语言列表，只要选中其中一种语言，点击确定后就能立刻更新应用内所有界面的语言，此时该怎么做呢？目前有好多大厂应用，比如微信、支付宝等都支持这种切换方式(微信和支付宝的实现方式不太一样，咱们稍后再叙)。

替换系统国际化宏定义

由系统宏定义可知，如果使用了系统的NSLocalizedString宏，它是默认是从mainBundle中读取Localizable.strings中的value的。使用其他的3个宏则可以指定文件名或是Bundle，但是使用起来也是不太灵活。为了使用起来更加方便灵活，我们可以自定义一个国际化的宏，实现其内部的逻辑。

下面，给出一种我自己的实现方式。

//
//  LELocalizedHelper.h
//  Created by 金小白 on 16/4/23.
//  Copyright © 2016年 xiaolei.jin. All rights reserved.
//  国际化

#import <Foundation/Foundation.h>

#define LELocalizedString(key) [[LELocalizedHelper standardHelper] stringWithKey:key]

@interface LELocalizedHelper : NSObject

+ (instancetype)standardHelper;

- (NSBundle *)bundle;

- (NSString *)currentLanguage;

- (void)setUserLanguage:(NSString *)language;

- (NSString *)stringWithKey:(NSString *)key;

@end

//
//  LELocalizedHelper.m
//  Created by 金小白 on 16/4/23.
//  Copyright © 2016年 xiaolei.jin. All rights reserved.
//  国际化

#import "LELocalizedHelper.h"

static NSBundle *_bundle;

static NSString *const kUserLanguage = @"kUserLanguage";

@implementation LELocalizedHelper

+ (instancetype)standardHelper {
    static LELocalizedHelper *helper;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        helper = [[LELocalizedHelper alloc] init];
    });
    return helper;
}

- (instancetype)init {
    
    if (self = [super init]) {
        
        if (!_bundle) {
            
            NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
            
            NSString *userLanguage = [defaults valueForKey:kUserLanguage];
            
            //用户未手动设置过语言
            if (userLanguage.length == 0) {
                
                NSArray *languages = [[NSBundle mainBundle] preferredLocalizations];
                
                NSString *systemLanguage = languages.firstObject;
                
                userLanguage = systemLanguage;
            }
            
            if ([userLanguage isEqualToString:@"zh-HK"] || [userLanguage isEqualToString:@"zh-TW"]) {
                userLanguage = @"zh-Hant";
            }
            
            NSString *path = [[NSBundle mainBundle] pathForResource:userLanguage ofType:@"lproj"];
            
            _bundle = [NSBundle bundleWithPath:path];
        }
        
    }
    return self;
}

- (NSBundle *)bundle {
    return _bundle;
}

- (NSString *)currentLanguage {
    
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    
    NSString *userLanguage = [defaults valueForKey:kUserLanguage];
    
    if (userLanguage.length == 0) {
        
        NSArray *languages = [[NSBundle mainBundle] preferredLocalizations];
        
        NSString *systemLanguage = languages.firstObject;
        
        return systemLanguage;
    }
    
    return userLanguage;
}

- (void)setUserLanguage:(NSString *)language {
    
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    
    NSString *path = [[NSBundle mainBundle] pathForResource:language ofType:@"lproj"];
    
    _bundle = [NSBundle bundleWithPath:path];
    
    [defaults setValue:language forKey:kUserLanguage];
    
    [defaults synchronize];
}

- (NSString *)stringWithKey:(NSString *)key {
    
    if (_bundle) {
        return [_bundle localizedStringForKey:key value:nil table:@"Localizable"];
    }else {
        return NSLocalizedString(key, nil);
    }
}

@end

使用的时候，只需把原来NSLocalizedString(key, nil)的地方替换为LELocalizedString(key)即可。此时如果用户没有手动更改过语言，默认是跟随系统语言变化的。

动态刷新所有页面

替换完了宏定义，下面就是全局刷新界面了。实现方式上来说，我目前共想出了3种，实现方式上来说各有优劣。

重新载入rootViewController

这个方法应该是编码成本最低的方法了，只需要把原有的rootViewController移除并清空，然后重新设置一遍rootViewController就行了。但是这种实现方式会重新加载已经原来已经加载好的所有界面。

语言改变发送通知

在用户切换语言的时候，发送一个通知，然后在各个界面接收通知，更新所有需要更新的文本即可。这种方法适合新建的项目，在代码编写之初就预留好更新文本的方法，收到通知后调用此方法就行。如果已经是一个已上线项目，则改动成本比较高，需要改动的地方比较多。

.h暴露一个更新文字的方法

在用户切换语言的时候，遍历所有已经加载的界面，调用更新文字的方法。这种实现也是比较适合新建的项目，在代码编写之初就预留好更新文本的方法。如果项目已上线，则改动成本较高。

上文说过，微信和支付宝的实现方式不太一样。根据我的观察和判断，微信使用的是上面的第一种方法，也就是重新载入rootViewController的方法。因为微信切换完语言之后，迅速的切换到了根页面，又迅速的push到了设置界面，有一个界面跳跃的过程，而且原来所有的已经滑到底部的列表全部都重置到了最顶部。根据我的推断，微信项目在编写之初也是没有考虑到后期国际化的需求，迫于过大的改动成本，只好使用第一种方法。而支付宝切换过程就比较完美，实现了无缝切换，和有可能是前期编码过程中就预留了更新文本的方法，后期直接调用就可以(不排除后期投入精力进行重构的可能)。

以上就是全部的iOS文字国际化的过程。