iOS开发技巧-国际化(Localization),只看一篇就够了

最近真是超级忙!接到了很多零散的小任务,终于都快结束啦,抽个空做些总结记录。

本文主要涉及iOS的国际化,网上虽然有很多相关的文章,但是仔细阅读下来感觉都不太全面,因此重开一篇总结,记录项目中遇到的所有要点,demo见最下方链接。

1. App名称国际化

2. 图片、文字国际化

3. 强制默认显示某种语言

4. 启动图国际化

5. iOS10所需的权限配置国际化

6. xib/storyboard国际化

7. 总结


1.App名称国际化

非常简单地按步骤修改就可以了。

PROJECT-Info-Localizations中点击下方的小“+”,添加需要添加的语言,本文中以简体中文和英文为例。(国际化的所有操作,都需要这一步作为前提。)


添加以InfoPlist.string为名称的string文件。查到的资料都说需要名称一模一样才能使用,没试过其他的名字。


选中新建好的InfoPlist.string,点击Localize按钮,添加语言。


完成上一步骤后在右边勾选所需要语言,Xcode会自动创建对应的string文件。


分别在对应的string文件中填写App名称就可以了。


*关于Bundle name和Bundle display name:

stackoverflow.com/questions/9667582/bundle-name-and-bundle-display-name

就显示来说,Bundle display name关系着icon下方的App名称文本显示,而Bundle name则作为存储App的文件夹名称,并没有什么影响。


*用以上方法修改App名称的一个问题:

如果系统为有对应string文件的语言时,可以正常显示。

如果系统为无对应string文件的语言时,删除App重装后会跟随设定的开发语言显示;直接修改系统语言时会跟随上一次有对应string文件时的语言显示。

设定开发语言


2.图片、文字

仍是非常简单地按照步骤修改即可。

首先创建一个string文件,名称为Localizable.string。


选中Localizable.string,点击右边的Localize按钮,在弹框的下拉菜单中随便选一个需要添加string文件的语言,确认。(操作同InfoPlist.string的)


右边的小勾要点上,勾选了之后Xcode才会自动创建对应的string文件。


在对应的语言的Localizable.string文件中添加对应的图片名称和文本内容。

"mainImage" = "mainImage_cn";//等号左边为代码需要调用的key,右边为对应的中文图片名称value。

"mainText" = "Chinese";//等号左边为代码中需要调用的key,右边为对应的中文文本value。


最后,只要在代码中需要显示图片和文字的部分使用Foundation框架中的NSLocalizedString(key, comment)调用即可。

// 程序将根据第一个参数去对应语言的文件中取对应的值,第二个参数将转化为字符串文件里的注释,可以传nil,也可以传空字符串@""。

//#defineNSLocalizedString(key,comment) [[NSBundle mainBundle] localizedStringForKey:(key)value:@""table:nil]

//图片调用

UIImageView *imageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:NSLocalizedString(@"mainImage", nil) ]];

//文本调用

textLabel.text = NSLocalizedString(@"mainText", nil);

修改语言后的显示:


*以上的操作后,代码中文字和图片的国际化已经完成了,但是在更换系统语言后会遇到一些问题。

我的项目中只做了简体中文和英文的语言设置,如果系统语言为日文时安装App,App中语言会根据我设置的开发语言显示为英文。如果在App已安装后更改系统语言为日文,则会跟随App上一次的语言设置作相同的显示。这样并不符合我的项目需求,因此我加入了下方的第三部分。



3.强制默认显示某种语言

我的项目需求:在系统语言选定为中文时,App语言为中文,其他情况下全部作英文显示。

因此需要添加系统语言读取,经过判断后直接调用我需要的某种语言对应的值来显示。

//在Appdelegate.m中添加系统语言检测与赋值

NSArray *languages = [NSLocale preferredLanguages];

NSString *language = [languages objectAtIndex:0];

if ([language hasPrefix:@"zh"]) {//检测开头匹配,是否为中文

[[NSUserDefaults standardUserDefaults] setObject:@"zh-Hans" forKey:@"appLanguage"];//App语言设置为中文

}else{//其他语言

[[NSUserDefaults standardUserDefaults] setObject:@"en" forKey:@"appLanguage"];//App语言设置为英文

}

//在需要的部分添加手动选取语言的宏,并调用得到对应的值

//宏

#define Localized(key)  [[NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:[NSString stringWithFormat:@"%@",[[NSUserDefaults standardUserDefaults] objectForKey:@"appLanguage"]] ofType:@"lproj"]] localizedStringForKey:(key) value:nil table:@"Localizable"]

//调用

forceLabel.text = Localized(@"forceText");


