编写ios和android共用的c/c++库时 使用iconv的问题

因为在项目中需要同时维护ios和android，不同的代码不利于开发的便捷和以后的维护，所以在最近的一个项目中，两种手机应用的通信部分打算使用c/c++库来统一编写，ios调用.a静态库，android调用.so动态库的方式来实现。

由于通信时，从服务端获取到的中文数据为GBK编码，android和ios通过c++库获取到的中文乱码，于是打算在c++库层统一将GBK转成UTF-8后再传递给上层应用。

由于优先考虑跨平台的方案，最终我采用iconv库来实现转码功能。参考网上搜到的一个代码如下

#ifndef STRINGUTIL_H_
#define STRINGUTIL_H_

#include 
#include 

#ifdef _WIN32
#pragma comment(lib,"iconv.lib")
#endif

int code_convert(const char *from_charset,const char *to_charset,const char *inbuf,size_t inlen,char *outbuf,size_t outlen) {
 iconv_t cd;
 const char **pin = &inbuf;
 char **pout = &outbuf;

 cd = iconv_open(to_charset,from_charset);
 if (cd==0) return -1;
 memset(outbuf,0,outlen);
 iconv(cd, const_cast(pin), &inlen,pout, &outlen);
 iconv_close(cd);
 return 0;
}

/* UTF-8 to GBK  */
int u2g(const char *inbuf, size_t inlen, char *outbuf, size_t outlen) {
 return code_convert("UTF-8","GBK",inbuf,inlen,outbuf,outlen);
}

/* GBK to UTF-8 */
int g2u(const char *inbuf, size_t inlen, char *outbuf, size_t outlen) {
 return code_convert("GBK", "UTF-8", inbuf, inlen, outbuf, outlen);
}

#endif /* STRINGUTIL_H_ */

代码用g++编译，在ubuntu上测试正常，但在移植到ios和android均出现问题。

1.首先讲ios上出现的问题，这个比较简单。

使用xcode能够成功编译出.a静态库，但是在ios应用编译时，出现如下问题：

Undefined symbols for architecture x86_64:

  "_iconv", referenced from:

      code_convert(char const*, char const*, char const*, unsigned long, char*, unsigned long) in libVmNet.a(VmNet-EA133239D29A369D.o)

  "_iconv_close", referenced from:

      code_convert(char const*, char const*, char const*, unsigned long, char*, unsigned long) in libVmNet.a(VmNet-EA133239D29A369D.o)

  "_iconv_open", referenced from:

      code_convert(char const*, char const*, char const*, unsigned long, char*, unsigned long) in libVmNet.a(VmNet-EA133239D29A369D.o)

ld: symbol(s) not found for architecture x86_64

clang: error: linker command failed with exit code 1 (use -v to see invocation)

后来在网上搜到的解决方法，原来需要在项目中添加libiconv.2.4.0.tbd动态库。然后重新编译app成功运行。

2.接下来讲在android上出现的问题。

在android studio中编译.so库，使用的是最新版的2.2.2，默认使用的是cmake编译。

编译中，出现找不到iconv.h头文件，网上搜索解决方法，大致有以下几种方法：

1.项目中添加iconv库的源代码，跟项目一起编译。用到了android.mk，这个又跟现在官方推荐使用的cmake相违背了，我下载了iconv的源码，一大堆，不太懂，暂时放弃这条路子。

2.先编译一个libiconv.so的动态库，然后编译自己的库。这个是用到了android.mk，不想用这个，嫌麻烦，放弃。

3.据说ndk自带了iconv的支持，只是需要在android.mk中增加

LOCAL_WHOLE_STATIC_LIBRARIES += android_support

$(call import-module,Android/support)

又是android.mk，但我用的是cmake，放弃。

虽然放弃了方法3，但是从中可以知道ndk有自带的iconv功能，在一个叫android_support的静态库中，于是，我找到了iconv.h所在的路径

/Users/zhourui/Library/Android/sdk/ndk-bundle/sources/android/support/include，libandroid_support.a所在路径

/Users/zhourui/Library/Android/sdk/ndk-bundle/sources/cxx-stl/llvm-libc++/libs/${ANDROID_ABI}/libandroid_support.a;

于是参考了google安卓官方文档中对cmake参数的解释，在CMakeLists.txt中添加了以下参数：

# 相当于g++ 中的 -I参数，这个参数让cmake能找到iconv.h这个头文件
include_directories(/Users/zhourui/Library/Android/sdk/ndk-bundle/sources/android/support/include)

target_link_libraries( # 这是我需要生成的库文件VmNet.so
                       VmNet

                       # Links the target library to the log library
                       # included in the NDK.
                       # 使用android_support.a库
                       /Users/zhourui/Library/Android/sdk/ndk-bundle/sources/cxx-stl/llvm-libc++/libs/${ANDROID_ABI}/libandroid_support.a
                       ${log-lib} )

CMakeLists.txt中只需要这么配置即可。完成了头文件路径搜索和静态库的链接。

但是直接编译还是会出错，会提示

error:unknown type name 'iconv_t'

error:use of undeclared identifier 'iconv_open'

到使用到iconv.h的转码文件中查看，发现能找到iconv.h文件，但是iconv_t怎么会未定义呢，于是进入到iconv.h文件中查看，发现iconv.h的代码如下

#ifndef NDK_ANDROID_SUPPORT_ICONV_H
#define NDK_ANDROID_SUPPORT_ICONV_H

#if !defined(__LP64__)

#ifdef __cplusplus
extern "C" {
#endif

#include 

typedef void* iconv_t;

iconv_t iconv_open(const char*, const char*);
size_t  iconv(iconv_t, char**, size_t*, char**, size_t*);
int     iconv_close(iconv_t);

#ifdef __cplusplus
}  // extern "C"
#endif

#endif // !__LP64__

我发现其中有一段是我用红色标注的， #if !defined(__LP64__) 这句表示在编译64位程序时，头文件便是空的了，那么便表示ndk中的iconv不支持64位。

到app下的build.gradle中查看有这么一段：

externalNativeBuild {

  cmake {
    cppFlags "-std=c++11 -fexceptions"
    abiFilters 'x86', 'x86_64', 'armeabi', 'armeabi-v7a', 'arm64-v8a'
  }
}

这个表示编译出.so动态库包含x86_64和arm64-v8a两种64位库，那么将这两种abi去除即可。

externalNativeBuild {

  cmake {
    cppFlags "-std=c++11 -fexceptions"
    abiFilters 'x86', 'armeabi', 'armeabi-v7a' // 由于不支持64位，所以只保留32位
  }
}

再次编译出.so动态库，使用在app项目中编译成功后能正常运行并转码。