iOS

最近更新时间:2024-10-14 15:53:41

我的收藏

功能描述

iOS 端 TUIKit默认自带 简体中文、英语 阿拉伯语 语言包,作为界面展示语言。
根据此文档指引,您可以使用默认语言包,也可自定义语言翻译表述和增加其他语言包。
说明:
TUIKit 从 7.5.4852 版本开始,新增 RTL 语言(文字方向从右到左的语言,例如阿拉伯语、希伯来语等)支持,同时内置语言新增了阿拉伯语。
简体中文
英文
阿拉伯语










使用自带语言

如果您的 App 需要的语言仅包括 简体中文、英语 阿拉伯语 ,请参考本部分。

跟随系统语言

直接使用 TUIKit 即可,无需额外步骤。组件内部语言会跟随系统语言。

指定显示的语言

如果您需要指定TUIKit界面语言,请在[TUIGlobalization setPreferredLanguage:@""]中传入需要的语言,指定语言后,组件内部不再跟随系统语言。 语言可选项,取值为:
@"zh-Hans" ,//简体中文
@"en", // 英文
@"ar", // 阿拉伯语
说明
语言代码清单见 附录

使用更多语言/自定义翻译表述

如果您的 App 需要支持更多语言,或更改部分词条的翻译,请参考本部分。
本章节以添加韩语语言包为例,讲解新增语言包和自定义翻译的流程。

新增语言资源文件

我们自带的所有语言包,以String文件模板的形式,存储于您项目里Pods中TUICore组件的TUIKitLocalizable/Localizable/ 路径。

请新建目录并命名为{语言编码}.lproj,在此目录下新增 Localizable.strings文件,其中,${语言编码} 需要替换为 ISO 639-1 语言代码。(可以直接复制您熟悉的语言文件,如zh-Hans.lproj,并直接修改目录名称) 如果您需要兼容支持多个新语言,复制多份,并准确指定每一份的语言编码即可。
以韩语为例,新增ko.lproj/Localizable.strings的语言资源文件:


个性化自定义翻译

上一步已经创建好了韩语资源文件 ko.lproj/Localizable.strings,不同语言资源文件中语言的 key 是相同的,具体内容可以自定义翻译。

跟随系统语言

如果是简体中文、繁体中文、英文、韩语、俄语、乌克兰语,添加完lproj资源包后直接使用TUIKit即可,无需额外步骤。
如果是其他语种,则需要在 TUIGlobalization.m中的+ (NSString *)tk_localizableLanguageKey
新增的语言词条包命名需要 符合标准,组件内部会跟随系统语言自适应。

说明
语言代码清单见 ISO 639-1 语言代码

指定显示的语言

如果您需要指定TUIKit界面语言,请在[TUIGlobalization setPreferredLanguage:@""]中传入需要的语言,指定语言后,组件内部不再跟随系统语言。 语言可选项,取值为 ISO 639-1 语言代码 以韩语为例,传入[TUIGlobalization setPreferredLanguage:@"ko"];
效果如图所示:


附录:语言代码表

语言
代码
语言
代码
阿拉伯语
ar
保加利亚语
bg
克罗地亚语
hr
捷克语
cs
丹麦语
da
德语
de
希腊语
el
英语
en
爱沙尼亚语
et
西班牙语
es
芬兰语
fi
法语
fr
爱尔兰语
ga
印地语
hi
匈牙利语
hu
希伯来语
he
意大利语
it
日语
ja
朝鲜语/韩语
ko
拉脱维亚语
lv
立陶宛语
lt
荷兰语
nl
挪威语
no
波兰语
pl
葡萄牙语
pt
瑞典语
sv
罗马尼亚语
ro
俄语
ru
塞尔维亚语
sr
斯洛伐克语
sk
斯洛文尼亚语
sl
泰语
th
土耳其语
tr
乌克兰语
uk
中文(简体)
zh-Hans
中文(繁体)
zh-Hant
完整版 请见此处