{"type":"doc","content":[{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"背景"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"产品被多个国家使用，产品方希望产品拥有更好的多语言使用体验，所以设计师提供多种字体来适配指定的语言。基于以上背景，客户端需要快速给出解决方案并且上线。"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"字体包的多语言适配和实践"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"需求分析"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"首先，在了解产品需求和设计方案之后，结合业务研发人员的痛点，整理出以下需求。"}]},{"type":"numberedlist","attrs":{"start":null,"normalizeStart":1},"content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":1,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"产品和设计的需求"}]}]}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"不同语言，对应字体包不相同。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"全局字体默认使用设计师指定的字体包。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"某些语言的字体包缺少某些字重版本，要求降级使用下一个字重版本。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"存在某些特殊文案不使用全局字体包（例如：中文，它有专属的字体包，和语言环境无关）。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"产品迭代需要快速支持扩展，尽量减少研发投入成本。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"设计师要求的字体包资源"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/4e\/4e3f408855dc8b7d343441bc90a2a06a.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"numberedlist","attrs":{"start":"2","normalizeStart":"2"},"content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":2,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"研发的痛点和需求"}]}]}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"存在公用组件（其他业务线都在使用，伴鱼公共业务组件目前有50+），不能修改通用组件。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"仅壳工程支持且依赖字体包。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"字体包资源来源方式要灵活。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"总结一下，产品和设计的需求强调字体适配的全局性、多样性、可扩展性，研发关心的是解耦、职责单一、灵活性。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术设计"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"分析过后，先确定技术框架的分层。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"垂直分层和水平模块"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/b6\/b6744132240c02863881344feeaf59f1.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"如图所示分3层，1.基础组件提供核心实现，并支持需求扩展 2.业务组件（无相关修改）3.壳工程提供资源包和代理者。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"FontPackage组件要负责什么？"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageManager，负责绑定代理来获取资源包，控制流程逻辑。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageExtension，负责AOP，增加文本属性来满足特殊场景的多样性。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageModel，映射字体包资源的配置信息，明确了使用协议。上层业务可以增加和调整参数来配置字体包资源。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"壳工程的资源包配置"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"env：国际编码， default 表示设计师指定的默认字体。注意有些国际编码代表一种语言，例如英语存在 en-US、en-GB 等多种编码，需要统一为 en。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"font：字重类型，0：light、1：medium、2：bold。斜体默认替换为medium"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"name：字体源文件的名称。例如：GothamRndSSm-Medium"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"备注：因为设计师只要求3种字重，默认light字重，这个和系统提供的 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifontweight","title":null,"type":null},"content":[{"type":"text","text":"UIFontWeight"}]},{"type":"text","text":" 不太一致。"}]},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/壳工程中的配置文件，反序列化传回FontPackage层\n\/\/appfont.json\n{\n \"list\": [{\n \"env\" : \"vi\",\n \"note\" : \"越南语，按照国际编码：vi、vi-VN。FontPackageManager 判断国际编码来对应\",\n \"data\" : [{\n \"font\" : 0,\n \"name\" : \"genjyuu_light（越南细）\"\n },{\n \"font\" : 1,\n \"name\" : \"genjyuu_medium（越南中）\"\n },{\n \"font\" : 2,\n \"name\" : \"genjyuu_bold（越南粗）\"\n }\n ]\n }, {\n \"env\" : \"default\",\n \"note\" : \"其他语种默认使用字体，但优先判断设备的国际编码来匹配字体包\",\n \"data\" : [{\n \"font\" : 0,\n \"name\" : \"GothamRndSSm-Light\"\n },{\n \"font\" : 1,\n \"name\" : \"GothamRndSSm-Medium\"\n },{\n \"font\" : 2,\n \"name\" : \"GothamRndSSm-Bold\"\n }\n ]\n }\n]}"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"添加字体包和配置文件，还有冷启动流程："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"冷启动流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/cb\/cb97aba2022863cedffb17c9063149e9.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术开发"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackage 功能组件共3个Class，200+行代码。首先，在冷启动时候 FontPackage 根据 json 配置缓存语言编码匹配到的字体包资源 Model。然后使用 runtime hook UIFont 类的几个构造函数，更换构造函数的 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 参数。目前确定5个构造函数："}]},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/已处理\n+ (UIFont *)systemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight;\n+ (UIFont *)boldSystemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)italicSystemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)fontWithName:(NSString *)fontName size:(CGFloat)fontSize;"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"最后统一使用 "},{"type":"codeinline","content":[{"type":"text","text":"+fontWithName:size:"}]},{"type":"text","text":" 函数初始化，"},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 为自定义字体包。函数 "},{"type":"codeinline","content":[{"type":"text","text":"-fontpackage_name:"}]},{"type":"text","text":" 根据原 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 更换为对应的自定义字体包。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/FontPackageExtension.m \n\/\/UIFont+FontPackage.m\n\n\n\n+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight {\n NSString *fontName = @\"\";\n if (weight == UIFontWeightMedium) {\n fontName = @\"medium\";\n } else if (weight > UIFontWeightMedium) {\n fontName = @\"bold\";\n }\n return [self fontWithName:fontName size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_italicSystemFontOfSize:(CGFloat)fontSize {\n \/\/斜体默认是medium\n return [self fontWithName:@\"medium\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_boldSystemFontOfSize:(CGFloat)fontSize {\n return [self fontWithName:@\"bold\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize {\n return [self fontWithName:@\"\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_fontWithName:(NSString *)fontName size:(CGFloat)fontSize {\n fontName = [self fontpackage_name:fontName];\n return [self xxxFontPackage_fontWithName:fontName size:fontSize];\n}\n\n\n\n+ (NSString *)fontpackage_name:(NSString *)fontName {\n fontName = [fontName lowercaseString];\n FontPackageFont replaceFont = FontPackageFontLight; \/\/默认light\n if ([fontName containsString:@\"medium\"]) {\n replaceFont = FontPackageFontMedium;\n } else if ([fontName containsString:@\"bold\"]) {\n replaceFont = FontPackageFontBold;\n }\n \/\/匹配替换的字体\n NSString *replaceFontName = [[FontPackageManager shareInstance].fontPackageInfo.dataMap objectForKey:@(replaceFont)];\n return replaceFontName;\n}"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"文本信息的多语言适配和实践"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"针对海外用户做语言本地化也是一项重要的产品功能，但很多组件在开发之初并未预留本地化拓展的接口，客户端需要提供一套优雅的解决方案来应对此问题。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"需求分析"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"1、"},{"type":"text","marks":[{"type":"strong"}],"text":"产品和设计的需求"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"语言本地化"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"未提供本地化的语言，默认使用产品指定的语言"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"快速支持新语言本地化"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"2、"},{"type":"text","marks":[{"type":"strong"}],"text":"技术要求"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"接入成本低，不需要对成熟组件做改动"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"解耦，其他组件无需依赖本功能"}]}]}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术设计"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"垂直分层和水平模块"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/da\/dabe77ded11430fb4d1cc532161f1092.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"如图所示分3层：1、基础组件提供需求扩展 2、业务组件（基本不需要修改，如有特殊属性需求可以依赖基础组件）3、壳工程提供资源包和以及资源包的更新"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"LocalizedString 组件要负责什么？"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedString，负责文字本地化适配。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedTool，负责语言包的配置、读取、更换功能。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedExtension，负责AOP，补充某些属性。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"语言包目录如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"语言包目录"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/cd\/cdfcea8a4451212e79a64c6633d3e40d.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"可以看到，语言包是按照语言码进行命名的，方便在使用中及时定位到对应文件并读取（存在多种编码的语言，统一使用其基础类）。同时，在壳工程中会对本地语言包进行刷新，App启动后会检查是否有新的语言包可用，如果有会保证数据同步。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"配置好语言包后，接下来需要冷启动时初始化LocalizedString 组件。启动时组件任务流程图如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"冷启动流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/bb\/bb2b65413274e448efbba349b4502743.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术开发"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"考虑到字符串最终都会依托于 UILabel 进行展示，"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"会作为设置展示文本的唯一收口。所以我们对"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"进行了 hook 和拓展，其内部操作流程图如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"AOP流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/99\/99d625af1e041f63288a6d2247c658e6.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedString 组件有 NSString、UILabel 分类分别做了属性拓展。具体代码如下："}]},{"type":"codeblock","attrs":{"lang":null},"content":[{"type":"text","text":"@interface UILabel (Localized)\n@property (nonatomic, assign) BOOL isAutoLocalized; \/\/\/< 设置的文字是否要自动转换成本地化的语言，默认YES\n@end\n\n@interface NSString (Localized)\n@property (nonatomic, copy) NSString *oriStr; \/\/\/< 上次本地化的字符串原始值\n@property (nonatomic, copy) NSString *localizedStr; \/\/\/< oriStr 本地化后的字符串\n@end"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"对 UILabel 的分类拓展可以判断 Label 是否需要被本地化；对 NSString 的分类拓展会对本地化后的结果进行缓存，当同一个 string 对象再次本地化时，可以快速从缓存拿到结果减少在 map 中的检索次数、提高效率。类拓展的方式也保证了本组件的侵入性极低。整个工程使用了 pod 进行集成，基础组件无需声明依赖，对本组件有依赖要求的只在特定业务中出现。hook + pod 的方式保证了本组件的灵活使用和充分解耦。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"与NSLocalizedString的兼容"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"从上面的流程介绍可以看到，本地化替换发生在对 Label 设置文本的时候，不同于 NSLocalizedString 需要先显式本地化再设置文本的方式。所以，当使用方提前对文本进行了本地化，本组件的自动本地化不生效。考虑到本组件主要应用于新语言地区，NSLocalizedString 尚未配置对应的结果，故目前仍然可以使用本组件兜底。我们也会后续优化本组件，完成与 NSLocalizedString 的兼容，更加方便本组的使用。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"拓展"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"由于上述方法只适用于"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"这种形式的无侵入调整，对于字符串拼接的情况，仍需要开发人员使用 LocalizedString 类对子串进行逐一本地化。同时，为了支持以后可能的应用内变更语言，LocalizedString 也提供了动态变更语言包功能。LocalizedString 主要 API 如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/**\n @brief 直接返回指定 key 对应的 本地化文字\n @param key 转译文件表中的key\n *\/\n+ (NSString *)forKey:(NSString *)key;\n\n \/**\n @brief 根据指定的 language code，返回key 对应的 本地化文字\n @param key 转译文件表中的key\n @param langCode语言编码\n *\/\n+ (NSString *)forKey:(NSString *)key langCode:(NSString *)langCode;\n\n\/**\n @brief 设置当前默认的语言编码\n @param langCode语言编码\n *\/\n+ (void)setCurrentLangCode:(NSString *)langCode;"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"总结"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"在多个产品同时的迭代情况下，使用组件化已经变得非常普遍，不断地重构优化组件来保证低耦合。当面对国际化场景时，需要沉淀打磨国际化适配框架来支撑业务高效迭代，并且不能给其他业务造成负担。目前以上功能都已上线，满足了产品的需求，解决了研发的痛点。"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"作者介绍"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"吕洪阳，伴鱼 iOS 工程师，伴鱼绘本iOS端负责人"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"赵杰，伴鱼 iOS 工程师，负责伴鱼绘本客户端研发，功能降级框架等工作"}]}]}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"参考"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont","title":null,"type":null},"content":[{"type":"text","text":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont"}]},{"type":"link","attrs":{"href":"http:\/\/www.lingoes.cn\/zh\/translator\/langcode.htm","title":null,"type":null},"content":[{"type":"text","text":"http:\/\/www.lingoes.cn\/zh\/translator\/langcode.htm"}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"作者：吕洪阳、赵杰"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"原文：https:\/\/tech.ipalfish.com\/blog\/2021\/08\/29\/reading_ios_internationlization\/"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"原文：iOS文本的多语言适配和实践"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"来源：伴鱼技术博客"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"转载：著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。"}]}]}
iOS文本的多语言适配和实践
{"type":"doc","content":[{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"背景"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"产品被多个国家使用，产品方希望产品拥有更好的多语言使用体验，所以设计师提供多种字体来适配指定的语言。基于以上背景，客户端需要快速给出解决方案并且上线。"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"字体包的多语言适配和实践"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"需求分析"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"首先，在了解产品需求和设计方案之后，结合业务研发人员的痛点，整理出以下需求。"}]},{"type":"numberedlist","attrs":{"start":null,"normalizeStart":1},"content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":1,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"产品和设计的需求"}]}]}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"不同语言，对应字体包不相同。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"全局字体默认使用设计师指定的字体包。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"某些语言的字体包缺少某些字重版本，要求降级使用下一个字重版本。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"存在某些特殊文案不使用全局字体包（例如：中文，它有专属的字体包，和语言环境无关）。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"产品迭代需要快速支持扩展，尽量减少研发投入成本。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"设计师要求的字体包资源"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/4e\/4e3f408855dc8b7d343441bc90a2a06a.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"numberedlist","attrs":{"start":"2","normalizeStart":"2"},"content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":2,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"研发的痛点和需求"}]}]}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"存在公用组件（其他业务线都在使用，伴鱼公共业务组件目前有50+），不能修改通用组件。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"仅壳工程支持且依赖字体包。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"字体包资源来源方式要灵活。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"总结一下，产品和设计的需求强调字体适配的全局性、多样性、可扩展性，研发关心的是解耦、职责单一、灵活性。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术设计"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"分析过后，先确定技术框架的分层。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"垂直分层和水平模块"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/b6\/b6744132240c02863881344feeaf59f1.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"如图所示分3层，1.基础组件提供核心实现，并支持需求扩展 2.业务组件（无相关修改）3.壳工程提供资源包和代理者。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"FontPackage组件要负责什么？"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageManager，负责绑定代理来获取资源包，控制流程逻辑。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageExtension，负责AOP，增加文本属性来满足特殊场景的多样性。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackageModel，映射字体包资源的配置信息，明确了使用协议。上层业务可以增加和调整参数来配置字体包资源。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"壳工程的资源包配置"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"env：国际编码， default 表示设计师指定的默认字体。注意有些国际编码代表一种语言，例如英语存在 en-US、en-GB 等多种编码，需要统一为 en。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"font：字重类型，0：light、1：medium、2：bold。斜体默认替换为medium"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"name：字体源文件的名称。例如：GothamRndSSm-Medium"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"备注：因为设计师只要求3种字重，默认light字重，这个和系统提供的 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifontweight","title":null,"type":null},"content":[{"type":"text","text":"UIFontWeight"}]},{"type":"text","text":" 不太一致。"}]},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/壳工程中的配置文件，反序列化传回FontPackage层\n\/\/appfont.json\n{\n \"list\": [{\n \"env\" : \"vi\",\n \"note\" : \"越南语，按照国际编码：vi、vi-VN。FontPackageManager 判断国际编码来对应\",\n \"data\" : [{\n \"font\" : 0,\n \"name\" : \"genjyuu_light（越南细）\"\n },{\n \"font\" : 1,\n \"name\" : \"genjyuu_medium（越南中）\"\n },{\n \"font\" : 2,\n \"name\" : \"genjyuu_bold（越南粗）\"\n }\n ]\n }, {\n \"env\" : \"default\",\n \"note\" : \"其他语种默认使用字体，但优先判断设备的国际编码来匹配字体包\",\n \"data\" : [{\n \"font\" : 0,\n \"name\" : \"GothamRndSSm-Light\"\n },{\n \"font\" : 1,\n \"name\" : \"GothamRndSSm-Medium\"\n },{\n \"font\" : 2,\n \"name\" : \"GothamRndSSm-Bold\"\n }\n ]\n }\n]}"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"添加字体包和配置文件，还有冷启动流程："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"冷启动流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/cb\/cb97aba2022863cedffb17c9063149e9.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术开发"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"FontPackage 功能组件共3个Class，200+行代码。首先，在冷启动时候 FontPackage 根据 json 配置缓存语言编码匹配到的字体包资源 Model。然后使用 runtime hook UIFont 类的几个构造函数，更换构造函数的 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 参数。目前确定5个构造函数："}]},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/已处理\n+ (UIFont *)systemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight;\n+ (UIFont *)boldSystemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)italicSystemFontOfSize:(CGFloat)fontSize;\n+ (UIFont *)fontWithName:(NSString *)fontName size:(CGFloat)fontSize;"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"最后统一使用 "},{"type":"codeinline","content":[{"type":"text","text":"+fontWithName:size:"}]},{"type":"text","text":" 函数初始化，"},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 为自定义字体包。函数 "},{"type":"codeinline","content":[{"type":"text","text":"-fontpackage_name:"}]},{"type":"text","text":" 根据原 "},{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont\/1619033-familyname","title":null,"type":null},"content":[{"type":"text","text":"fontName"}]},{"type":"text","text":" 更换为对应的自定义字体包。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/\/FontPackageExtension.m \n\/\/UIFont+FontPackage.m\n\n\n\n+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight {\n NSString *fontName = @\"\";\n if (weight == UIFontWeightMedium) {\n fontName = @\"medium\";\n } else if (weight > UIFontWeightMedium) {\n fontName = @\"bold\";\n }\n return [self fontWithName:fontName size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_italicSystemFontOfSize:(CGFloat)fontSize {\n \/\/斜体默认是medium\n return [self fontWithName:@\"medium\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_boldSystemFontOfSize:(CGFloat)fontSize {\n return [self fontWithName:@\"bold\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize {\n return [self fontWithName:@\"\" size:fontSize];\n}\n\n+ (UIFont *)xxxFontPackage_fontWithName:(NSString *)fontName size:(CGFloat)fontSize {\n fontName = [self fontpackage_name:fontName];\n return [self xxxFontPackage_fontWithName:fontName size:fontSize];\n}\n\n\n\n+ (NSString *)fontpackage_name:(NSString *)fontName {\n fontName = [fontName lowercaseString];\n FontPackageFont replaceFont = FontPackageFontLight; \/\/默认light\n if ([fontName containsString:@\"medium\"]) {\n replaceFont = FontPackageFontMedium;\n } else if ([fontName containsString:@\"bold\"]) {\n replaceFont = FontPackageFontBold;\n }\n \/\/匹配替换的字体\n NSString *replaceFontName = [[FontPackageManager shareInstance].fontPackageInfo.dataMap objectForKey:@(replaceFont)];\n return replaceFontName;\n}"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"文本信息的多语言适配和实践"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"针对海外用户做语言本地化也是一项重要的产品功能，但很多组件在开发之初并未预留本地化拓展的接口，客户端需要提供一套优雅的解决方案来应对此问题。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"需求分析"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"1、"},{"type":"text","marks":[{"type":"strong"}],"text":"产品和设计的需求"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"语言本地化"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"未提供本地化的语言，默认使用产品指定的语言"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"快速支持新语言本地化"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"2、"},{"type":"text","marks":[{"type":"strong"}],"text":"技术要求"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"接入成本低，不需要对成熟组件做改动"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"解耦，其他组件无需依赖本功能"}]}]}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术设计"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"垂直分层和水平模块"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/da\/dabe77ded11430fb4d1cc532161f1092.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"如图所示分3层：1、基础组件提供需求扩展 2、业务组件（基本不需要修改，如有特殊属性需求可以依赖基础组件）3、壳工程提供资源包和以及资源包的更新"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"LocalizedString 组件要负责什么？"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedString，负责文字本地化适配。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedTool，负责语言包的配置、读取、更换功能。"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedExtension，负责AOP，补充某些属性。"}]}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"语言包目录如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"语言包目录"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/cd\/cdfcea8a4451212e79a64c6633d3e40d.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"可以看到，语言包是按照语言码进行命名的，方便在使用中及时定位到对应文件并读取（存在多种编码的语言，统一使用其基础类）。同时，在壳工程中会对本地语言包进行刷新，App启动后会检查是否有新的语言包可用，如果有会保证数据同步。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"配置好语言包后，接下来需要冷启动时初始化LocalizedString 组件。启动时组件任务流程图如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"冷启动流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/bb\/bb2b65413274e448efbba349b4502743.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"技术开发"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"考虑到字符串最终都会依托于 UILabel 进行展示，"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"会作为设置展示文本的唯一收口。所以我们对"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"进行了 hook 和拓展，其内部操作流程图如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"AOP流程图"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"image","attrs":{"src":"https:\/\/static001.geekbang.org\/infoq\/99\/99d625af1e041f63288a6d2247c658e6.png","alt":null,"title":null,"style":[{"key":"width","value":"75%"},{"key":"bordertype","value":"none"}],"href":null,"fromPaste":true,"pastePass":true}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"LocalizedString 组件有 NSString、UILabel 分类分别做了属性拓展。具体代码如下："}]},{"type":"codeblock","attrs":{"lang":null},"content":[{"type":"text","text":"@interface UILabel (Localized)\n@property (nonatomic, assign) BOOL isAutoLocalized; \/\/\/< 设置的文字是否要自动转换成本地化的语言，默认YES\n@end\n\n@interface NSString (Localized)\n@property (nonatomic, copy) NSString *oriStr; \/\/\/< 上次本地化的字符串原始值\n@property (nonatomic, copy) NSString *localizedStr; \/\/\/< oriStr 本地化后的字符串\n@end"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"对 UILabel 的分类拓展可以判断 Label 是否需要被本地化；对 NSString 的分类拓展会对本地化后的结果进行缓存，当同一个 string 对象再次本地化时，可以快速从缓存拿到结果减少在 map 中的检索次数、提高效率。类拓展的方式也保证了本组件的侵入性极低。整个工程使用了 pod 进行集成，基础组件无需声明依赖，对本组件有依赖要求的只在特定业务中出现。hook + pod 的方式保证了本组件的灵活使用和充分解耦。"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","marks":[{"type":"strong"}],"text":"与NSLocalizedString的兼容"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"从上面的流程介绍可以看到，本地化替换发生在对 Label 设置文本的时候，不同于 NSLocalizedString 需要先显式本地化再设置文本的方式。所以，当使用方提前对文本进行了本地化，本组件的自动本地化不生效。考虑到本组件主要应用于新语言地区，NSLocalizedString 尚未配置对应的结果，故目前仍然可以使用本组件兜底。我们也会后续优化本组件，完成与 NSLocalizedString 的兼容，更加方便本组的使用。"}]},{"type":"heading","attrs":{"align":null,"level":3},"content":[{"type":"text","text":"拓展"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"由于上述方法只适用于"},{"type":"codeinline","content":[{"type":"text","text":"[UILabel setText:]"}]},{"type":"text","text":"这种形式的无侵入调整，对于字符串拼接的情况，仍需要开发人员使用 LocalizedString 类对子串进行逐一本地化。同时，为了支持以后可能的应用内变更语言，LocalizedString 也提供了动态变更语言包功能。LocalizedString 主要 API 如下："}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"codeblock","attrs":{"lang":"text"},"content":[{"type":"text","text":"\/**\n @brief 直接返回指定 key 对应的 本地化文字\n @param key 转译文件表中的key\n *\/\n+ (NSString *)forKey:(NSString *)key;\n\n \/**\n @brief 根据指定的 language code，返回key 对应的 本地化文字\n @param key 转译文件表中的key\n @param langCode语言编码\n *\/\n+ (NSString *)forKey:(NSString *)key langCode:(NSString *)langCode;\n\n\/**\n @brief 设置当前默认的语言编码\n @param langCode语言编码\n *\/\n+ (void)setCurrentLangCode:(NSString *)langCode;"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"总结"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"在多个产品同时的迭代情况下，使用组件化已经变得非常普遍，不断地重构优化组件来保证低耦合。当面对国际化场景时，需要沉淀打磨国际化适配框架来支撑业务高效迭代，并且不能给其他业务造成负担。目前以上功能都已上线，满足了产品的需求，解决了研发的痛点。"}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"作者介绍"}]},{"type":"bulletedlist","content":[{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"吕洪阳，伴鱼 iOS 工程师，伴鱼绘本iOS端负责人"}]}]},{"type":"listitem","attrs":{"listStyle":null},"content":[{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"赵杰，伴鱼 iOS 工程师，负责伴鱼绘本客户端研发，功能降级框架等工作"}]}]}]},{"type":"heading","attrs":{"align":null,"level":2},"content":[{"type":"text","text":"参考"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"link","attrs":{"href":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont","title":null,"type":null},"content":[{"type":"text","text":"https:\/\/developer.apple.com\/documentation\/uikit\/uifont"}]},{"type":"link","attrs":{"href":"http:\/\/www.lingoes.cn\/zh\/translator\/langcode.htm","title":null,"type":null},"content":[{"type":"text","text":"http:\/\/www.lingoes.cn\/zh\/translator\/langcode.htm"}]}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null}},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"作者：吕洪阳、赵杰"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"原文：https:\/\/tech.ipalfish.com\/blog\/2021\/08\/29\/reading_ios_internationlization\/"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"原文：iOS文本的多语言适配和实践"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"来源：伴鱼技术博客"}]},{"type":"paragraph","attrs":{"indent":0,"number":0,"align":null,"origin":null},"content":[{"type":"text","text":"转载：著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。"}]}]}
發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章