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

作者: 云xiao菲 | 来源:发表于2019-10-17 13:59 被阅读0次

    由于产品需求,在 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 <objc/runtime.h>
    
    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 <Foundation/Foundation.h>
    
    @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 :

    开启主 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 同上。

    开启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 实现远程推送通知国际化

        本文链接:https://www.haomeiwen.com/subject/bzkgyctx.html