最近遇到个需要在应用内部设置语言的需求,默认使用系统设置的语言,如果用户在App内设置了别的语言,以后则按照新设置的语言显示界面。
于是,写了个新轮子SOLocalization,希望大家喜欢,其实代码很简单,有兴趣的可以直接去读源代码,有补充的可以直接向我提交 pull request。
1.创建本地化文件。
创建本地化字符串文件,文件名可以是默认的 infoPlist.strings,也可以是别的,为这个文件设置好要支持的语言及内容。
2.导入 SOLocalization。
3.配置 SOLocalization。
设置支持的语言及默认语言,当系统设置的语言不属于支持的语言时会使用默认语言。
- [SOLocalization configSupportRegions:@[SOLocalizationEnglish, SOLocalizationSimplifiedChinese] fallbackRegion:SOLocalizationEnglish];
4.设置 UIKit 对象。
为 UIKit 对象设置合适的属性,像下面这样简单,而且这样设置后,当语言切换时,这些 UIKit 对象的文本内容会自动变为新设置的语言,不需要任何额外处理。
- UIBarButtonItem *change = [[UIBarButtonItem alloc]initWithTitle:@"" style:UIBarButtonItemStylePlain target:self action:@selector(changeLanguage:)];
- // 这里的 @"Setting" 就是 strings 文件中对应的那个 key,下同
- change.sol_title = @"Setting";
- self.navigationItem.rightBarButtonItem = change;
- self.label.sol_text = @"label";
- [self.button sol_setTitle:@"button" forState:UIControlStateNormal];
- self.textField.sol_placeholder = @"textField placeholder";
- self.navigationItem.sol_title = @"title";
对于 SOLocalization 暂不支持切换语言后自动修改文本内容的 UIKit 对象,可以这样获取需要的本地化字符串:
- // 其中 “title” 为 strings 文件中对应的 key,“infoPlist”是本地化字符串文件名
- NSString *localizedString = SOLocalizedStringFromTable(@"title", @"infoPlist");
5.修改应用内使用的语言
- // to use English
- [SOLocalization sharedLocalization].region = SOLocalizationEnglish;
- // to use 简体中文
- [SOLocalization sharedLocalization].region = SOLocalizationSimplifiedChinese;
6.自定义的本地化字符串文件名
SOLocalization 提供的 API 中,默认使用的本地化字符串文件名为 infoPlist.strings 文件,如果使用其他文件名(比如使用这个文件名:local.strings),如下即可:
- // 对于支持的 UIKit 对象
- label.sol_table = @"local";
- // 使用 SOLocalizedStringFromTable 时
- NSString *localizedString = SOLocalizedStringFromTable(@"title", @"local");