注册 登录  
 加关注
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

还东国的博客

行之苟有恒,久久自芬芳

 
 
 

日志

 
 

(转载)android 集成第三方静态库的编译方法  

2014-08-11 17:27:43|  分类: Android |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |
android 集成第三方静态库的编译方法
分类: android2012-01-30 12:07 15538人阅读 评论(15) 收藏 举报
androidmoduleincludeextensionpathmakefile
 http://blog.csdn.net/lizhiguo0532/article/details/7219349
       最近为java层将一个静态库通过jni层封装成了一个动态库工他们调用,遇到了一些编译上的疑惑,所以索性将其彻底搞清楚算了,免得以后误事。
      
       下面的图片列出了所有相关文件,可以看到引用静态库的文件是com_xxx.cpp文件,而.a文件是放在lib目录下的libHWRecog.a,而库提供出来的头文件在include下的两个.h文件。
        
       源码文件写好了之后,首先就是要编译通过吧,这里有两个方案来写mk文件:第一种采用类似c/c++的编译方式:直接指定库名字;第二种采用android的独特方式:需要将静态库假意生成到out目录的专用静态库目录下去。
       编译模块命令:
       TARGET_PRODUCT=ginwave73_gb ./mk orig -t mm frameworks/base/freestylus/jni/
      
       第一种方式:类似c/c++直接指定的编译方式
       在linux下编程时,当使用到了标准或者特定的库时我们大多使用如下的形式来指定名字或者目录:
       gcc –I<特定头文件路径> -L<特定库文件路径> -l<特定库> -l<标准库> xxx.c –o xxx
       如:gcc –I./include –L./lib –lHWrecog –lm –lc {–static} test.c –o test
gcc命令的常用选项见后面附录A。
      
       那么在android的编译过程中,也可以使用类似于这种方式来指定参数,不过在这之前,我们需要了解以下一些编译变量:
       LOCAL_C_INCLUDES
LOCAL_CC
LOCAL_CFLAGS
LOCAL_CPP_EXTENSION
LOCAL_CPPFLAGS
LOCAL_CXX
LOCAL_LDLIBS
LOCAL_LDFLAGS
LOCAL_FORCE_STATIC_EXECUTABLE
这些LOCAL_开头的变量都是模块编译内的局部变量,因为通常在Android.mk开头都要包含:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
这两句,特别是include $(CLEAR_VARS)这个会清除上一个模块编译时候留下的所有LOCAL_变量,以准备给当前模块使用。
 
LOCAL_C_INCLUDES:额外的C/C++编译头文件路径,用LOCAL_PATH表示本文件所在目录,像gcc的-I参数。如:LOCAL_C_INCLUDES += $(LOCAL_PATH)/include
LOCAL_CC:另外指定c编译器,不使用默认的。
LOCAL_CFLAGS:为C编译器传递额外的参数(如宏定义),举例:LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1
LOCAL_CPP_EXTENSION:如果你的C++文件不是以cpp为文件后缀,你可以通过LOCAL_CPP_EXTENSION指定C++文件后缀名 
       如:LOCAL_CPP_EXTENSION := .cc注意统一模块中C++文件后缀必须保持一致。
LOCAL_CPPFLAGS:传递额外的参数给C++编译器,如:LOCAL_CPPFLAGS += -ffriend-injection -DLIBUTILS_NATIVE
LOCAL_CXX:指定C++编译器
 
下面的三个编译变量都是和ld有关的,所以比较重要:
LOCAL_LDLIBS:故名思议,ldlibs,就是指定那些存在于系统目录下本模块需要连接的库。如果某一个库既有动态库又有静态库,那么在默认情况下是链接的动态库而非静态库。
如:LOCAL_LDLIBS += -lm –lz –lc -lcutils –lutils –llog …
如果你的Android.mk文件中只有这么一行,那么将会采用动态链接。这个类似于上面用gcc编译时直接指定库是一样的道理。
 
