在Android开发的时候,经常会使用到用c或c++编写的第三方的静态库。如果有源码的话,可以直接跟你自己的代码一去编译成动态库so,但是如果没有源码的话,你就必须在自己的动态库so里面将别人生成好的静态库导入进来一起编译了。我在编译的时候遇到了不少问题,我觉得有必要进行总结一下。
下面我以一个简单的实际例子来讲解如何在动态库中导入静态库。
静态库中的源代码有两个文件:static.h, static.c,有一个add方法
static.h
1
2
|
#include <stdio.h>
int
add(
int
x,
int
y);
|
static.c
1
2
3
4
5
|
#include "static.h"
int
add(
int
x,
int
y)
{
return
x + y;
}
|
将它编译成静态库,Android.mk如下:
1
2
3
4
5
|
LOCAL_PATH := $(call my-dir)
include
$(CLEAR_VARS)
LOCAL_MODULE := static_add
LOCAL_SRC_FILES :=
static
.c
include
$(BUILD_STATIC_LIBRARY)
|
注意编译静态库的时候,必须有一个Application.mk文件:
1
|
APP_MODULES:=static_add
|
APP_MODULES的值应该和Android.mk中的LOCAL_MODULE的值保持一样。
然后调用ndk-build进行编译生成libstatic_add.a静态库。
hejinlai_iMac:jni hejinlai$ ndk-build
Prebuilt : libstatic_add.a <= jni/
生成静态库后,然后编写动态库中的源代码: share.h share.c
share.h
1
2
|
#
include
<stdio.h>
int
test_add(
int
x,
int
y);
|
share.c
1
2
3
4
5
6
7
|
#
include
"share.h"
#
include
"static.h"
int
test_add(
int
x,
int
y)
{
// 调用static里面的方法
return
add(x, y);
}
|
编写导入静态库的Android.mk:
1
2
3
4
5
6
7
8
9
10
|
LOCAL_PATH := $(call my-dir)
include
$(CLEAR_VARS)
LOCAL_MODULE := static_add
LOCAL_SRC_FILES := libstatic_add.a
include
$(PREBUILT_STATIC_LIBRARY)
include
$(CLEAR_VARS)
LOCAL_MODULE := share_add
LOCAL_STATIC_LIBRARIES := static_add
LOCAL_SRC_FILES := share.c
include
$(BUILD_SHARED_LIBRARY)
|
注意上面生成的libstatic_add.a必须跟Android.mk放在同一目录下,否则需要填写相应的路径,然后进行编译:
hejinlai_iMac:jni hejinlai$ ndk-build
Compile thumb : share_add <= share.c
Prebuilt : libstatic_add.a <= jni/
SharedLibrary : libshare_add.so
Install : libshare_add.so => libs/armeabi/libshare_add.so
提示so编译成功。
需要注意的是我这边share.c和static.c放在同一目录下,如果放在不同的目录下,需要指定
LOCAL_C_INCLUDES链接到相应的路径。
遇到的问题:linux 链接 静态库 undefined reference to
最近将项目移植到linux上,工程需要依赖三个静态库:libprojcommon.a libluabind.a liblua.a
依赖关系是projcommon依赖luabind,luabind依赖lua,所以项目最终的链接参数是这样的:
-L/home/boy/ProjCommon/lib -lprojcommon -L/home/boy/luabind/lib -lluabind -L/home/boy/lua/lib -llua,
但是链接失败,报错:
luabind/src/create_class.cpp:36: undefined reference to `lua_pushnil'
luabind/src/create_class.cpp:40: undefined reference to `lua_pushstring'
luabind/src/create_class.cpp:41: undefined reference to `lua_equal'
luabind/src/create_class.cpp:43: undefined reference to `lua_settop'
...
当然这样的错误无穷无尽,很多。
仔细检查了链接路径、链接顺序、系统默认目录下是不是存在同名的静态库,都不是这些问题,用nm查看liblua.a,发现导出的函数名也存在。将Makefile改来改去,还是无解,郁闷了整整一上午。
最终终于找到原因:liblua是c项目,Makefile是我从libluabind拷过来的,而libluabind是c++项目,在修改编译目标文件扩展名.cpp为.c之后,却忘了将编译器从g++改为gcc,导致liblua中生成的为C++风格函数名,而libluabind中包含lua头文件有extern "c"的修饰,是按照C风格引用的,两边函数名不一致,导致undefined。
编译liblua时改为用gcc编译后,问题搞定!
遇到类似的问题,这里总结一下排错方法:
1,检查链接路径是否正确(当然路径不正确会报找不到文件);
2,检查链接到的库是不是想链接的目标库(例如链接到不同版本的同名库等);
3,确保依赖关系正确,并检查链接顺序;
4,确认库的源代码.c或.cpp文件都被编译到,而且都被链接进了库中;
5,用nm查看库的导出函数是否存在;
6,确认库导出函数的名称与引用处的名称是否一致;
7,其实这一点和第6点原因一致:确认工程是否cpp和c混用,如果是,请确保cpp文件用c++编译器编译,c文件用c编译器编译;
8,如果上述方法还是没有解决问题,不可能啊!真的这样的话,就将库代码直接编进工程吧,或者换个库吧,或者换个Makefile吧(谁知道你写的Makefile有什么问题...)
一般解决思路
一般编译器报 “undefined reference to”的错误是以下几种情况,Android中的makefile是Android.mk命名的。
1 没有指定对应的库(.o/.a/.so)
使用了库中定义的实体,但没有指定库(-lXXX)或者没有指定库路径(-LYYY),会导致该错误,
在Android.mk中 用LDFLAGS参数来定义库(-lXXX)和 (-LYYY)的
2 连接库参数的顺序不对
在默认情况下,对于-l 使用库的要求是越是基础的库越要写在后面,无论是静态还动态
我在实际使用的过程中,发现-D参数的使用,也会导致“undefined reference to”的错误,推荐大家如果想在做宏控制的时候,把-D参数放到最后
3 gcc/ld 版本不匹配
gcc/ld的版本的兼容性问题,由于gcc2 到 gcc3大版本的兼容性存在问题(其实gcc3.2到3.4也一定程度上存在这样的问题) 当在高版本机器上使用低版本的机器就会导致这样的错误, 这个问题比较常见在32位的环境上, 另外就在32位环境不小心使用了64位的库或者反过来64位环境使用了32位的库.
这个问题与Linux下几乎一样
gcc和g++编译结果的混用需要保证能够extern "C" 两边都可以使用的接口,在我们的64位环境中gcc链接g++的库还需要加上 -lstdc++,具体见前文对于混合编译的说明 。
在extern “C”的使用时候,因为我经常需要用JNI链接纯C语言的库,我有时候加上extern "C" 还是不行,后来我才发现,extern "C" 必须要包含了头文件,我在这个问题上纠结了很久,惭愧。
这个问题基本上是由于程序使用了dlopen方式载入.so, 但.so没有把所有需要的库都链接上,具体参加上文中对于静态库和动态库混合使用的说明
关于执行时动态链接的问题,我也碰到过很纠结的情况,就是在Android链接的库依赖于我现在当前的库,就变成了你链接我,我再链接你,导致死都编不过,最好撇清这种关系