最近写项目的时候遇到这样一个需求,要求实现类似微信的多语言功能,
- 可在App内立即切换多语言,不需要重启App
- 下次进入App要记住之前的设置
我在网上找到很多关于多语言的博客,但是绝大多数都是需要重启App,或者下次进入App无法记住之前的设置,还有些就是直接贴了人家代码过来根本不知道为什么这么写。我在看过网上的博客之后,自己写了一个demo,供大家参考。
下面这是效果图:
Demo源代码解析
1.项目配置
2.创建多语言源文件
选择Strings File给文件起个名,最好叫Localizable
,因为我们后面获取语言包就用这个名字
3.点击项目中的文件
4.点击本地化按钮(Localize...)
5.出现弹窗,选择本地化
6.把对应的语言勾选上
这时项目中会多出几个文件,这些文件就是多语言的源文件
7.根据自身项目的需求,按照下面的格式写入对应的语言对
至此,准备工作完成!
8.接下来我们要写一个工具类,管理多语言的切换
下面是源码:
//
// NSBundle+Language.h
// App内切换多语言
//
// Created by 崇 on 2018.
// Copyright © 2018年 崇. All rights reserved.
//
#import <Foundation/Foundation.h>
#define GCLocalizedString(KEY) [[NSBundle mainBundle] localizedStringForKey:KEY value:nil table:@"Localizable"]
@interface NSBundle (Language)
+ (void)setLanguage:(NSString *)language;
@end
//
// NSBundle+Language.m
// App内切换多语言
//
// Created by 崇 on 2018.
// Copyright © 2018年 ChinaChong. All rights reserved.
//
#import "NSBundle+Language.h"
#import <objc/runtime.h>
static NSString *const GCLanguageKey = @"AppLanguagesKey";
@interface BundleEx : NSBundle
@end
@implementation BundleEx
- (NSString *)localizedStringForKey:(NSString *)key value:(NSString *)value table:(NSString *)tableName {
// 当前语言
NSString *currentLanguage = [[NSUserDefaults standardUserDefaults] objectForKey:GCLanguageKey];
// 设置默认语言
currentLanguage = currentLanguage ? currentLanguage : @"zh-Hans";
// 每次需要从语言包查询语言键值对的时候,都按照当前语言取出当前语言包
NSBundle *currentLanguageBundle = currentLanguage ? [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:currentLanguage ofType:@"lproj"]] : nil;
// 下面return中普通 bundle 在调用 localizedStringForKey: 方法时不会循环调用,虽然我们重写了 mainBundle 单例的 localizedStringForKey: 方法,但是我们只修改了 mainBundle 单例的isa指针指向,
// 也就是说只有 mainBundle 单例在调用 localizedStringForKey: 方法时会走本方法,而其它普通 bundle 不会。
return currentLanguageBundle ? [currentLanguageBundle localizedStringForKey:key value:value table:tableName] : [super localizedStringForKey:key value:value table:tableName];
}
@end
@implementation NSBundle (Language)
+ (void)load {
static dispatch_once_t onceToken;
// 保证只修改一次 mainBundle 单例的isa指针指向
dispatch_once(&onceToken, ^{
// 让 mainBundle 单例的isa指针指向 BundleEx 类
object_setClass([NSBundle mainBundle], [BundleEx class]);
});
}
+ (void)setLanguage:(NSString *)language {
// 将当前手动设置的语言存起来
[[NSUserDefaults standardUserDefaults] setObject:language forKey:GCLanguageKey];
[[NSUserDefaults standardUserDefaults] synchronize];
}
@end
工具类的大致思路:
工具类本身是
NSBundle
的类目,用来增加一个切换多语言的方法,
即+ (void)setLanguage:(NSString *)language
.h
里面定义了一个宏GCLocalizedString(KEY)
,用来快速方便的调用方法localizedStringForKey:
。.m
里定义了一个继承自NSBundle
的BundleEx
类,BundleEx
类中重载的父类的localizedStringForKey:
方法,代码中的注释解释了为什么修改isa
指向的类后不会循环调用,这里不再赘述。每一次查询多语言键值对,都是通过当前语言获取的语言包,所以App切换多语言是立即执行的,不用重启App。.m
中后面的部分+ (void)load
方法目的是让程序在启动后,[NSBundle mainBundle]
返回的单例属于BundleEx
类,这样[NSBundle mainBundle]
返回的单例调用localizedStringForKey:
方法就会走BundleEx
类中重载的方法,确保取到正确的语言包。+ (void)setLanguage:(NSString *)language
方法就是单纯的存储当前语言。-
工具类的精髓在于:
- 避免再写一个单例,直接利用
mainBundle
这个现有的单例,减少内存占用。 - 修改
mainBundle
的isa
指向,就会走我们重载的方法。 - 重载的
localizedStringForKey:
方法是其父类NSbundle
的方法,用来获取对应语言包中的语言键值对。
- 避免再写一个单例,直接利用
9.工具类的使用
//
// ViewController.m
// App内切换多语言
//
// Created by 崇 on 2018.
// Copyright © 2018年 崇. All rights reserved.
//
#import "ViewController.h"
#import "NSBundle+Language.h"
@interface ViewController ()
@property (weak, nonatomic) IBOutlet UILabel *label;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self updateLabel];
}
- (IBAction)switchToChinese:(id)sender {
[NSBundle setLanguage:@"zh-Hans"];
[self updateLabel];
}
- (IBAction)switchToEnglish:(id)sender {
[NSBundle setLanguage:@"en"];
[self updateLabel];
}
- (IBAction)switchToKorean:(id)sender {
[NSBundle setLanguage:@"ko"];
[self updateLabel];
}
- (void)updateLabel {
self.label.text = GCLocalizedString(@"皇帝");
}
声明:本文主要结构代码是在网上众多博客参考而来,加上自己理解后加上了一些自己的改动。并非我自己绝对的原创,但是大多数的博客都粘贴复制相同的代码,找不到是谁的原创,如果真身看到了此篇博客还请指出,我会贴上您原作的地址!🙏🙏🙏