iOS多语言(国际化)开发(跟随系统 + APP内手动设置)

Posted 2020-09-02 Stevin的技术博客

一:跟随系统切换语言

1>创建好项目工程后, 新建一个多语言文件:

2>添加要设置的语言类型:

3>添加成功

细心的朋友可能会发现在English后面写的是3 Files Localized,这是因为英语是系统默认添加的,而且同时为Main.storyboard 和 LaunchScreen.storyboard设置了多语言,我在自己添加的时候没有勾选这两项.

3>使用多语言文件在应用内设置对应语言

"label"="label";
"label"="标签";
"label"="ラベル";

4>在类中为控件赋值

NSLocalizedString的使用,有一个必要的条件,就是:多语言文件名字必须是Localizable,否则到最后显示的只能是key;者中设置完之后只能让应用跟随系统的语言版本进行切换,而用户不能手动进行切换

label.text = NSLocalizedString("label", nil)

相关宏说明

//跟随系统切换, 多语言文件名必须是Localizable
NSLocalizedString("label", nil);
//下面三个都可以手动设置多语言
//第一个参数:是多语言中的key
//第二个参数:是多语言文件的名字
//第三个参数:是对key的注释说明,一般传nil
NSLocalizedStringFromTable(@"label", @"STLocalizable", nil);
//指定多语言文件名和bundle
NSLocalizedStringFromTableInBundle(@"label", @"STLocalizable", bundle, nil);
//在上面的基础上增加一个默认值的参数
NSLocalizedStringWithDefaultValue(@"label", @"STLocalizable", bundle, @"label", nil);

也可以使用NSLocalizedStringFromTable

label.text = NSLocalizedStringFromTable(@"label", @"STLocalizable", nil);

这样在切换系统语言之后,启动应用后APP内部的语言也就跟着切换了

---

二:APP内手动切换语言

1>项目工程Show in Finder后,发现每一种语言都对应一个文件夹,后缀是.lproj,

在APP内切换语言的时候,实际上就是取这些文件夹中的STLocalizable.strings文件

2>获取STLocalizable.strings

获取文件的value值,对应的想要切换语言的话,直接切换pathForResource后面的参数即可

NSString *path = [[NSBundle mainBundle] pathForResource:@"zh-Hans" ofType:@"lproj"];
NSString *labelString = [[NSBundle bundleWithPath:path] localizedStringForKey:@"label" value:nil table:@"STLocalizable"];
NSLog(@"result: %@", labelString);
//输出:MultiLanguage[1887:72599] result: 标签

3>在应用内切换语言,用NSUserDefaults存储当前语言

- (IBAction)changeLanguage:(UIButton *)sender {
    switch (sender.tag) {
        case 10: { //中文
            [[NSUserDefaults standardUserDefaults] setObject:@"zh-Hans" forKey:appLanguage];
        } break;
        case 11: { //日文
            [[NSUserDefaults standardUserDefaults] setObject:@"ja" forKey:appLanguage];
        } break;
        case 12: { //英文
            [[NSUserDefaults standardUserDefaults] setObject:@"en" forKey:appLanguage];
        }  break;
        default:
            break;
    }
}

4>程序退出去后,下次进入继续使用上次关闭程序的语言

//根据NSUserDefaults的key去取多语言类型
NSString *laguageType =[NSString stringWithFormat:@"%@", [[NSUserDefaults standardUserDefaults] objectForKey:@"appLanguage"]];
//在文件目录中确认多语言类型对应的路径
NSString *path = [[NSBundle mainBundle] pathForResource:laguageType ofType:@"lproj"];
//在多语言文件中查找label对应的值
NSString *labelText = [[NSBundle bundleWithPath:path] localizedStringForKey:@"label" value:nil table:@"ASLocalized"];
self.label.text = labelText;

---

扩展

用户第一次启动APP的时候显示什么语言

1>默认设置一种语言,比如英文,在APPDelegate的didFinishLaunchingWithOptions中:

if (![[NSUserDefaults standardUserDefaults] objectForKey:appLanguage]) { 
    //默认设为英文
    [[NSUserDefaults standardUserDefaults] setObject:@"en"  forKey:appLanguage];
}

2>跟随系统语言

需要获取系统的首选语言顺序,然后取第一个首选语言

//获取第一个首选语言
NSString *language = [NSLocale preferredLanguages][0];

或者判断做好的语言版本,在首选语言数组中是否存在

if (![[NSUserDefaults standardUserDefaults] objectForKey:appLanguage]) {
    NSArray  *languages = [NSLocale preferredLanguages];
    NSString *language = [languages objectAtIndex:0];
    if ([language hasPrefix:@"zh-Hans"]) {
        [[NSUserDefaults standardUserDefaults] setObject:@"zh-Hans" forKey:appLanguage];
    } else if ([language hasPrefix:@"ja"] ) {
        [[NSUserDefaults standardUserDefaults] setObject:@"ja" forKey:appLanguage];
    } else {
        [[NSUserDefaults standardUserDefaults] setObject:@"en" forKey:appLanguage];
    }
}

修改系统默认开发语言(默认英语)

多语言开发可能用到的方法

#define LanguageKey @"appLanguage"
//获取当前语言
[[NSUserDefaults standardUserDefaults] objectForKey:LanguageKey];
//获取首选语言顺序
[NSLocale preferredLanguages];
//获取首选语言第一语言
[[NSLocale preferredLanguages] objectAtIndex:0];
//获取系统所有语言
[NSLocale availableLocaleIdentifiers];
//获取当前语言文件路径
NSString *currentLanguage = [[NSUserDefaults standardUserDefaults] ;objectForKey:LanguageKey];
NSString *path = [[NSBundle mainBundle] pathForResource:currentLanguage ofType:@"lproj"];
//根据key获取当前语言对应的本地字符串(参数value:如果key是nil或key在表中找不到本地化字符串，则返回的值。)
NSString *value = [[NSBundle bundleWithPath:path] localizedStringForKey:@"label" value:nil table:@"TiLocalizable"];