iOS国际化方案---看我就够

标签:「国际化」「Objective-C」「genstrings」
作者: JIANGXIN_XIE
审校: IGShare团队

背景


国际化(internationalization)是设计和制造容易适应不同区域要求的产品的一种方式。它要求从产品中抽离所有地域语言,国家/地区和文化相关的元素。换言之,应用程序的功能和代码设计考虑在不同地区运行的需要,其代码简化了不同本地版本的生产。开发这样的程序的过程,就称为国际化。-----引自百度百科

前言


最近因为周会输出,整理了下iOS国际化这块,发现这块坑点还蛮多的,而且网上博客也比较杂,没有一份比较系统的文章,所以想唠叨两句。主要是结合自己之前做国际化的经验,分享下常见的一些坑点和解决方法。附带我们之前的国际化方案。(类似Localization怎么配置、xib/storyboard国际化。。。就不讲了,网上很容易就能找到)

流程


流程图

时间国际化


时间在很多app里都有体现,有些涉及业务,有些只是为了显示。但是在不同时区,时间应该是不一样的,所以我们应该多一些处理,来让应用根据不同的时区来显示时间。

时间国际化是我们在开发中很容易忽视的地方,虽然东西很小,但是影响却很大,因为时间在业务的体现更多是提醒的作用,重中之重。(令人难以置信的是我前后两个公司都有这个问题)

异常场景描述:系统需要对报名课程的用户进行开课提醒,但是因为没有做国际化,所以用户身处国外看到的却是东八区的时间,可想而知是有多坑,熬到了半夜,明明到了上课时间,但是直播课确没有。

what's the fuсk?

注意!

首先我们要和服务端同学规定,凡是系统中和时间相关的字段,都需要返回时间戳格式。时间戳!时间戳!时间戳!(有遇到服务端过于友好,特意转成直接可用的字符串给客户端,所以这个大家要小心,不管做没做国际化。)

如何避免?

其实系统已经帮我们做了这件事,我们要做的是受它支配,乖乖的~不要不反抗~

具体是这样的:众所周知,我们需要通过NSDateFormatter对象将时间戳转换成可用的字符串,NSDateFormatter对象里面有个TimeZone属性,默认是取系统当前时区,那么我们要做的是不去setTimeZone。这样获取到的时间就是当前系统对应的时间,随系统时区切换,时间也会跟着变化。

国际化分两种情况


  • 开发之初就考虑国际化,这种情况做国际化是很容易的,只要在开发过程中对字符串进行简单的处理即可。

  • 已经经历过多个版本的开发,并且一开始就没有做国际化的适配。此时面对项目中成千上万的字符串,内心就崩溃了。我们主要针对这种情况展开讨论。

字符串国际化


已开发多个版本,会面对如下问题

1. 大量字符串未加宏
2. Localizable.strings文件生成
3. storyboard/xib下的strings文件管理

1. 大量字符串未加宏

在已有工程上进行适配,首先要做的就是给需要进行国际化的字符串加上NSLocalizedString宏了。这种情况下一个个修改肯定不现实,工程里面可能有成千上万个字符串。

可以用Replace模式进行替换

  • Command+Shift+F,进入全局搜索引擎
  • 切换为Replace模式,并把匹配模式改为Regular Expression
  • 在搜索条件里输入正则(@“[^”]*[\u4E00-\u9FA5]+[^”\n]*?”),该正则的作用是:匹配到所有符合OC字符串格式的包含有中文的字符串
  • 在下面替换内容里输入NSLocalizedString($1, nil)
    然后进行查找,并Replace
步骤

但是过程并不一定那么顺利

很有可能产生语法错误,这种报错恶心的一匹,而且很难去排查。

可以借助TCZLocalizableTool

iOS 国际化工具,让你的国际化更简单,包含了 iOS 中常用的一些脚本 。

2. Localizable.strings文件生成

