• UIKit
  • SDK
  • 服务端 API
Chat/
UIKit/
iOS and macOS/
UIKit
  • 界面库介绍
  • Run Demo
  • 快速开始
  • 集成组件
    • TUIKit
    • TUIChat
  • 构建基础界面
    • 聊天界面
    • 会话列表
    • 联系人列表
    • 添加联系人
    • 创建群聊
    • 音视频通话
  • 功能
    • 表情回应
    • 消息引用
    • 已读回执
    • 用户在线状态
    • 文本消息翻译
    • 语音转文字
    • 搜索消息
  • 自定义
    • 自定义消息
    • 自定义表情
  • 本地化
  • 更新日志
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

本地化

功能描述

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










使用自带语言

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

跟随系统语言

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

指定显示的语言

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

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

如果您的 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 setCustomLanguage:@""]中传入需要的语言,指定语言后,组件内部不再跟随系统语言。 语言可选项,取值为 ISO 639-1 语言代码 以韩语为例如[TUIGlobalization setCustomLanguage:@"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
完整版 请见此处