LOCAL_LDFLAGS:这个编译变量传递给链接器一个一些额外的参数,比如想传递而外的库和库路径给ld,或者传递给ld linker的一些链接参数,-On,-EL{B}(大小端字节序),那么就要加到这个上面,如:
LOCAL_LDFLAGS += -L$(LOCAL_PATH)/lib/ -lHWrecog –EB{EL} –O{n} …
或者直接加上绝对路径库的全名:
LOCAL_LDFLAGS += $(LOCAL_PATH)/lib/libHWrecog.a –EB{EL} –O{n}
 
LOCAL_FORCE_STATIC_EXECUTABLE:如果编译时候需要链接的动态库库存在静态库形式,那么在这个编译变量等于true的情况下,将会链接到对应的静态库而不是动态库。比如上面列出的libm,libz,libc,libcutils,libutils,liblog等动静态库都存在,那么在该变量被置true的时候,将会链接对应的静态库。当然对于本来就是静态库的libHWrecog.a来说,该变量值不会影响它是被静态链接的。所以可以想到这个参数的设置是和前面用gcc编译时候指定-static参数一样的效果, 推荐只是编译特殊ELF文件才用。
       通常这种情况只会在编译root/sbin目录下的应用才会用到,应为通常他们执行的时间比较早,文件系统的其他部分都没加载,所以动态库就会链接不上,这个时候静态链接是最好不过了。不过在android的系统中好像没有怎么用到,因为linux一起来就是执行的init进程,就开始引导android系统了。
      
      
       第二种方法:android的prebuilt方式
       利用android的prebuilt机制将静态库复制到out目录下的obj中去,然后在连接的时候就会在对于目录下去找这个静态库,动态库或者其他可执行文件,甚至是配置文件都可以使用这个机制来进行copy。
      
      
prebuilt机制简介
       Android提供了Prebuilt编译方法,两个文件prebuilt.mk和multi_prebuilt.mk,对应的方法宏是BUILD_PREBUILT和 BUILD_MULTI_PREBUILT。
       prebuilt.mk就是prebuilt的具体实现,它是针对独立一个文件的操作,multi_prebuilt.mk是针对多个文件的,它对多个文件进行判断,然后调用prebuilt对独立一个文件进行处理。
       如果直接用prebuilt.mk的话还是比较麻烦的,得仔细看好需要的宏,如果使用multi_prebuilt.mk会更方便些,很多它都帮忙处理。实际上这个prebuilt的机制,就是一个copy的过程,目标目录就是out/.../obj/下的各个目录。
 
## prebuilt etc
include $(CLEAR_VARS)
LOCAL_MODULE :=
LOCAL_MODULE_TAGS := eng
LOCAL_MODULE_CLASS :=
LOCAL_MODULE_PATH :=
LOCAL_SRC_FILES :=
include $(BUILD_MULTI_PREBUILT)
 
##prebuilt so/a
include $(CLEAR_VARS)
LOCAL_PREBUILT_LIBS := *.so/*.a
include $(BUILD_MULTI_PREBUILT)
 
将其封装的更简单的方式是:
$(call add-prebuilt-files, ETC, pv_player.cfg)
它会将pv_player.cfg copy to system/etc下,还可以设定类型:
ETC,APPS,EXECUTABLES,SHARED_LIBRARIES,STATIC_LIBRARIES
 
add-prebuilt-files的定义是在build/core/definitions.mk下,如下:
###########################################################
## Set up the dependencies for a prebuilt target
##  $(call add-prebuilt-file, srcfile, [targetclass])
###########################################################
 
define add-prebuilt-file
    $(eval $(include-prebuilt))
endef
 
define include-prebuilt
    include $$(CLEAR_VARS)
    LOCAL_MODULE_TAGS := optional
    /* 红色这一句在android2.3上是没有的,不过如果没有这一句,这种方式是用不了的,它始终会提示你这个模块没有定义LOCAL_MODULE_TAGS,提示说你必须定义它再能继续编译,optional是所有编译模式都会编译的关键字。原来在这个函数中包含了CLEAR_VARS ,每次调用这个函数都是已经清除干净的。所以要使用这种方式,这一句是必须要加上。*/