选定系统语言为中文,安装App并运行(显示结果为图1),之后修改系统语言为日文(显示结果为图2),使用NSLocalizedString国际化的文字显示为中文,使用自定义宏Localized国际化的文字显示为英文。

图1
图2



4.启动图

启动图国际化的方法有两种,一种是在Info.plist中添加图片(需要导入的图片较多),一种是添加不同的storyboard分别调用(需要导入的图片少些)。操作很简单,但是我在实际使用中遇到了两个问题花费了一些时间,问题将附于下方做一些简述。



4.1 图片+Info.plist使启动图国际化

这个方法同样可以用作App中图片的国际化,但是我比较习惯把图片导入Assets.xcassets中使用,因此在图片国际化中没有做介绍。这个方法主要是在Info.plist中直接配置启动页的参数来展示启动图,下方附上官方的文档。

developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html

首先取消默认的启动图,将TARGET-General-Launch Screen File中默认的LaunchScreen去掉,留空。


导入准备好的启动图,这里我做了3.5、4、4.7、5.5英寸的。之后选中图片,点击Localize按钮,这个步骤和string文件的操作一样,四个图片都要做。


右键点击设置好的片,选中Show in Finder。下图中,en.lproj中保存的是英文版的启动图,zh-Hans.lproj保存的是中文的启动图。把准备好的对应的图片修改名称后拖入就行了,图片名称一定要和工程中导入的一样。


图片准备完毕之后,将Info.plist以源码的形式打开,或者是直接在属性列表中点击“+”添加对应的属性。


Source Code中对应的代码:(demo的Sourcecode Codes中有)


Property List中对应的列表:


删除原先安装的App,重新安装后即可看到效果。


运行后如果看不到启动图更换效果,请删除App后重新运行。



4.2 storyboard+InfoPlist.string使启动图国际化

首先创建作为启动页的storyboard,分别命名区分。我设置的名字是LaunchImage_En和LaunchImage_Ch,名字自己分得清就可以啦。


storyboard中添加ViewController,勾选Is Initial View Controller(中英文的启动页都需要勾选),添加启动图,添加约束占满屏。


设置好后在Info.plist中添加启动图名称。值我填了项目默认的LaunchScreen,但是并不用它作为启动图,后面还要手动赋值。


右键点击Show Raw Keys/Values看一下key。并在InfoPlist.string中手动将一开始创建的两个中英文启动图的storyboard值赋进。

storyboard更改启动图国际化完成。


下面是一开始做国际化时遇到的关于启动图的两个问题。

*想要看到启动图的效果,必须删除原有App后重新安装。查找了一些相关的资料后发现,启动图的资源只会保留一份,在已有的情况下不会重新生成,根据苹果的用户交互指引,该页面是在程序加载时显示的,不建议动态修改。在比较了一些其他的App,例如QQ、DJI GO、淘宝、微博等,有些启动图使用的是可以在不同语言系统下共用的图片,其他的也并没有做动态修改。

*使用storyboard修改启动图时一定要记得在Info.plist中添加Launch screen interface file base name,不然无法显示启动图,运行后会看到App的icon变成了启动图,App的视图大小也会有问题。



5. iOS10所需的权限配置

同storyboard设置启动图国际化。

首先在Info.plist中添加好权限后右键,选择Show Raw Keys/Values看一下key。


把key复制进InfoPlist.string中分别写好对应的中英文描述即可。



6. xib/storyboard国际化

官方文档中有图有真相地描述过啦!

developer.apple.com/library/content/documentation/MacOSX/Conceptual/BPInternational/LocalizingYourApp/LocalizingYourApp.html



7. 总结

iOS的项目国际化中并没有什么难点,主要是找到的一些描述比较含糊或者不全。

国际化其实就是为各个语言单独创建一份资源,通过名称为*.lproj文件夹来保存。在勾选需要的语言后,Xcode会自动创建对应的文件,修改其中的值即可。

demo地址:github.com/Linciay/TYLocalization

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,568评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,612评论 4 59
  • 4月13日微语简报,星期四,工作愉快,生活喜乐! 1、东南沿海高铁调价 一等座最高涨幅超50% 有少量车次下调票价...
    骄傲的帆阅读 188评论 0 1
  • 某: AM01:11 终于,终于是到了冬天吗。 天光一点点变得黯淡但安静,空气也逐渐是了清冷的模样。 不知道你还会...
    九微的一局棋阅读 550评论 0 1
  • 这几天审车的车子,不是违章没处理,就是证件不齐全,时间都耽搁了,有客户要审车,在联系的时候就应该清楚明白的提醒客户...
    捌柒玖零阅读 118评论 0 0