文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

iOS文本的多语言适配和实践

2024-12-14 00:15

关注

[[422312]]

字体包的多语言适配和实践

需求分析

首先,在了解产品需求和设计方案之后,结合业务研发人员的痛点,整理出以下需求。

产品和设计的需求

设计师要求的字体包资源

研发的痛点和需求

总结一下,产品和设计的需求强调字体适配的全局性、多样性、可扩展性,研发关心的是解耦、职责单一、灵活性。

技术设计

分析过后,先确定技术框架的分层。

垂直分层和水平模块

如图所示分3层,1.基础组件提供核心实现,并支持需求扩展 2.业务组件(无相关修改)3.壳工程提供资源包和代理者。

FontPackage组件要负责什么?

壳工程的资源包配置

备注:因为设计师只要求3种字重,默认light字重,这个和系统提供的 UIFontWeight 不太一致。

  1. //壳工程中的配置文件,反序列化传回FontPackage层 
  2. //appfont.json 
  3.     "list": [{ 
  4.         "env" : "vi"
  5.         "note" : "越南语,按照国际编码:vi、vi-VN。FontPackageManager 判断国际编码来对应"
  6.         "data" : [{ 
  7.                 "font" : 0, 
  8.                 "name" : "genjyuu_light(越南细)" 
  9.             },{ 
  10.                 "font" : 1, 
  11.                 "name" : "genjyuu_medium(越南中)" 
  12.             },{ 
  13.                 "font" : 2, 
  14.                 "name" : "genjyuu_bold(越南粗)" 
  15.             } 
  16.         ] 
  17.     }, { 
  18.         "env" : "default"
  19.         "note" : "其他语种默认使用字体,但优先判断设备的国际编码来匹配字体包"
  20.         "data" : [{ 
  21.                 "font" : 0, 
  22.                 "name" : "GothamRndSSm-Light" 
  23.             },{ 
  24.                 "font" : 1, 
  25.                 "name" : "GothamRndSSm-Medium" 
  26.             },{ 
  27.                 "font" : 2, 
  28.                 "name" : "GothamRndSSm-Bold" 
  29.             } 
  30.         ] 
  31.     } 
  32. ]} 

添加字体包和配置文件,还有冷启动流程:

冷启动流程图

技术开发

FontPackage 功能组件共3个Class,200+行代码。

首先,在冷启动时候 FontPackage 根据 json 配置缓存语言编码匹配到的字体包资源 Model。

然后使用 runtime hook UIFont 类的几个构造函数,更换构造函数的 fontName 参数。目前确定5个构造函数:

  1. //已处理 
  2. + (UIFont *)systemFontOfSize:(CGFloat)fontSize; 
  3. + (UIFont *)systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight; 
  4. + (UIFont *)boldSystemFontOfSize:(CGFloat)fontSize; 
  5. + (UIFont *)italicSystemFontOfSize:(CGFloat)fontSize; 
  6. + (UIFont *)fontWithName:(NSString *)fontName size:(CGFloat)fontSize; 

最后统一使用 +fontWithName:size: 函数初始化,fontName 为自定义字体包。