LOCAL_SRC_FILES := $(1)
    LOCAL_BUILT_MODULE_STEM := $(1)
    LOCAL_MODULE_SUFFIX := $$(suffix $(1))
    LOCAL_MODULE := $$(basename $(1))
    LOCAL_MODULE_CLASS := $(2)
    include $$(BUILD_PREBUILT)
endef
 
###########################################################
## do multiple prebuilts
##  $(call target class, files ...)
###########################################################
 
define add-prebuilt-files
    $(foreach f,$(2),$(call add-prebuilt-file,$f,$(1)))
endef
 
下面就是使用这种方式所必须要做的动作了:
1.       在jni/lib目录下新建Android.mk文件,内容如下:
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
 
$(call add-prebuilt-files, STATIC_LIBRARIES, libHWRecog.a)
2.       修改jni下的Android.mk文件,添加如下两行:
LOCAL_STATIC_LIBRARIES := libHWRecog
include $(LOCAL_PATH)/lib/Android.mk
       jni/Android.mk完整文件见附录B.
      
       关键的编译变量:
       LOCAL_SHARED_LIBRARIES
       LOCAL_STATIC_LIBRARIES
       他们指定动静态库的方式为libxxx,例如:
       LOCAL_STATIC_LIBRARIES := libHWRecog
LOCAL_SHARED_LIBRARIES := \
              libcutils \
              libnativehelper \
              libutils \
 
附录C为Android.mk中的所有LOCAL_XXX编译变量。
 
 
附录A:
gcc命令的常用选项
选项                解释
-ansi               只支持 ANSI 标准的 C 语法。这一选项将禁止 GNU C 的某些特色,
                   例如 asm 或 typeof 关键词。
-c                 只编译并生成目标文件。
-DMACRO                以字符串“1”定义 MACRO 宏。
-DMACRO=DEFN        以字符串“DEFN”定义 MACRO 宏。
-E                                只运行 C 预编译器。
-g                          生成调试信息。GNU 调试器可利用该信息。
-IDIRECTORY              指定额外的头文件搜索路径DIRECTORY。
-LDIRECTORY             指定额外的函数库搜索路径DIRECTORY。
-lLIBRARY                 连接时搜索指定的函数库LIBRARY。
-m486                      针对 486 进行代码优化。
-o FILE                     生成指定的输出文件。用在生成可执行文件时。
-O0                        不进行优化处理。
-O 或 -O1                  优化生成代码。
-O2                        进一步优化。
-O3                        比 -O2 更进一步优化,包括 inline 函数。
-shared                      生成共享目标文件。通常用在建立共享库时。
-static                        禁止使用共享连接。
-UMACRO                取消对 MACRO 宏的定义。
-w                         不生成任何警告信息。
-Wall                       生成所有警告信息。
 
 
附录B:jni/Android.mk
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
 
LOCAL_SRC_FILES:= \
    com_ginwave_fs_com_FreeStylusJNI.cpp \
    onload.cpp
 
LOCAL_C_INCLUDES += \
       $(JNI_H_INCLUDE) \
       $(LOCAL_PATH)/include
 
LOCAL_STATIC_LIBRARIES := libHWRecog
LOCAL_SHARED_LIBRARIES := \
       libcutils \
       libnativehelper \
       libutils \
 
#LOCAL_LDFLAGS += $(LOCAL_PATH)/lib/libHWRecog.a -O2
#LOCAL_LDFLAGS += -L$(LOCAL_PATH)/lib/ -lHWRecog -O2
#LOCAL_LDLIBS += -lz -lm -llog
#LOCAL_FORCE_STATIC_EXECUTABLE :=
 
LOCAL_MODULE_TAGS := optional
 
LOCAL_MODULE := libjni_freestylus
 
LOCAL_PRELINK_MODULE := false
# build/core/prelink-linux-arm.map
# libgw_Rfid.so    0xA2500000 # [~1M]
 
LOCAL_MODILE_PATH := $(TARGET_OUT_SHARED_LIBRARIES)
 
include $(BUILD_SHARED_LIBRARY)
 
include $(LOCAL_PATH)/lib/Android.mk
 
///////////////////////////////////////////////////////////////////////////////////////////////
jni/lib/Android.mk
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
 
