【Cocos2d-x】支持 i18n 国际化（2）——i18n XML 解析生成头文件

最新推荐文章于 2024-10-30 16:31:50 发布

牧秦丶

最新推荐文章于 2024-10-30 16:31:50 发布

阅读量1.8k

点赞数

CC 4.0 BY-SA版权

分类专栏： C/C++ Cocos2d-x 文章标签： cocos2d-x python xml i18n

本文链接：https://blog.csdn.net/arnozhang12/article/details/49784641

C/C++ 同时被 2 个专栏收录

32 篇文章

订阅专栏

Cocos2d-x

3 篇文章

订阅专栏

本文介绍如何使用Python脚本解析Cocos2d-x项目的XML文件，提取字符串key生成头文件，实现国际化支持。脚本列举指定文件夹中的XML配置文件，提取唯一key，按namespace整理并写入头文件，帮助开发者避免硬编码字符串，便于编译期检查错误。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

【Cocos2d-x】支持 i18n 国际化（2）——i18n XML 解析生成头文件

转载请注明出处：http://blog.csdn.net/arnozhang12/article/details/49784641

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(i18n::getString(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 ' ' * 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, key_name, 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()