一、 前言
在产品进行国际化的过程中,多语言适配是必不可少的环节,前期我们把项目中所有的多语言翻译放到了项目主工程中,各个组件直接去使用并没有什么问题(我们的项目架构是:本地组件 + 私有公共组件),但是有一些公共的模块,要在多个项目中使用,同时也要做多语言适配,就需要把适配文件放到每个子组件中去处理。
二、组件添加多语言适配
在适配多语言的过程中我们尝试了两种解决方案:
方案一:
1、首先用 pod lib create multilingualModule 命令创建一个组件
2、选中 pods 项目,创建一个 Localizable.strings 文件
3、根据以下步骤添加需要适配的多语言
4、把创建的多语言文件放到组件的 Assets 文件中,如图:
至此,适配多语言的流程都已经完成,经过测试,可以顺利的加载到需要适配的语言
按照 cocoapods 官方提倡的方式加载资源文件,在podspec文件中添加下面的代码
s.resource_bundles = {
'multilingualModule' => ['multilingualModule/Assets/*']
}
方案二:
1、首先创建一个与组件同名的 bundle ,并把组件放到组件的 Assets 文件中
2、把按照方案一创建好的多语言文件放到创建好的bundle中 ,如图:
3、在 podspec 文件中,把之前加载资源的方式改成下面这句代码:
s.resource = 'multilingualModule/multilingualModule.bundle'
有人就会问为什么不用官方推荐的方式加载资源了?
s.resource_bundles = {
'multilingualModule' => ['multilingualModule/Assets/*']
}
如果用这种方式加载资源,组件被编译后,就会出现如下的情况,multilingualModule.bundle 中还包含一个 multilingualModule.bundle ,显然,这不是我们期望的结果,且通过以下方式查看:
在项目编译的产物中找到 multilingualModule_Example.app ,并右键显示包内容,如图:
继续右键显示包内容,可以看到我们添加的多语言文件被包含在内层的bundle中,如图:
虽然这种方式也可以正常发布组件,但是我们是希望把所有的资源只包含在一个 bundle中,便于我们管理
三、如何在组件中使用翻译文件
如果我们把翻译文件放到主工程中,通过mainbundle 的方式直接加载即可:
func localValue(str:String) -> String{
let bundle:Bundle = Bundle.main
return bundle.localizedString(forKey: str, value: nil, table: "Localizable")
}
但是组件中的资源文件,在编译的之后,并没有被放到 mainbundle 路径,需要先找到 multilingualModule.bundle 然后再获取资源文件,通过以下方式获取
/// 加载组件内部的多语言(默认必须添加一个英文的多语言)
/// - Parameters:
/// - sourceCls: 当前组件内部的任意类文件
/// - txtStr: 需要翻译的文本的 key
/// - Returns: 翻译后的文本
func localValueWithModule(_ sourceCls: AnyClass,_ txtStr:String)->String{
var crBundle:Bundle? = nil
let sourceClsString = NSStringFromClass(sourceCls)
let list = sourceClsString.components(separatedBy: ".")
let frameWorkBundle = Bundle(for: sourceCls)
let resource = list[0]
if let url = frameWorkBundle.url(forResource: resource, withExtension: "bundle"){
crBundle = Bundle.init(url: url)
}
if crBundle != nil {
let path = crBundle?.path(forResource: getCurrLanString(), ofType: "lproj")
if path?.count ?? 0 > 0 {
//用这个路径生成新的bundle
let bundle = Bundle(path: path!)!
let mes = bundle.localizedString(forKey: txtStr, value: nil, table: "Localizable")
return mes
}
}
return txtStr
}
注意:getCurrLanString() 获取当前需要翻译的多语言
四、总结
在做子组件多语言适配的过程中也遇到了一些奇怪的问题,这里把正确的流程思路记录下,供有需求的同学参考~