$(call add-prebuilt-files, STATIC_LIBRARIES, libHWRecog.a)
 
 
 
附录C:
Android编译系统模块中的LOCAL_XXX变量:
LOCAL_AAPT_FLAGS
 
LOCAL_ACP_UNAVAILABLE
 
LOCAL_ADDITIONAL_JAVA_DIR
 
LOCAL_AIDL_INCLUDES
 
LOCAL_ALLOW_UNDEFINED_SYMBOLS
 
LOCAL_ARM_MODE
 
LOCAL_ASFLAGS
 
LOCAL_ASSET_DIR
 
LOCAL_ASSET_FILES 在Android.mk文件中编译应用程序(BUILD_PACKAGE)时设置此变量,表示资源文件,
                  通常会定义成LOCAL_ASSET_FILES += $(call find-subdir-assets)
 
LOCAL_BUILT_MODULE_STEM
LOCAL_C_INCLUDES 额外的C/C++编译头文件路径,用LOCAL_PATH表示本文件所在目录
                 举例如下:
                 LOCAL_C_INCLUDES += extlibs/zlib-1.2.3
                 LOCAL_C_INCLUDES += $(LOCAL_PATH)/src
 
LOCAL_CC 指定C编译器
 
LOCAL_CERTIFICATE  签名认证
 
LOCAL_CFLAGS 为C/C++编译器定义额外的标志(如宏定义),举例:LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1
 
LOCAL_CLASSPATH
 
LOCAL_COMPRESS_MODULE_SYMBOLS
 
LOCAL_COPY_HEADERS install应用程序时需要复制的头文件,必须同时定义LOCAL_COPY_HEADERS_TO
 
LOCAL_COPY_HEADERS_TO install应用程序时复制头文件的目的路径
 
LOCAL_CPP_EXTENSION 如果你的C++文件不是以cpp为文件后缀,你可以通过LOCAL_CPP_EXTENSION指定C++文件后缀名
                    如:LOCAL_CPP_EXTENSION := .cc
                    注意统一模块中C++文件后缀必须保持一致。
 
LOCAL_CPPFLAGS 传递额外的标志给C++编译器,如:LOCAL_CPPFLAGS += -ffriend-injection
 
LOCAL_CXX 指定C++编译器
 
LOCAL_DX_FLAGS
 
LOCAL_EXPORT_PACKAGE_RESOURCES
 
LOCAL_FORCE_STATIC_EXECUTABLE 如果编译的可执行程序要进行静态链接(执行时不依赖于任何动态库),则设置LOCAL_FORCE_STATIC_EXECUTABLE:=true
                              目前只有libc有静态库形式,这个只有文件系统中/sbin目录下的应用程序会用到,这个目录下的应用程序在运行时通常
                              文件系统的其它部分还没有加载,所以必须进行静态链接。
 
LOCAL_GENERATED_SOURCES
 
LOCAL_INSTRUMENTATION_FOR
 
LOCAL_INSTRUMENTATION_FOR_PACKAGE_NAME
 
LOCAL_INTERMEDIATE_SOURCES
 
LOCAL_INTERMEDIATE_TARGETS
 
LOCAL_IS_HOST_MODULE
 
LOCAL_JAR_MANIFEST
 
LOCAL_JARJAR_RULES
 
LOCAL_JAVA_LIBRARIES 编译java应用程序和库的时候指定包含的java类库,目前有core和framework两种
                     多数情况下定义成:LOCAL_JAVA_LIBRARIES := core framework
                     注意LOCAL_JAVA_LIBRARIES不是必须的,而且编译APK时不允许定义(系统会自动添加)
 
LOCAL_JAVA_RESOURCE_DIRS
 
LOCAL_JAVA_RESOURCE_FILES
 
LOCAL_JNI_SHARED_LIBRARIES
 
LOCAL_LDFLAGS 传递额外的参数给连接器(务必注意参数的顺序)
 
LOCAL_LDLIBS 为可执行程序或者库的编译指定额外的库,指定库以"-lxxx"格式,举例:
             LOCAL_LDLIBS += -lcurses -lpthread
             LOCAL_LDLIBS += -Wl,-z,origin
 
