## 介绍 ## 一款合适项目开发完之后再适配的多语言插件，除了项目内的动态文本，其他一律自动，无代码(当然也可以手动调用)。 ## 使用方法 ## 1. 安装好插件后导入组件【扩展】>【LanguageFramework】>【导入组件】。 2. 点击后项目assets下会生成一个LanguageFramework的文件夹,里面一共有四个脚本(JsonLabel、JsonSprite、JsonUI、JsonUIManager)。
![QQ截图20210907210508.png](https://download.cocos.com/Cocos/CocosStore/markdown/2021/09/036f4c5d83cc45f4653468e0b137ca3d40595.png)
3. 然后就可以开始配置多语言了，首先是Sprite，这里提供了两种，JsonSprite和JsonUI，这两个个区别在于: - JsonSprite是只能绑定挂载这个组件节点的Sprite。 - JsonUI是绑定了自身+所有子节点的Sprite(一般用于整个面板，如主界面、设置界面等等)，**该组件需要搭配Json配置文件食用，配置文件的读取方式可以拖拽Json文件到该组件中，或者填上Json配置文件的路径(从resources下读取，就是Json配置文件需放到resources下)**。 - JsonLabel就是处理绑定节点的文本的(Label、RichText这两组件)。 4. 本插件的JsonUI主要还是靠Json配置文件来驱动，如果手动配置的话很费劲，所以可以使用本插件提供的自动生成Json配置文件工具来提高效率，使用方法如下： > 首先选中一个需要配置的节点，然后点击【扩展】>【LanguageFramework】>【生成JSON文件】
![537KI7N~2KNHN8J6YGQ.png](https://download.cocos.com/Cocos/CocosStore/markdown/2021/09/de5304dbd89f2f225cc8819c816a2ac888890.png)
点击之后注意控制台，会提示生成完成，之后会在assets下生成一个名为LanguageFramework_outs的文件夹(**如果没看到需切换到其他窗口再切回来**)，在该文件夹下会出现和选中节点名称一样的两个Json配置文件，一个是正常使用的Json配置文件，一个是后缀为_Editor的Json配置文件，是给编辑器下使用的(**该文件请不要移动到其他地方**)，那么Json配置文件就生成好了，可以直接给JsonUI使用了。 5. 为了方便在编辑器下调试或者想让该界面在加载的时候再动态加载资源并显示，本插件还提供了一键卸载该面板的所有资源和一键加载该面板的所有资源两个工具，在【扩展】>【LanguageFramework】中可以看到。 6. 如果觉得手动点击本插件提供的工具麻烦，可以使用快捷键: * 生成Json文件 > ctrl+shift+C * 卸载所有资源 > ctrl+shift+X * 加载所有资源 > ctrl+shift+V 7. 对于多语言字符串需要在resources下的language.json
![QQ截图20210907220143.png](https://download.cocos.com/Cocos/CocosStore/markdown/2021/09/5faf7e1508d35de9bf9d66fc8efed08f85541.png)
中配置(导入组件的时候也会一并导入，也会有一个示例在里面),需要的对象有id、和对应语言的缩写(cn、en等，详情可以到JsonUIManager最上面看到),JsonLabel需要绑定一个id，只需填上面配置的id就行，另外一种情况是需要其他地方动态读取的，可以直接使用JsonUIManager.GetLanguage(ID)
![QQ截图20210907220313.png](https://download.cocos.com/Cocos/CocosStore/markdown/2021/09/56e4bec3e3c3679f32938f45908384ae53172.png)
即可获取到。 8. 配置完所有后就可以调用JsonUIManager.Init(需要传入默认使用的语言)来初始化就可以了。 9. 另外还提供了一个可以动态切换语言的API，JsonUIManager.SwitchLanguage()。 10. 最后说说关于资源的存放位置，首先是需要创建使用到的语言的Bundle
![image.png](https://download.cocos.com/Cocos/CocosStore/markdown/2021/09/90f4bbab03be7a2276edc3cd315bbe0316818.png)
**名称要跟缩写一致**，对于语言的图片资源(**含文字的图片**)，需要放在对应Bundle中,**并且每个语言Bundle中的资源名称都需一致(比如一个中文的按钮和对应英文的按钮)**，而其他非含文字的图片不需要放在语言Bundle中。