【Cocos2d-x】支持 i18n 国际化(2)——i18n XML 解析生成头文件
转载请注明出处:http://www.jb51.cc/article/p-tdcedetl-ue.html
1、概述
接 上一节,本节将使用 Python 脚本对 Resources/i18n
文件夹下的文件进行解析,将各个字符串的 key 提取出来,生成一个头文件,供我们使用。解决的问题:
- 自动解析 XML 生成 key 供我们使用;
- C++ 代码中,我们直接使用 namespace 下的常量替代 Hardcode 字符串,防止 key 值变化后,需要替换源代码中所有的 key;
- 遇到不认识的 key,直接可以在编译期发现,而不是在运行期得不到字符串了。
比如,我们有一个配置文件如下:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">射击场</string>
<string name="start_game">开始游戏</string>
<string name="exit_game">结束游戏</string>
<string name="exit_comfirm_tips">确定要退出游戏吗?</string>
<string name="cancel">取消</string>
<string name="exit">结束</string>
<string name="score">得分:</string>
</resources>
我们希望在最终的 Classes/i18n.h
头文件中生成所有的 key:
//
// i18n.h
//
#pragma once
namespace res {
namespace string {
const char* const app_name = "app_name";
const char* const start_game = "start_game";
const char* const exit_game = "exit_game";
const char* const exit_comfirm_tips = "exit_comfirm_tips";
const char* const cancel = "cancel";
const char* const exit = "exit";
const char* const score = "score";
}
}
2、使用方法
那么使用的方法就非常简单了:
auto label = Label::create();
label->setString(res::string::app_name);
label->setTextColor(Color4b::RED);
label->setSystemFontSize(40);
// ...
layer->addChild(label);
3、Python 脚本
Python 脚本也非常简单,通过 os.listdir 列举出 Resources/i81n/
文件夹下的配置文件,将各个文件进行解析,把 key 归类去重,按 namespace 规整,写到 Classes/i18n.h
头文件中即可。
#!/usr/bin/env python
#-*-conding:utf8-*-
#
# @author arnozhang
# @date 2015.11.11
# @email zyfgood12@163.com
import sys;
import os;
import xml.dom.minidom;
I18N_PATH = './Resources/i18n/'
i18n_key_list = []
def new_indent_str(indent = 1):
return ''.join([' ' for i in range(indent * 4)])
def is_xml_node(node,name):
return node \
and node.nodeType == xml.dom.Node.ELEMENT_NODE \
and node.nodeName == name
#
# namespace res {
# namespace string {
# const char* const KEY_XXX = "xxx";
# }
# }
#
def generate_i18n(file):
indent_str = new_indent_str()
res_indent_str = indent_str + indent_str
file.write('namespace res {\n\n')
file.write(indent_str + 'namespace string {\n\n')
list = os.listdir(I18N_PATH)
if list:
for path in list:
generate_by_file(file,I18N_PATH + path,res_indent_str)
file.write(indent_str + '}\n')
file.write('}\n')
def generate_by_file(file,res_file_path,res_indent_str):
dom_tree = xml.dom.minidom.parse(res_file_path)
if not dom_tree:
return
#
# <resources>
# <string name="KEY_XXX">xxx</string>
# </resources>
#
for res in dom_tree.documentElement.childNodes:
if is_xml_node(res,'string'):
key_name = res.getAttribute('name')
if not (key_name in i18n_key_list):
i18n_key_list.append(key_name)
write_string_res(file,key_name,res_indent_str)
def write_string_res(file,res_indent_str):
file.write(res_indent_str)
file.write('const char* const %s = "%s";\n' % (key_name,key_name))
if __name__ == '__main__':
file = open('./Classes/I18n.h',mode = 'w')
file.write('#pragma once\n\n')
generate_i18n(file)
file.close()