国际化多语言

た入场券 2022-01-05 09:17 407阅读 0赞

[官网介绍][Link 1]  
[NSLocalizedString 使用说明][NSLocalizedString]

一、国际化多语言的介绍

App 国际化多语言，就是在 App 里预定义了多种语言的`Localizable.strings`文件，根据设备的系统语言自动识别显示对应的语言，或者是在应用内设置不同的语言识别显示对应的语言。

1、随系统语言国际化  
跟随系统语言进行改变。  
实现时，需要Kill掉App重新打开才会有效果。

2、随应用内语言设置国际化  
应用内部语言不跟随系统语言，由应用自己进行控制，通过配置多个语言文件，根据用户的选择动态获取不同文件夹下的语言文件，显示在界面上。  
最后把用户选择的语言持久化到本地，下次运行时读取。  
实现时，需要动态刷新所有页面，主要有三种方式实现。  
（1） 重新载入rootViewController  
这个方法应该是编码成本最低的方法了，只需要把原有的rootViewController移除并清空，然后重新设置一遍rootViewController就行了。但是这种实现方式会重新加载已经原来已经加载好的所有界面。  
（2）语言改变发送通知  
在用户切换语言的时候，发送一个通知，然后在各个界面接收通知，更新所有需要更新的文本即可。这种方法适合新建的项目，在代码编写之初就预留好更新文本的方法，收到通知后调用此方法就行。如果已经是一个已上线项目，则改动成本比较高，需要改动的地方比较多。  
（3）.h暴露一个更新文字的方法  
在用户切换语言的时候，遍历所有已经加载的界面，调用更新文字的方法。这种实现也是比较适合新建的项目，在代码编写之初就预留好更新文本的方法。如果项目已上线，则改动成本较高。

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

二、国际化多语言使用  
1、应用国际化多语言的情况  
（1）应用名称国际化多语言  
（2）应用内字符国际化多语言  
（3）应用内图标国际化多语言  
2、应用国际化多语言使用技术  
（1） `InfoPlist.strings`该文件定义应用支持的国际化多语言有哪些，同时通过`CFBundleDisplayName = "应用名称";`用于设置应用名称。  
（2）`Localizable.strings`该文件定义应用字符，或图标的国际化多语言，内容以`key-value`的形式存在，通过`NSLocalizedString(key, comment)`进行设置来显示设置后的内容。  
（3）`NSLocalizedString(key, comment)`该宏函数用于跟随系统语言变化时显示`Localizable.strings`不同文件的语言，其中`key`是对应于`Localizable.strings`文件中的`key`，是必须设置的项，`conment`是`key`找不到对应的`value`时默认显示的内容，非必须设置的项。  
（4）`NSLocalizedStringFromTable(key, tbl, comment)`该宏函数用于指定语言文件，使用场景是在应用内改变语言设置，以达到国际化多语言的设置，指定语言文件通常是用户自定义的，其中`key`是对应于用户自定义文件`LocalizableXXX.strings`文件中的`key`，是必须设置的项，`tbl`是用户自定义文件`LocalizableXXX.strings`的名称`LocalizableXXX`，是必须设置的项，`conment`是`key`找不到对应的`value`时默认显示的内容，非必须设置的项。

三、国际化多语言配置  
步骤1 设置`InfoPlist.strings`文件  
1、设置语言种类  
![语言种类设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70]  
2、创建 InfoPlist.strings 文件，并配置对应的多语言文件  
![InfoPlist.strings 文件][InfoPlist.strings]  
![配置语言文件][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 1]  
3、设置应用名称  
![设置应用英文名称][20190623202532548.png]

CFBundleDisplayName = "internationa";

![设置应用中文名称][20190623202546908.png]

CFBundleDisplayName = "国际化";

步骤2 设置`Localizable.strings`文件  
1、创建 Localizable.strings 文件，并配置对应多语言文件  
![Localizable.strings 文件][Localizable.strings]  
![Localizable.strings 语言文件配置][Localizable.strings 1]  
2、配置多语言对应的内容 key-value  
![应用内内容英文设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 2]  
![应用内内容中文设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 3]  
![应用内内容英文设置2][2]

"kNavigationTitle" = "internationa";
    
    "iconImage" = "guanqiadaijiesuo.png";

![应用内内容中文设置2][2 1]

"kNavigationTitle" = "国际化";
    
    "iconImage" = "guanqiatongguo.png";

步骤3 使用`NSLocalizedString(key, comment)`或`NSLocalizedStringFromTable(key, tbl, comment)`  
1、多语言文件  
![多语言配置文件][20190623203051245.png]  
2、多语言字符的使用  
![应用内容值设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 4]

self.navigationItem.title = NSLocalizedString(@"kNavigationTitle", nil);

3、多语言图标的使用  
![应用图标设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 5]

- (void)setUI
    {
        UIImage *image = [UIImage imageNamed:NSLocalizedString(@"iconImage", nil)];
        UIImageView *imageView = [[UIImageView alloc] initWithImage:image];
        [self.view addSubview:imageView];
        imageView.frame = CGRectMake((self.view.frame.size.width - 200.0) / 2, 20.0, 200.0, 200.0);
    }

四、国际化多语言效果  
1、系统语言是中文时，应用名称显示中文，导航栏标题内容显示中文，视图图标显示中文设置图标。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 6]  
2、系统语言是英文时，应用名称显示英文，导航栏标题内容显示英文，视图图标显示英文设置图标。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 7]

> 注意：国际化多语言时，两个默认创建的文件名称分别是`NSLocalizedString`和`Localizable.strings`，且使用时通过`NSLocalizedString(key, comment)`或`NSLocalizedStringFromTable(key, tbl, comment)`宏函数来设置。

[Link 1]: https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPInternational/Introduction/Introduction.html
[NSLocalizedString]: https://nshipster.cn/nslocalizedstring/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70]: /images/20211229/711ebcda2bfb4634a6a0b2cc607b1ce4.png
[InfoPlist.strings]: /images/20211229/b75144792d444694a6cfd6ab96ed4f55.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 1]: /images/20211229/a6ec7f196a38404585913808fa0d9c3d.png
[20190623202532548.png]: /images/20211229/f980d3aa15f7462f8a51a92025e2fa96.png
[20190623202546908.png]: /images/20211229/36c3af261d7f48daa24a1a19ba51e8f1.png
[Localizable.strings]: /images/20211229/3df1a5951df6433e86201d9469eddcec.png
[Localizable.strings 1]: /images/20211229/c2a31373057241b78729718f608ea68a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 2]: /images/20211229/48393f06ca714e6b8638209a9fd186e6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 3]: /images/20211229/c6a7e91796b44c8381bd7afab7402834.png
[2]: /images/20211229/f13333449f5e4acba4210010c49c94a1.png
[2 1]: /images/20211229/b5f102f4e98b4c55a78d0153849f3bf2.png
[20190623203051245.png]: /images/20211229/a90d95ad9ffc41e18771d3500a258f36.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 4]: /images/20211229/d0f43809693e4ea8b86a3a50e650357b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 5]: /images/20211229/0878f076fa774baa932dedc51361cfe6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 6]: /images/20211229/7ac6fe98996340fa9394f09f68a3ea25.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BvdGF0bzUxMg_size_16_color_FFFFFF_t_70 7]: /images/20211229/059ad903c3f844188fddff0df4c6dbdc.png