OpenCC的编译与多语言使用

opencc全称open chinese convert，是一个github上面的开源项目，主要用于简繁体汉字的转换，支持语义级别的翻译。本文就来简单介绍一下该库的编译以及python、c++和java分别如何调用dll进行转换。并记录一些使用过程中踩过的坑。

1.编译dll

我们首先编译得到opencc的dll动态库。

cmake command line

当前工作目录生成vs工程文件

cmake -g "visual studio 14 2015" -d cmake_install_prefix="d:/projects/cnblogs/alpha panda/opencc" ../opencc-ver.1.0.5

编译工程文件

cmake --build ./ --config relwithdebinfo --target install

使用命令行build工程文件。

cmake - gui

下载最新版本cmake，配置工程代码generator，本文使用的visual studio 14 2015。

configure操作过程中需要正确的设置安装路径，这个安装路径决定了dll会去哪个目录下去读取简繁转换的配置文件。

cmake中的变量cmake_install_prefix控制安装路径，其默认值

• unix:/usr/local
• windows:c:/program files/${project_name}

这里设置为：d:/projects/cnblogs/alpha panda/opencc

接着经过generate生成vs工程文件。

visual studio

使用cmake command line或者cmake-gui得到vs工程文件。

打开vs工程，这里我们只编译工程libopencc得到dll文件。为了后续便于使用attach功能调试dll文件，最好将工程配置为relwithdebinfo。

工程libopencc的属性配置寻找一个宏变量：pkgdatadir(pkgdatadir="d:/projects/cnblogs/alpha panda/opencc/share//opencc/")

这个宏变量是源代码根目录下面的cmakelists.txt中设置的，感兴趣的话可以简单了解一下这个变量的设置过程：

cmake_install_prefix = d:/projects/cnblogs/alpha panda/opencc
set (dir_prefix ${cmake_install_prefix})
set (dir_share ${dir_prefix}/share/)
set (dir_share_opencc ${dir_share}/opencc/)
-dpkgdatadir="${dir_share_opencc}"

简繁转换的配置文件必须要放到这个目录下。

2.使用python

利用上面编译得到的libopencc的dll文件，通过python调用来进行字体的转换：(下面的代码改编自 opencc 0.2)

# -*- coding:utf-8 -*-

import os
import sys
from ctypes.util import find_library
from ctypes import cdll, cast, c_char_p, c_size_t, c_void_p

__all__ = ['configs', 'convert']

if sys.version_info[0] == 3:
    text_type = str
else:
    text_type = unicode

_libcfile = find_library('c') or 'libc.so.6'
libc = cdll(_libcfile, use_errno=true)
_libopenccfile = os.getenv('libopencc') or find_library('opencc')
if _libopenccfile:
    libopencc = cdll(_libopenccfile, use_errno=true)
else:
    #libopencc = cdll('libopencc.so.1', use_errno=true)
    # _libopenccfile = find_library(r'g:\opencc\build\src\release\opencc')
    # 貌似不能使用相对路径？
    cur_dir = os.getcwd()
    lib_path = os.path.join(cur_dir, 't2s_translation_lib', 'opencc')
    lib_path = './share/opencc'
    libopencc = cdll(lib_path, use_errno=true)

libc.free.argtypes = [c_void_p]

libopencc.opencc_open.restype = c_void_p
libopencc.opencc_convert_utf8.argtypes = [c_void_p, c_char_p, c_size_t]
libopencc.opencc_convert_utf8.restype = c_void_p
libopencc.opencc_close.argtypes = [c_void_p]
libopencc.opencc_convert_utf8_free.argstypes = c_char_p

configs = [
    'hk2s.json', 's2hk.json',
    's2t.json', 's2tw.json', 's2twp.json',
    't2s.json', 'tw2s.json', 'tw2sp.json',
    't2tw.json', 't2hk.json',
]

class opencc(object):

    def __init__(self, config='t2s.json'):
        self._od = libopencc.opencc_open(c_char_p(config.encode('utf-8')))

    def convert(self, text):
        if isinstance(text, text_type):
            # use bytes
            text = text.encode('utf-8')
        retv_i = libopencc.opencc_convert_utf8(self._od, text, len(text))
        if retv_i == -1:
            raise exception('opencc convert error')
        retv_c = cast(retv_i, c_char_p)
        value = retv_c.value
        # 此处有问题？
        # libc.free(retv_c)
        libopencc.opencc_convert_utf8_free(retv_i)        
        return value

    def __del__(self):
        libopencc.opencc_close(self._od)

def convert(text, config='t2s.json'):
    cc = opencc(config)
    return cc.convert(text)

 上面的这段代码可以当做离线工具来进行文件的转换，并没有线上运行时被调用验证过，可能存在内存泄露，仅供参考。

