iOS 实现远程推送通知国际化

由于产品需求,在 APP 里增加了语言设置选项,即用户可以在不改变系统语言的情况下,只修改 APP 内的语言。可是如何让远程推送也跟随 APP 语言呢?

每个远程推送通知都包含一个 payloadpayload包含系统要显示给用户的信息,也包括你自定义的数据。有关 payload key 可以看看这里 https://www.zybuluo.com/evolxb/note/482251。

看过上面这篇文章后,小伙伴应该知道了苹果其实提供了实现语言国际化的方案,即通过 loc-keyloc-args 这两个字段。其中 loc-key 是格式化前的内容,loc-args 里面放的是 loc-key 格式化过程中需要用到的参数。比如要向小明同学推送一条消息,内容是:

小明,你的包裹已出发!

小明的手机语言设置成了英文,收到这条推送后,需要显示为:

小明,your package has sent!

那么 loc-keyloc-args 这两个字段就应该这样写:

"loc-key": "%@,你的包裹已出发!",

"loc-args": ["小明"]

如果 app 的 Localizable.strings 文件中有这样的定义:

"%@,你的包裹已出发!"="%@,your package has sent!";

小明收到的推送就将显示为

“小明,your package has sent! ”。

看,就是这么简单!但这还不够,这只是跟随系统语言而已,如果想要跟随 app 语言,还需要做些事情。

推送文案跟随 APP 语言

首先,创建一个 Notification Service Extension,创建方法自己搜一下哈。

然后,在系统自动生成的 NotificationService.m 文件里修改 payload,代码如下:

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
  
    [self configLanguage];  //动态切换语言
    
    self.contentHandler = contentHandler;
    self.bestAttemptContent = [request.content mutableCopy];
    
    NSDictionary *userInfo = self.bestAttemptContent.userInfo;
    NSDictionary *alert = [[userInfo objectForKey:@"aps"] objectForKey:@"alert"];
    NSArray *args = [alert objectForKey:@"loc-args"];
    NSString *content = [alert objectForKey:@"loc-key"];
    if (content.length) {
        self.bestAttemptContent.body = [NSString stringWithFormat:NSLocalizedString(content, nil) array:args];  //根据当前语言进行格式化
    }
    NSString *title = [alert objectForKey:@"title"];
    self.bestAttemptContent.title = title;
  
    self.contentHandler(self.bestAttemptContent);
    
}

- (void)configLanguage {
    NSUserDefaults *sharedUserDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.test"];
    NSString *language = [[self.sharedUserDefaults objectForKey:@"publicSettingKey"] objectForKey:@"kLanguageKey"];
    if (language.length == 0) {
        //APP 目前没有选择语言,则跟随系统
        NSString *systemLanguage = [[[NSUserDefaults standardUserDefaults] objectForKey:@"AppleLanguages"] objectAtIndex:0];
        if (![systemLanguage hasPrefix:@"zh"]) {
            language = @"en";   //产品需求,如果系统语言不是中文,就默认设置为英文
        }
    }
    
    [NSBundle setLanguage:language];

}

NSString 不定参数格式化

+ (NSString *)stringWithFormat:(NSString *)format array:(NSArray *)arguments {
    
    NSRange range = NSMakeRange(0, [arguments count]);
    
    NSMutableData* data = [NSMutableData dataWithLength: sizeof(id) * [arguments count]];
    
    [arguments getObjects: (__unsafe_unretained id *)data.mutableBytes range:range];
    
    NSString *content = [[NSString alloc] initWithFormat:format arguments:data.mutableBytes];
    
    return content;
}

动态切换 APP 语言

NSBundle+Language.m

#import "NSBundle+Language.h"
#import 

static const char _bundle = 0;

@interface BundleEx : NSBundle

@end

@implementation BundleEx

- (NSString *)localizedStringForKey:(NSString *)key value:(NSString *)value table:(NSString *)tableName {
    NSBundle *bundle = objc_getAssociatedObject(self, &_bundle);
    return bundle ? [bundle localizedStringForKey:key value:value table:tableName] : [super localizedStringForKey:key value:value table:tableName];
}

@end

@implementation NSBundle (Language)

+ (void)setLanguage:(NSString *)language {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        object_setClass([NSBundle mainBundle], [BundleEx class]);
    });
    
    objc_setAssociatedObject([NSBundle mainBundle], &_bundle, language ? [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:language ofType:@"lproj"]] : nil, OBJC_ASSOCIATION_RETAIN_NONATOMIC);

}

@end

NSBundle+Language.h

#import 

@interface NSBundle (Language)

+ (void)setLanguage:(NSString *)language;

@end

APP 与 Extension 间数据共享

应该有同学注意到了,APP 的当前语言是从这里 [[NSUserDefaults alloc] initWithSuiteName:@"group.com.test"] 取的。由于 Extension 有自己独立的 Bundle,不能直接访问主 APP 的 Bundle,这时候就要用到苹果的 App Groups 机制了。

开启主 APP 的 App Groups :

iOS 实现远程推送通知国际化_第1张图片
开启主 APP 的 App Groups

被勾选的地方就是我们要设置的 group container identifier,也就是共享数据的 bundle identifier。格式是 "group.xxx",其中 xxx 是 APP 的 bundleID。比如APP 的 bundleID 是 “com.test”,那么 group identifier 就要设置为"group.com.test"。

开启 Extension 的 App Groups,group identifier 同上。

iOS 实现远程推送通知国际化_第2张图片
开启Extension 的 App Groups

这样,APP 和 Extension 就可以通过 group identifier 这个 bundle 来共享数据了。

首先,在 APP 里将 language 写入 [[NSUserDefaults alloc] initWithSuiteName:@"group.com.test"] .

然后,在 NotificationService.m 里就可以读取到 language 了。

总结

如果只是跟随系统语言,那么就使用 loc-key 和 loc-args,这两个字段名不可随意更改。

如果是通过 Notification Service Extension,就不是非要用 loc-keyloc-args 字段了,甚至也不用在 alert 结构里设置,在 payload 的任何地方都可以自行定义字段哦,不要和苹果的字段重复就好~

你可能感兴趣的:(iOS 实现远程推送通知国际化)