NSLocalizedString配置一样,对于已有工程我们不可能把项目中的字符串一处处挑出来再写到Localizable.strings文件里的。

可以利用genstrings生成多语言文件

  • cd 工程目录
  • mkdir en.lproj
  • find ./ -name “*.m" -print0 | xargs -0 genstrings -o en.lproj (去遍历所有的.m子目录文件,去生成Localizable.strings,其中包含keyvalue)
  • en.lproj会生成Localizable.strings文件
  • 然后我们修改每个key所对应的value值就行(这其实是翻译的事)
成功

或者也可以用github上的开源框架ReadChinese

使用起来非常方便,读取某个目录中的所有中文,并且将这些中文按照多语言(.string)格式写入文件中,可以直接拿来实现国际化。

操作示例图

3. storyboard/xib的国际化处理

  • storyboard的国际化非常简单
  • storyboardinspector栏目的localization项勾上后,projectfile navigator那里会多出几个文件
示意图

不足之处

  • storyboard/xib多语言文件中的配置并不会随着控件的增减而变化,需要手动添加。
  • storyboard/xib需要多维护很多语言文件,增加不必要的成本
  • storyboard/xib少用/不用(在项目之初),如果考虑到国际化

也可以这样做

通过python脚本来实现。

原理:假设原来我们就有翻译文件A,添加控件后,我们再执行一次国际化指令,生成文件B,我们拿AB对比,把B中多出来的键值对插入A文件的尾部,将A中有而B中没有的键值对删掉(即控件被删除),这样我们就算是更新了storyboard的翻译文件了。然后每次installing的时候会运行脚本,去重新生成storyboard/xib中的多语言文件。

参考文章:https://www.cnblogs.com/levilinxi/p/4296712.html
参考git:https://github.com/linyu92/MyGitHub

网络请求国际化


采用方案:(可参考)

  • RequestHead中加个lang(en或cn)字段做语言区分
  • 服务端获取到lang,返回对应的数据,一般差异会体现在文案、图片、requestErrorMessage

应用内语言切换


采用方案:(可参考)

  • 默认跟随系统语言:中文(中文简|繁体) 英文(非中文简|繁体)
  • 除了默认语言外,用户可以切换语言,切换成功后就跟随用户设定的语言

设置语言方法[[NSUserDefaults standardUserDefaults] setObject:@"zh-Hans" forKey:currentLanguageKey]

应用内动态更新语言


常用的更新语言方式:

1. reloadRootViewController
2. 通知
3. 预留更新文字的方法

1. reloadRootViewController(成本低)

这个方法应该是编码成本最低的方法了,只需要把原有的rootViewController移除并清空,然后重新设置一遍rootViewController就行了。但是这种实现方式会重新加载已经原来已经加载好的所有界面。

微信用的其实也是这种,在微信内切换语言的时候很明显会感觉到有一个重新载入的过程。可能在项目之初也没有考虑到国际化。

然后因为我们国际化是在之后提出的,所以考虑到成本风险,最后也选用了这种方式,虽然会重新加载,但是毕竟编码成本最低,也不容易出错。建议老项目,时间预留不多的可以用这个。(其实效果也不会那么差)

2. 通知

在用户切换语言的时候,发送一个通知,然后在各个界面接收通知,更新所有需要更新的文本即可。这种方法适合新建的项目,在代码编写之初就预留好更新文本的方法,收到通知后调用此方法就行。如果已经是一个已上线项目,则改动成本比较高,需要改动的地方比较多。

3. 预留更新文字的方法(切换顺畅)

在用户切换语言的时候,遍历所有已经加载的界面,调用更新文字的方法。这种实现也是比较适合新建的项目,在代码编写之初就预留好更新文本的方法。如果项目已上线,则改动成本较高。

支付宝切换过程就比较完美,实现了无缝切换,有可能是前期就预留了更新文本的方法,后期直接调用就可以。建议新项目试试,体验会很好。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容