android 集成第三方静态库的编译方法

$(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_UN***AILABLE



LOCAL_ADDITIONAL_J***A_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_J***A_LIBRARIES 编译java应用程序和库的时候指定包含的java类库，目前有core和framework两种

多数情况下定义成：LOCAL_J***A_LIBRARIES := core framework

注意LOCAL_J***A_LIBRARIES不是必须的，而且编译APK时不允许定义(系统会自动添加)



LOCAL_J***A_RESOURCE_DIRS



LOCAL_J***A_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_J***A_LIBRARIES



LOCAL_PREBUILT_LIBS 预编译including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)时所用, 指定需要复制的库.



LOCAL_PREBUILT_OBJ_FILES



LOCAL_PREBUILT_STATIC_J***A_LIBRARIES



LOCAL_PRELINK_MODULE 是否需要预连接处理(默认需要，用来做动态库优化)



LOCAL_REQUIRED_MODULES 指定模块运行所依赖的模块(模块安装时将会同步安装它所依赖的模块)



LOCAL_RESOURCE_DIR



LOCAL_SDK_VERSION



LOCAL_SHARED_LIBRARIES 可链接动态库



LOCAL_SRC_FILES 编译源文件





LOCAL_STATIC_J***A_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文件的编写



/article/2305804.html

ANDROID NDK makefile 链接静态库的方法


http://www.newsmth.net/bbstcon.php?board=MobileDev&gid=31228

Android NDK使用第三方静态库如何配置