gettext库实现国际化

在Windows系统上使用CMake编译一个包含gettext库的C++工程以实现国际化，涉及以下几个步骤。gettext是一个用于国际化（i18n）和本地化（l10n）的库，它允许你的程序支持多种语言。

1. 安装gettext库

首先，你需要在Windows上安装gettext库。你可以通过以下方式之一安装：

• 手动编译：从GNU gettext的官方网站下载源代码，并按照说明在Windows上编译。
• 使用预编译的二进制文件：一些第三方源安装包可能提供预编译的Windows二进制文件，此安装包中可能不存在导入库和头文件，只有dll，此时我们可以通过动态库的显示调用方式加载需要的库接口。
• 使用MSYS2或Cygwin：这些工具提供了一个类似于Linux的环境，可以在其中安装预编译的gettext包。

这里假设你已经安装好了gettext库，并且知道库文件和头文件的路径。

2. 创建CMakeLists.txt文件

假设你的项目结构如下：

my_project/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── po/
│   └── messages.pot
└── include/
    └── gettext.h  (如果存在自定义的头文件)

你的CMakeLists.txt文件可能看起来像这样： 

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 设置C++标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

# 包含源文件目录
include_directories(${PROJECT_SOURCE_DIR}/include)

# 查找gettext库（需要指定路径）
find_library(GETTEXT_LIB gettext PATHS "C:/path/to/gettext/lib")
find_path(GETTEXT_INCLUDE gettext/libintl.h PATHS "C:/path/to/gettext/include")

# 添加源文件
add_executable(MyProject src/main.cpp)

# 链接gettext库
target_link_libraries(MyProject ${GETTEXT_LIB})

# 指定包含目录
target_include_directories(MyProject PRIVATE ${GETTEXT_INCLUDE})

# 指定pot/po/mo文件输出目录
set(POT_FILE ${CMAKE_SOURCE_DIR}/translations/zh_CN/messages.pot)
set(PO_FILE ${CMAKE_SOURCE_DIR}/translations/zh_CN/messages.po)
#set(MO_FILE ${CMAKE_SOURCE_DIR}/translations/zh_CN/messages.mo)

# xgettext.exe提取字符串生成pot文件 
add_custom_command(
    OUTPUT ${POT_FILE}
    COMMAND C:/path/to/gettext/bin/xgettext.exe -o ${POT_FILE} --keyword=_tr src/main.cpp
    DEPENDS src/main.cpp
    COMMENT "xgettext translatable strings to ${POT_FILE}"
)

# msgmerge.exe合并pot文件生成po文件，手动调用msgfmt.exe或者poedit工具翻译po文件，生成mo文件
add_custom_command(
    OUTPUT ${PO_FILE}
    COMMAND C:/path/to/gettext/bin/msgmerge.exe -U ${PO_FILE} ${POT_FILE}
    DEPENDS ${POT_FILE}
    COMMENT "msgmerge translatable strings to ${PO_FILE}"
)

# 调用msgfmt.exe或者poedit工具翻译po文件，生成mo文件
add_custom_command(
    OUTPUT ${MO_FILE}
    COMMAND C:/path/to/gettext/bin/msgfmt.exe -o ${MO_FILE} ${PO_FILE}
    DEPENDS ${PO_FILE}
    COMMENT "msgfmt translatable strings to ${MO_FILE}"
)

 请确保将C:/path/to/gettext/lib和C:/path/to/gettext/include替换为你实际的gettext库和头文件路径。

3. 编写源代码

在src/main.cpp中，你可以使用gettext函数来实现国际化。例如：

#include <iostream>
#include <libintl.h>
#include <locale.h>

#define _tr(text) gettext(text)

int main() {
    // 设置区域和语言环境
    setlocale(LC_ALL, "");
    bindtextdomain("myapp", "C:/path/to/my/locales");
    textdomain("myapp");

    // 输出国际化字符串
    std::cout << _tr("Hello, World!") << std::endl;

    return 0;
}

注意：

• setlocale(LC_ALL, "")：根据环境变量设置区域和语言。
• bindtextdomain("myapp", "C:/path/to/my/locales")：设置.mo文件的目录。
• textdomain("myapp")：设置文本域。

4. 创建语言文件

你需要创建.pot模板文件（例如po/messages.pot），然后生成不同语言的.po文件，再编译成.mo文件。例如：

• po/messages.pot：

msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: en\n"

msgid "Hello, World!"
msgstr "Hello, World!"

msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: zh\n"

msgid "Hello, World!"
msgstr "你好，世界！"

使用msgfmt工具编译.po文件为.mo文件： 

msgfmt -o C:/path/to/my/locales/es/LC_MESSAGES/myapp.mo po/es.po

5. 编译项目

打开命令行，导航到项目目录并运行CMake和编译命令：

mkdir build
cd build
cmake ..
cmake --build .

 如果一切配置正确，你应该能够生成一个可执行文件，并运行它以查看国际化效果。