Android中集成第三方库的方法和问题
声明：
1. 本文参考了网上同学们的现有成果，在此表示感谢，参考资料在文后有链接。
2. 本文的重点在第三部分，是在开发中遇到的问题及解决办法.第一，第二部分为参考网上同学们的成果加以整理而成。
3.欢迎转载，交流，请尊重作者劳动成果；转载请注明出处，谢谢！
Android中使用第三方库可能有两种：Java库.jar和原生库.so/.a，如果只是做上层APK开发，这两种库都可以通过Eclipse集成开发环境进行集成，如果是平台级开发，则都可通过源码集成。本文整理这两种集成方式使用步骤，以下假设程序scanerapp，集成Java库scanerjar.jar，原生库libscanerbase.so/libscanerbase.a，libscanerplus.so/libscanerplus。其中，so库要尽量参照Android引用库规范编写，内部函数命名也要规范（尽管不规范也可能可以使用），.a库为静态联编，一般面向C/C++引用使用，如果Java上层使用，一般需要通过动态库(.so)转接。
一、Eclipse集成
1、scanerjar.jar包集成
A.当前工程scanerapp下创建libs目录
B.使用Eclipse导入scanerjar.jar包即可
2、libscanerbase.so和libscanerplus.so集成
A.当前工程scanerapp下创建libs/armeabi目录
B.把libscanerbase.so和libscanerplus库文件拷贝到libs/armeabi目录下即可，因为libscanerbase.so和libscanerplus.so库为原生库，一般做运行时加载的动态库。
C.Java文件引用加载库
最终生成的apk会自动把libscanerjar.jar和libscanerbase.so和libscanerplus.so文件打包进去。
二、源码集成
源码集成第三方库也至少有两种方式：C/C++链接方式和Android Prebuild方式，当然似乎前者无法集成libscanerjar.jar包。C/C++方式
1、C/C++链接方式
静态库和动态库一般放置在libs/armeabi目录下，如果库文件较多，也可以单独另立目录存放，只要对应修改库文件路径（搜索路径即可）。
修改Android.mk文件，示例链接libscanerbase.a静态库：
LOCAL_LDFLAGS := $(LOCAL_PATH)/libs/armeabi/libbase.a
2、Android Prebuild方式
1) libscanerbase.jar包集成
A.在packages/app/scanerapp下创建libs目录，这里假设程序包放在packages/app下面。
B.把scanerbase.jar包拷贝到该目录下
C.修改Android.mk文件，示例如下：
include $(CLEAR_VARS)LOCAL_STATIC_JAVA_LIBRARIES := scanerjarLOCAL_PREBUILT_STATIC_JAVA_LIBRARIES :=scanerjar:libs/libscaner.jarinclude $(BUILD_MULTI_PREBUILT)
其中，
LOCAL_STATIC_JAVA_LIBRARIES为引用jar库的别名，可以随便取名，一般就是用库名称就可以了。
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES为指定prebuilt java库规则，格式为：别名:jar文件的完整路径，这里的别名就是LOCAL_STATIC_JAVA_LIBRARIES所取的名字。
源码开发时，scanerapp.apk将会连同libscaner.jar打包，一起放在out/target/product/<prjname>/system/app/目录下；
2) libscanerbase.so和libscanerplus.so集成
A.在packages/app/scanerapp下创建libs/armeabi目录
B.把.so库拷贝到libs/armeabi目录下
C.修改Android.mk配置文件，添加如下：
include $(CLEAR_VARS) LOCAL_STATIC_LIBRARIES := libscanerso LOCAL_PREBUILT_LIBS := libscanerso:libs/armeabi/libscanerbase.so libs/armeabi/libscanerplus.so include $(BUILD_MULTI_PREBUILT)
其中，
LOCAL_PREBUILT_LIBS指定prebuilt so库规则，格式：别名:so文件路径。
源码开发时，这个libscanerbase.so将会被放在out/target/product/<prjname>/system/lib/下，其中system/lib为加载动态库时缺省搜索路径。
此外，libscanerbase.so还可以集成到build/core/user_tags.mk中，不过一般不建议那么做，我们应尽量减少修改系统级配置。
3) 源码集成编译
mmm /packages/apps/scanerapp
以上指令是在展讯ANDROID平台上使用，其它平台可能不同。
三、容易出现问题的点及解决办法
本文大部分参考了网上兄弟的成果，再次表示感谢。本文的重点其实是本部分，也是本人在开发中遇到的问题。
1. 集成库文件到Eclipse项目
在将库文件添加到Eclipse项目中时，一定要注意添加库的位置，不能放错，否则不能被正常使用。Jar包放在libs/目录下，so库文件一定要放在libs/armeabi目录下。
2.集成库文件到源码中
在源码集成环境中（我们的平台为展讯平台），其他平台可以参考
(1) 在应用目录(scanerapp)下的Android.mk文件中，在引用多个库的时候，库文件的别名可以不声明，但是如果声明了别名，就一定要注意该问题：别名后要将所有引用的库都写上，及一个别名后添加所有要引用的库。
例如：
应写成如下格式：
include $(CLEAR_VARS) LOCAL_STATIC_JAVA_LIBRARIES := scanerjar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES :=scanerjar:libs/libscaner.jar libs/libscanerplus.jar #问题点 include $(BUILD_MULTI_PREBUILT) include $(CLEAR_VARS) LOCAL_STATIC_LIBRARIES := libscanerso LOCAL_PREBUILT_LIBS := libscanerso:libs/armeabi/libscanerbase.so libs/armeabi/libscanerplus.so #问题点 include $(BUILD_MULTI_PREBUILT)
而不能写成下面的格式：
include $(CLEAR_VARS) LOCAL_STATIC_JAVA_LIBRARIES := scanerjar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES :=scanerjar:libs/libscaner.jar scanerjar:libs/libscanerplus.jar #注意问题点 include $(BUILD_MULTI_PREBUILT) include $(CLEAR_VARS) LOCAL_STATIC_LIBRARIES := libscanerso LOCAL_PREBUILT_LIBS := libscanerso:libs/armeabi/libscanerbase.so libscanerso:libs/armeabi/libscanerplus.so #注意问题点 include $(BUILD_MULTI_PREBUILT)
(2) 在应用包中有使用jni代码的情况，在软件包jni目录下的（scanerapp/jni）Android.mk中要参考如下声明方式：
include $(CLEAR_VARS) LOCAL_MODULE := libscanerjni LOCAL_SRC_FILES := scaner.cpp LOCAL_LDLIBS := -llog LOCAL_MODULE_TAGS := optional include $(BUILD_SHARED_LIBRARY)
其中，LOCAL_MODULE会被应用所使用，LOCAL_MODULE_TAGS一定要申明，否则编译时会报错，不能进行编译。
在应用（scanerapp）目录下的Android.mk文件中一定要声明LOCAL_JNI_SHARED_LIBRARIES,示例如下：
LOCAL_JNI_SHARED_LIBRARIES := libscanerjni LOCAL_PROGUARD_ENABLED := disabled
其中libscanerjni为应用（scanerapp/jni）目录下Android.mk文件中申明的Jni模块。
如果应用的包，在编译时提示proguard错误，则要将LOCAL_PROGUARD_ENABLED设置为disabled;
（3）按照该规则正确写了Android.mk文件，使用mmm单独编译scanerapp也能正常编译通过，能够正常看到提示已经将所用到的so库文件copy到out/…/system/libs目录下。但是将整个项目全编时，却发现out/…/system/libs目录下并没有我们所需要的.so库文件。出现这种情况，可进行如下操作，（展讯平台可照搬，其他平台可参考，思路是一样的）
第一：将所要引用的so文件拷贝到project/vendor/sprd/proprietaries/<projectName>/system/lib目录下
第二：打开project/device/sprd/<prjecetName>/proprietaries.mk
将索要引用的so库文件添加到PROPMODS项中。
第三：make –j4编译项目
(完)
---------------------------
参考资料：
http://blog.csdn.net/thl789/article/details/7918093
http://www.zzqhost.com/?post=14
http://www.metsky.com/archives/635.html
----------------------------------
