Linux下Clang交叉编译protobuffer库供Qt on Android使用

缘由

笔者在一个由Qt开发的桌面应用程序中,使用到了protobuffer消息传输协议,而今需要移植到安卓手机上,为了节省开发时间,不打算修改服务器程序(如果不在手机应用上继续采用protobuffer协议,则面临修改服务器程序,提供json消息格式供手机端使用)。为发挥Qt的跨平台特性,在Qt for Android下延用桌面程序的通信模块,决定编译arm版的probuffer库供安卓手机使用。笔者打算在Unbuntu下交叉编译protobuffer动态链接库,然后在Windows下的Qt for Android开发环境中使用。

一次弯路

本段记录笔者最初编译protobuffer库时,采用GNU GCC编译所遇到的库函数调用问题,不感兴趣的读者可以直接跳过本段,从“正式编译”章节开始看。最初笔者的开发和编译环境如下:

Android开发环境:

  • Windows 10 64位
  • Qt for Android 5.12
  • android-ndk-r16b-windows-x86

protobuffer库交叉编译环境:

  • Unbuntu 14.04 LTS
  • android-ndk-r16b-linux-x86_64
  • GNU GCC
  • protobuffer 3.3.0源代码

相关下载

protobuf下载地址:
https://github.com/protocolbuffers/protobuf
NDK下载地址:
https://developer.android.google.cn/ndk/downloads/

后来发现这样的交叉编译环境下所编译出来的protobuffer库在开发环境中并不支持,因为两者所使用的编译器前者Qt for Android SDK采用的是Clang,后者的库编译环境采用的是GNU GCC。于是将开发环境降低到Qt 5.9+ndk rc15(因为Qt for Android 5.9还是采用的GNU GCC)。但是最终还是遇到问题,在调用一个库函数AppendPartialToString()会导致程序崩溃。最后在一篇国外网站上找到了修正方法,说需要切换到Clang编译器。请看下面章节。(脚本文件中所涉及的路径,请修改为和自己的编译环境一致。)

正式编译

开发和编译环境和上述一致,但没有使用GNU GCC了,使用的是Clang编译工具链(通过NDK生成)
注意:读者可以尝试使用nkd r18版本的ndk,因为我在使用ndk r16b时,开发环境中链接遇到找不到llvm-readobj.exe及llvm-strip.exe的问题,最后从ndk r18中将这两个文件拷贝到了指定位置;读者还可以尝试更高版本的protobuffer库。
1. 首先编译Linux下的protobuffer库
这里我们主要是为了得到编译所生成的protoc执行文件,用于今后将protobuffer消息定义文件.proto生成c++文件。

  • 编译Linux版的protobuffer库脚本如下:
#!/bin/sh
echo "here"
cd $HOME/Linux/works/protobuff/protobuf-3.3.0
make clean
echo "end"
./autogen.sh
./configure --enable-shared --prefix=$HOME/Linux/works/protobuff_linux
make -j4
make install

如果脚本执行没有问题,则会生成下面三个目录:


image.png
  • 将.proto文件生成c++文件命令的格式:

protoc -I=<导入文件的搜索路径,可指定为当前路径> --cpp_out=<c++文件的生成路径> <.proto文件的路径,包含文件名>
例如:
protoc -I=‘home/user/Linux/works/protobuffer_linux/bin’ --cpp_out=‘home/user/Linux/works/protobuffer_linux/bin’ ‘home/user/Linux/works/protobuffer_linux/protomessage.proto’

最后将生成的protomessage.pb.h和protomessage.pb.cc文件保存好,共后面在你的Qt for Android应用工程中使用。

2. 利用ndk生成Clang工具链
ndk自带生成clang工具链的脚本make-standalone-toolchain.sh,我将执行该脚本需要的参数写入了新脚本文件make_clang_toolchain.sh,其内容如下:

#!/bin/sh
cd $HOME/Linux/works/android/ndk/android-ndk-r16b/build/tools
./make-standalone-toolchain.sh --arch=arm --platform=android-26 --toolchain=arm-linux-android-clang5.0 --install-dir=$HOME/Linux/works/arm-26-toolchain-clang --use-llvm --stl=libc++

脚本执行完之后,会在定义的install-dir目录下自动生成包含clang编译工具链的arm-26-toolchain-clang目录,将在下面的脚本中使用。
3. 交叉编译protobuffer库
脚本arm_combile_clang_ndk_r16.sh内容如下:

export PREFIX=$HOME/Linux/works/protobuf_arm_3.0.0_clang/
export PATH=$HOME/Linux/works/arm-26-toolchain-clang/bin:$PATH
export SYSROOT=$HOME/Linux/works/arm-26-toolchain-clang/sysroot
export CC="arm-linux-androideabi-clang --sysroot $SYSROOT"
export CXX="arm-linux-androideabi-clang++ --sysroot $SYSROOT"
cd $HOME/Linux/works/protobuff/protobuf-3.3.0
make clean
./autogen.sh
./configure --prefix=$PREFIX \
--host=arm-linux-androideabi \
--with-sysroot="${SYSROOT}" \
--enable-shared \
--enable-cross-compile \
--with-protoc=$HOME/Linux/works/protobuff_linux/bin/protoc \
CFLAGS="-march=armv7-a -D__ANDROID_API__=26" \
CXXFLAGS="-frtti -fexceptions -march=armv7-a -D__ANDROID_API__=26" \
LIBS="-llog -lz -lc++_static"
make -j 4
make install
  1. 如果上述两个脚本执行没有问题,将在上述定义的protobuf_arm_3.0.0_clang目录下产生如下protobuffer库文件:
    image.png

    lib目录中的内容:


    image.png

    bin目录中的protoc文件不用理会,这是arm版的用于把protobuffer消息文件生成c++文件的工具。我们要使用的是前面所编译的Linux版本。
  2. 文件名修改
  • 将生成的include目录拷贝到你的Qt for Android工程目录中,并配置到pro文件中的INCLUDEPATH
  • 将下面红框中的文件拷贝到你的Qt for Android SDK目录下,同时在你的工程文件下创建lib目录,里面也复制一份
    如拷贝到:D:\Qt\Qt5.12.1\5.12.1\android_armv7\lib,并将.so.xx.x.x修改为.so


    image.png
  1. Qt工程文件.pro的配置


    image.png

心得

  1. 编译高于rc15版本的ndk可能也需要clang编译器,经测不支持Qt 5.9,所以一般较低版本Qt会搭配较低版本的ndk,反则反之;
  2. Qt也在与时俱进,Qt for Android 5.9还在使用gnu gcc编译器,到了Qt for Android 5.12中使用了clang编译器。(具体从哪个版本开始变化的,笔者没有查阅)
  3. Android NDK大约从rc 15版本之后,也要使用clang编译器编译,否则在configure检查过程中,会提示c编译器无法启动;
  4. 当编译出来的动态库在开发环境中使用遇到错误的时候,查看错误日志,如果是链接问题,可以看到它在编译过程中所连接的C库,到底是gnu的还是clang的,是动态库还是静态库,这样可以重新调整自己的环境,让开发环境和编译环境互相匹配。

由于笔者能力有限,文中若有疏漏或不妥之处,欢迎大家指正。

参考链接

https://github.com/protocolbuffers/protobuf/issues/5279
https://blog.csdn.net/cqchengdan/article/details/75578934

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351

推荐阅读更多精彩内容