关于python如何调用dll文件，可以参考我的另一篇文章：python使用ctypes与c/c++ dll文件通信过程介绍及实例分析

使用示例：

origin_text = u'(理发 vs 发财)，(闹钟 vs 一见钟情)，后来'.encode('utf-8')
s2t_1 = convert(origin_text, 's2t.json')
t2s_1 = convert(s2t_1, 't2s.json')
print t2s_1.decode('utf-8')
print s2t_1.decode('utf-8')
print origin_text == t2s_1
============================================
>>>(理发 vs 发财)，(闹钟 vs 一见钟情)，后来
>>>(理髮 vs 發財)，(鬧鐘 vs 一見鍾情)，後來
>>>true

3.使用c++

 下面我们来使用c++来演示一下如何使用opencc进行繁简字体的转换。

由于opencc传入的翻译文本编发方式为utf-8。因此需要对待翻译文本进行编码转换。

string gbktoutf8(const char* strgbk)
{
    int len = multibytetowidechar(cp_acp, 0, strgbk, -1, null, 0);
    wchar_t* wstr = new wchar_t[len + 1];
    memset(wstr, 0, len + 1);
    multibytetowidechar(cp_acp, 0, strgbk, -1, wstr, len);
    len = widechartomultibyte(cp_utf8, 0, wstr, -1, null, 0, null, null);
    char* str = new char[len + 1];
    memset(str, 0, len + 1);
    widechartomultibyte(cp_utf8, 0, wstr, -1, str, len, null, null);
    string strtemp = str;
    if (wstr) delete[] wstr;
    if (str) delete[] str;
    return strtemp;
}

string utf8togbk(const char* strutf8)
{
    int len = multibytetowidechar(cp_utf8, 0, strutf8, -1, null, 0);
    wchar_t* wszgbk = new wchar_t[len + 1];
    memset(wszgbk, 0, len * 2 + 2);
    multibytetowidechar(cp_utf8, 0, strutf8, -1, wszgbk, len);
    len = widechartomultibyte(cp_acp, 0, wszgbk, -1, null, 0, null, null);
    char* szgbk = new char[len + 1];
    memset(szgbk, 0, len + 1);
    widechartomultibyte(cp_acp, 0, wszgbk, -1, szgbk, len, null, null);
    string strtemp(szgbk);
    if (wszgbk) delete[] wszgbk;
    if (szgbk) delete[] szgbk;
    return strtemp;
}

这是在windows平台上两个非常有用的utf8和gbk编码互转函数。

方便起见我们直接在opencc中添加一个新的工程，命名为translation。

#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <string>
#include <windows.h>
#include <fstream>
#include "../opencc-ver.1.0.5/src/opencc.h"
//using namespace std;
using std::cout;
using std::endl;
using std::string;

#define opencc_api_export __declspec(dllimport)

opencc_api_export char* opencc_convert_utf8(opencc_t opencc, const char* input, size_t length);
opencc_api_export int opencc_close(opencc_t opencc);
opencc_api_export opencc_t opencc_open(const char* configfilename);
opencc_api_export void opencc_convert_utf8_free(char* str);

#pragma comment(lib, "../build/src/relwithdebinfo/opencc.lib")
string gbktoutf8(const char* strgbk);
string utf8togbk(const char* strutf8);

int main() {
    char* trans_conf = "s2t.json";
    char* trans_res = nullptr;
    string gbk_str, utf8_str, res;
    // read from file and write translation results to file
    std::ifstream infile;
    std::ofstream outfile;
    infile.open("infile.txt", std::ifstream::in);
    outfile.open("outfile.txt", std::ifstream::out);
    // open the config file
    opencc_t conf_file = opencc_open(trans_conf);
    while (infile.good()) {
        infile >> gbk_str;
        utf8_str = gbktoutf8(gbk_str.c_str());
        std::cout << gbk_str << "\n";
        trans_res = opencc_convert_utf8(conf_file, utf8_str.c_str(), utf8_str.length());
        cout << utf8togbk(trans_res) << endl;
        outfile << trans_res << endl;
        opencc_convert_utf8_free(trans_res);
        // delete[] trans_res;
        trans_res = nullptr;
    }
    infile.close();
    outfile.close();
    opencc_close(conf_file);
    conf_file = nullptr;
    system("pause");
    return 0;
}

 上面的这段c++代码可以从infile.txt中读取简体中文，然后将翻译结果写入到outfile.txt文件中。

3.使用java

这里给出一个使用jna调用dll的方案：

package com.tvjody;

import java.io.unsupportedencodingexception;
import java.io.writer;
import java.nio.charset.standardcharsets;