LOCAL_MODULE 生成的模块的名称(注意应用程序名称用LOCAL_PACKAGE_NAME而不是LOCAL_MODULE)
 
LOCAL_MODULE_PATH 生成模块的路径
 
LOCAL_MODULE_STEM
 
LOCAL_MODULE_TAGS 生成模块的标记
 
LOCAL_NO_DEFAULT_COMPILER_FLAGS
 
LOCAL_NO_EMMA_COMPILE
 
LOCAL_NO_EMMA_INSTRUMENT
 
LOCAL_NO_STANDARD_LIBRARIES
 
LOCAL_OVERRIDES_PACKAGES
 
LOCAL_PACKAGE_NAME APK应用程序的名称
 
LOCAL_POST_PROCESS_COMMAND
 
LOCAL_PREBUILT_EXECUTABLES 预编译including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)时所用,指定需要复制的可执行文件
 
LOCAL_PREBUILT_JAVA_LIBRARIES
 
LOCAL_PREBUILT_LIBS 预编译including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)时所用, 指定需要复制的库.
 
LOCAL_PREBUILT_OBJ_FILES
 
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES
 
LOCAL_PRELINK_MODULE 是否需要预连接处理(默认需要,用来做动态库优化)
 
LOCAL_REQUIRED_MODULES 指定模块运行所依赖的模块(模块安装时将会同步安装它所依赖的模块)
 
LOCAL_RESOURCE_DIR
 
LOCAL_SDK_VERSION
 
LOCAL_SHARED_LIBRARIES 可链接动态库
 
LOCAL_SRC_FILES 编译源文件
 
 
LOCAL_STATIC_JAVA_LIBRARIES
 
LOCAL_STATIC_LIBRARIES 可链接静态库
 
LOCAL_UNINSTALLABLE_MODULE
 
LOCAL_UNSTRIPPED_PATH
 
LOCAL_WHOLE_STATIC_LIBRARIES 指定模块所需要载入的完整静态库(这些精通库在链接是不允许链接器删除其中无用的代码)
 
LOCAL_YACCFLAGS
 
OVERRIDE_BUILT_MODULE_PATH
 
参考网址:
http://blog.csdn.net/jiajie961/article/details/5997147
android编译系统 makefile(Android.mk)写法.txt
 
http://blog.tianya.cn/blogger/post_read.asp?BlogID=3591203&PostID=32560844
Android Build Cookbook
 
http://zhuwenhao.com/709/%E6%8A%80%E6%9C%AF/%E8%87%AA%E7%94%B1%E8%BD%AF%E4%BB%B6%E7%A4%BE%E5%8C%BA/android/android%E7%BC%96%E8%AF%91c%E4%BB%A3%E7%A0%81%E6%97%B6%E9%93%BE%E6%8E%A5%E5%85%B6%E4%BB%96%E5%BA%93%E6%96%87%E4%BB%B6%E7%9A%84%E6%96%B9%E6%B3%95%E9%99%84make-file%E8%AF%A6%E8%A7%A3%E6%89%8B%E5%86%8C/
Android编译C代码时链接其他库文件的方法(附make file详解手册)
 
http://blog.csdn.net/evilcode/article/details/6460167
Makefile 判断文件是否存在
 
http://anony3721.blog.163.com/blog/static/511974200922721429233/
g++ gcc编译选项
 
http://ltzmage.blog.163.com/blog/static/1796999820105235511578/
动态库与静态库的原理介绍
 
http://hi.baidu.com/sunblackshine/blog/item/d5afd99864baf1126f068c07.html
android makefile prebuild
 
http://xiaohang.org/2011/04/
Android – 带有动态库、静态库、jar包的Makefile文件的编写
 
http://blog.csdn.net/vrix/article/details/6673841
ANDROID NDK makefile 链接静态库的方法
 
http://www.newsmth.net/bbstcon.php?board=MobileDev&gid=31228
Android NDK使用第三方静态库如何配置

  评论这张
 
阅读(471)| 评论(0)
推荐 转载

历史上的今天

在LOFTER的更多文章

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2017