函数 -fontpackage_name: 根据原 fontName 更换为对应的自定义字体包。

 

  1. //FontPackageExtension.m  
  2. //UIFont+FontPackage.m  
  3.  

    #pragma mark - Hook

  4.  
  5. + (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight { 
  6.     NSString *fontName = @""
  7.     if (weight == UIFontWeightMedium) { 
  8.         fontName = @"medium"
  9.     } else if (weight > UIFontWeightMedium) { 
  10.         fontName = @"bold"
  11.     } 
  12.     return [self fontWithName:fontName size:fontSize]; 
  13.  
  14. + (UIFont *)xxxFontPackage_italicSystemFontOfSize:(CGFloat)fontSize { 
  15.     //斜体默认是medium 
  16.     return [self fontWithName:@"medium" size:fontSize]; 
  17.  
  18. + (UIFont *)xxxFontPackage_boldSystemFontOfSize:(CGFloat)fontSize { 
  19.     return [self fontWithName:@"bold" size:fontSize]; 
  20.  
  21. + (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize { 
  22.     return [self fontWithName:@"" size:fontSize]; 
  23.  
  24. + (UIFont *)xxxFontPackage_fontWithName:(NSString *)fontName size:(CGFloat)fontSize { 
  25.     fontName = [self fontpackage_name:fontName]; 
  26.     return [self xxxFontPackage_fontWithName:fontName size:fontSize]; 
  27.  
  28.  
  29.  
  30. + (NSString *)fontpackage_name:(NSString *)fontName { 
  31.     fontName = [fontName lowercaseString]; 
  32.     FontPackageFont replaceFont = FontPackageFontLight; //默认light 
  33.     if ([fontName containsString:@"medium"]) { 
  34.         replaceFont = FontPackageFontMedium; 
  35.     } else if ([fontName containsString:@"bold"]) { 
  36.         replaceFont = FontPackageFontBold; 
  37.     } 
  38.     //匹配替换的字体 
  39.     NSString *replaceFontName = [[FontPackageManager shareInstance].fontPackageInfo.dataMap objectForKey:@(replaceFont)]; 
  40.     return replaceFontName; 

文本信息的多语言适配和实践

针对海外用户做语言本地化也是一项重要的产品功能,但很多组件在开发之初并未预留本地化拓展的接口,客户端需要提供一套优雅的解决方案来应对此问题。

需求分析

产品和设计的需求

技术要求

技术设计

垂直分层和水平模块

如图所示分3层:1、基础组件提供需求扩展 2、业务组件(基本不需要修改,如有特殊属性需求可以依赖基础组件)3、壳工程提供资源包和以及资源包的更新

LocalizedString 组件要负责什么?

语言包目录如下:

语言包目录

可以看到,语言包是按照语言码进行命名的,方便在使用中及时定位到对应文件并读取(存在多种编码的语言,统一使用其基础类)。同时,在壳工程中会对本地语言包进行刷新,App启动后会检查是否有新的语言包可用,如果有会保证数据同步。

配置好语言包后,接下来需要冷启动时初始化LocalizedString 组件。启动时组件任务流程图如下:

冷启动流程图

技术开发

考虑到字符串最终都会依托于 UILabel 进行展示,[UILabel setText:]会作为设置展示文本的唯一收口。所以我们对[UILabel setText:]进行了 hook 和拓展,其内部操作流程图如下:

AOP流程图

LocalizedString 组件有 NSString、UILabel 分类分别做了属性拓展。具体代码如下:

  1. @interface UILabel (Localized) 
  2. @property (nonatomic, assign) BOOL isAutoLocalized; ///< 设置的文字是否要自动转换成本地化的语言,默认YES 
  3. @end 
  4.  
  5. @interface NSString (Localized) 
  6. @property (nonatomic, copy) NSString *oriStr; ///< 上次本地化的字符串原始值 
  7. @property (nonatomic, copy) NSString *localizedStr; ///< oriStr 本地化后的字符串 
  8. @end 

对 UILabel 的分类拓展可以判断 Label 是否需要被本地化;对 NSString 的分类拓展会对本地化后的结果进行缓存,当同一个 string 对象再次本地化时,可以快速从缓存拿到结果减少在 map 中的检索次数、提高效率。类拓展的方式也保证了本组件的侵入性极低。

整个工程使用了 pod 进行集成,基础组件无需声明依赖,对本组件有依赖要求的只在特定业务中出现。hook + pod 的方式保证了本组件的灵活使用和充分解耦。

与NSLocalizedString的兼容

从上面的流程介绍可以看到,本地化替换发生在对 Label 设置文本的时候,不同于 NSLocalizedString 需要先显式本地化再设置文本的方式。所以,当使用方提前对文本进行了本地化,本组件的自动本地化不生效。考虑到本组件主要应用于新语言地区,NSLocalizedString 尚未配置对应的结果,故目前仍然可以使用本组件兜底。我们也会后续优化本组件,完成与 NSLocalizedString 的兼容,更加方便本组的使用。

拓展

由于上述方法只适用于[UILabel setText:]这种形式的无侵入调整,对于字符串拼接的情况,仍需要开发人员使用 LocalizedString 类对子串进行逐一本地化。同时,为了支持以后可能的应用内变更语言,LocalizedString 也提供了动态变更语言包功能。LocalizedString 主要 API 如下:

  1.  
  2. + (NSString *)forKey:(NSString *)key
  3.  
  4.   
  5. + (NSString *)forKey:(NSString *)key langCode:(NSString *)langCode; 
  6.  
  7.  
  8. + (void)setCurrentLangCode:(NSString *)langCode; 

总结

在多个产品同时的迭代情况下,使用组件化已经变得非常普遍,不断地重构优化组件来保证低耦合。当面对国际化场景时,需要沉淀打磨国际化适配框架来支撑业务高效迭代,并且不能给其他业务造成负担。

目前以上功能都已上线,满足了产品的需求,解决了研发的痛点。

作者介绍

吕洪阳,伴鱼 iOS 工程师,伴鱼绘本iOS端负责人

赵杰,伴鱼 iOS 工程师,负责伴鱼绘本客户端研发,功能降级框架等工作

 

来源:伴鱼技术团队内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