import com.sun.jna.library;
import com.sun.jna.native;
import com.sun.jna.platform;
import com.sun.jna.pointer;

import java.io.bufferedreader;
import java.io.fileinputstream;
import java.io.filenotfoundexception;
import java.io.ioexception;
import java.io.inputstreamreader;
import java.io.outputstreamwriter;
import java.io.printwriter;
import java.io.reader;
import java.io.fileoutputstream;

public class jna_call {

    public interface openccdll extends library{
        openccdll instance = (openccdll) native.load(
                (platform.iswindows() ? "opencc" : "libc.so.6"),
                openccdll.class);
        
//        void* opencc_open(const char* configfilename);
        pointer opencc_open(string configfilename);
        
//        int opencc_close(void* opencc);
        int opencc_close(pointer opencc);
        
//        void opencc_convert_utf8_free(char* str);
        void opencc_convert_utf8_free(string str);
        
//        char* opencc_convert_utf8(opencc_t opencc, const char* input, size_t length)
        string opencc_convert_utf8(pointer opencc, string input, int length);
    }
    
    public static void writetofile(string utf8_str) throws ioexception {
        writer out = new outputstreamwriter(new fileoutputstream("out.txt"), standardcharsets.utf_8);
        out.write(utf8_str);
        out.close();
    }
    
    public static string readfromfile() throws ioexception {
        string res = "";
        reader in = new inputstreamreader(new fileinputstream("in.txt"), standardcharsets.utf_8);
        try(bufferedreader read_buf = new bufferedreader(in)){
            string line;
            while((line = read_buf.readline()) != null) {
                res += line;
            }
            read_buf.close();
        }
        return res;
    }

    public static void main(string[] args) throws unsupportedencodingexception, filenotfoundexception {
        system.setproperty("jna.library.path", "d:\\projects\\open_source\\opwncc\\build(x64)\\src\\relwithdebinfo");
        pointer conf_file = openccdll.instance.opencc_open("s2t.json");
        try {
            string res_utf8 = readfromfile();
            system.out.println("from： " + res_utf8);
            byte[] ptext = res_utf8.getbytes("utf-8");
//            string utf8_str = new string(res_utf8.getbytes("gbk"), "utf-8");
            string trans_res = openccdll.instance.opencc_convert_utf8(conf_file, res_utf8, ptext.length);
            system.out.println("to：" + trans_res);
//            string trans_gbk = new string(trans_res.getbytes("utf-8"), "gbk");
            writetofile(trans_res);
            openccdll.instance.opencc_convert_utf8_free(trans_res);
        } catch (ioexception e) {
            // todo auto-generated catch block
            e.printstacktrace();
        }
        openccdll.instance.opencc_close(conf_file);
    }
}

json配置文件的路径有dll决定，除了上面手动设置dll文件的路径之外，还可以将dll文件放置到bin目录下。上面使用的是jna-5.2.0。

4.填坑指南

实际上使用时会遇到n多的问题，这里仅列出一些注意事项，其实下面的有些问题具有一些普遍性，较为有价值。

dll读取配置文件路径　

工程中读取json配置文件的路径是用宏变量定义，而cmake的变量make_install_prefix决定了工程中配置文件的宏变量，也决定了dll被调用时读取配置文件的路径。路径中最好使用‘/’，而不是‘\’。

ocd文件的生成

进行简繁体文字转换的过程需要读取json和对应的ocd文件，ocd文件是由工程dictionaries生成的，该工程又依赖与opencc_dict的opencc.exe程序。

实际使用时发现最新的1.0.5版本好像有一个错误，需要将上面的一个函数声明，改为下面的函数声明，否者会有一个链接错误。

void convertdictionary(const string inputfilename, const string outputfilename, const string formatfrom, const string formatto);
opencc_export void convertdictionary(const string inputfilename, const string outputfilename, const string formatfrom, const string formatto);

此外，data目录下生成的所有ocd文件需要和json配置文件放到同一个目录下，32位和64位的ocd文件也不要混用。

32位or64位

在使用java调用dll的时候要特别的注意，如果是64位的jdk，一定要编译64位的dll和所有的ocd文件。否者下面的这个错误会一直缠着你：

java.lang.unsatisfiedlinkerror: %1 不是有效的 win32 应用程序

从两方面简述一下如何正确的生成64位的opencc工程文件。

使用cmake-gui configure直接指定64位的编译器，选择visual studio 14 2015 win64，而不是visual studio 14 2015。

如果当前的工程为32位的工程，可以在vs中通过configuration manager来手动配置为x64位。将32位工程手动改为64位工程可能会有许多的坑，比如：

fatal error lnk1112: module machine type 'x64' conflicts with target machine type 'x86'

下面列举出一些解决方案：

1. check your properties options in your linker settings at: properties > configuration properties > linker > advanced > target machine. select machinex64 if you are targeting a 64 bit build, or machinex86 if you are making a 32 bit build.
2. select build > configuration manager from the main menu in visual studio. make sure your project has the correct platform specified. it is possible for the ide to be set to build x64 but an individual project in the solution can be set to target win32. so yeah, visual studio leaves a lot of rope to hang yourself, but that's life.
3. check your library files that they really are of the type of platform are targeting. this can be used by using dumpbin.exe which is in your visual studio vc\bin directory. use the -headers option to dump all your functions. look for the machine entry for each function. it should include x64 if it's a 64 bit build.
4. in visual studio, select tools > options from the main menu. select projects and solutions > vc++ directories. select x64 from the platform dropdown. make sure that the first entry is: $(vcinstalldir)\bin\x86_amd64 followed by $(vcinstalldir)\bin.

5. check in visual studio:project properties -> configuration properties -> linker -> command line."additional options" should not contain /machine:x86.i have such key, generated by cmake output: cmake generated x86 project, then i added x64 platform via configuration manager in visual studio 2010 - everything was create fine for new platform except linker command line, specified /machine:x86 separately.

编码问题

由于opencc内部处理字符串均使用的是utf-8编码，因此需要进行编解码的处理才能正确的调用dll中的接口。

广义上来说，所谓乱码问题就是解码方式和编码方式不同导致的。这是一个很大的话题，这里不深入讨论，有兴趣可以参考我另一篇博文，应该能对你有所启发。

在win10上使用cmake生成vs工程。编译的时候会遇到一个有趣的问题就是中文环境下utf-8文件中的部分汉字标点，竟然会有乱码，如下：

1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(32): error c3688: invalid literal suffix '銆'; literal operator or literal operator template 'operator ""銆' not found
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(32): error c3688: invalid literal suffix '锛'; literal operator or literal operator template 'operator ""锛' not found
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(32): error c3688: invalid literal suffix '鈥'; literal operator or literal operator template 'operator ""鈥' not found
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(32): error c2001: newline in constant
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(33): error c3688: invalid literal suffix '鈥'; literal operator or literal operator template 'operator ""鈥' not found
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(33): error c3688: invalid literal suffix '锛'; literal operator or literal operator template 'operator ""锛' not found
1>d:\projects\open_source\opwncc\opencc-ver.1.0.5\src\phraseextract.cpp(33): error c3688: invalid literal suffix '銆'; literal operator or literal operator template 'operator ""銆' not found

view code

文本编码对应关系(visual studio 2015 vs notepad++)：
file->advance save options:

chinese simplified (gb2312) - codepage 936 <==> gbk
unicode (utf-8 with signature) - codepage 65001 <==> encoding in utf-8 bom
unicode (utf-8 without signature) - codepage 65001 <==> encoding in utf-8

将上面文件的编码方式从unicode (utf-8 without signature) - codepage 65001改为 chinese simplified (gb2312) - codepage 936即可。

python的编码转换比较简单，c++的转换接口上面已经列出，至于java，建议将java文件和数据文件的编码方式均改为utf-8，使用string utf8_str = new string(gbk_str.getbytes("utf-8"), "utf-8")这种转码方式可能带来一些奇怪的问题。

dll与exe局部堆问题

有一点需要注意，要确保正确释放dll中使用new在堆中分配的内存空间，这里必须要使用dll中提供的释放堆空间的函数，而不要在主程序中直接使用delete或者delete[].

简单的解释就是exe和dll分别有各自的局部堆，new和delete分别用于分配和释放各自局部堆上的空间，使用exe中的delete来释放dll中new的局部堆内存可能会导致错误，这个和具体的编译器有关。

上面的c++代码在exe中delete dll分配的空间，是一种未定义行为。

dll调试技巧

实际使用尤其是使用不同语言对opencc.dll进行调用的时候会碰到很多问题，这时最好的办法就是使用vs的attach to process对dll进行断点跟进。

对于python调用dll，可以先打开一个python shell或者idle环境并在其中调用一下dll，之后在vs中attach到对应的python进程，不要直接attach到sublime等ide程序，因为ide中运行的python程序而不是ide本身直接调用dll文件。

对于java而言，同样不能使用vs直接attach到eclipse等ide上。这里有一个技巧，就是在调用到dll接口前的java代码加上一个断点，然后会在vs进程列表中看到一个javaw.exe程序，attach到这个程序后，接着运行java程序就会进入dll中的断点了。

小结

如果能够耐心的浏览一遍，相信会发现这是一篇采坑复盘。能够从头开始独立的一步一步解决掉遇到的每一个问题，相信一定会别有一番滋味。希望本篇博文能在需要的时候对你有所帮助。