作者:维他柠檬鱼1949 | 来源:互联网 | 2017-05-12 15:45
AndroidNDKr5开始支持预编译库(动态库和静态库),即程序能使用库的预编译版本。该特性可用于以下两方面:1)向第三方NDK开发人员发布你的共享库而不用提供源码。2)使用一个提前编译好的库(预编译库)来加速编译过程。本文说明该特性如何工作。I.
Android NDK r5 开始支持预编译库(动态库和静态库),即程序能使用库的预编译版本。 该特性可用于以下两方面: 1)向第三方NDK开发人员发布你的共享库而不用提供源码。 2)使用一个提前编译好的库(预编译库)来加速编译过程。 本文说明该特性如何工作。 I.
Android NDK r5 开始支持预编译库(动态库和静态库),即程序能使用库的预编译版本。
该特性可用于以下两方面:
1)向第三方NDK开发人员发布你的共享库而不用提供源码。
2)使用一个提前编译好的库(预编译库)来加速编译过程。
本文说明该特性如何工作。
I. 声明一个预编译库的模块
对于Android编译工具而言,每个预编译库必须声明为一个独立的模块。这里举一个例子,假设 libfoo.so 文件与 Android.mk 位于同一个目录:
[plain] view
plaincopy
-
LOCAL_PATH := $(call my-dir)
-
include $(CLEAR_VARS)
-
LOCAL_MODULE := foo-prebuilt
-
LOCAL_SRC_FILES := libfoo.so
-
include $(PREBUILT_SHARED_LIBRARY)
按以下步骤声明这样一个模块:
1. 给该模块取一个名字(这里是 foo-prebuilt)。这个名字不需要与预编译库自身的名字相同。
2. 将 LOCAL_SRC_FILES 指定为你要提供的共享库的路径。通常,该路径是相对于 LOCAL_PATH 的路径。注意:必须保证共享库ABI的兼容性。
3. 如果你的库是共享库,则包含 PREBUILT_SHARED_LIBRARY 而不是 BUILD_SHARED_LIBRARY;如果是静态库,则包含 PREBUILT_STATIC_LIBRARY。
预编译模块不需要编译。该预编译模块会被拷贝到 $PROJECT/obj/local 下面,还会被拷贝到 $PROJECT/libs/ 下面(这里的库被strip过)。
II. 在其他模块中引用这个预编译库
在依赖该预编译库的模块对应的Android.mk中,将预编译库的名字(前面取的)加入到 LOCAL_STATIC_LIBRARIES 或 LOCAL_SHARED_LIBRARIES 声明中。例如,一个使用上面libfoo.so的简单例子如下:
[plain] view
plaincopy
-
include $(CLEAR_VARS)
-
LOCAL_MODULE := foo-user
-
LOCAL_SRC_FILES := foo-user.c
-
LOCAL_SHARED_LIBRARIES := foo-prebuilt
-
include $(BUILD_SHARED_LIBRARY)
III. 将预编译库的头文件导出
得到预编译库之后,一般需要它对应的头文件。例如前面的libfoo.so,它有对应的foo.h。编译依赖libfoo.so的模块时,需要将该头文件和它的路径提供给NDK编译系统。一种简单方法是,前面在定义该预编译库的时候,使用LOCAL_EXPORT_C_INCLUDES 变量。例如,假设文件 foo.h 位于当前预编译模块所在目录的 include 子目录,则可以在预编译模块的Android.mk文件中编写如下:
[plain] view
plaincopy
-
include $(CLEAR_VARS)
-
LOCAL_MODULE := foo-prebuilt
-
LOCAL_SRC_FILES := libfoo.so
-
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
-
include $(PREBUILT_SHARED_LIBRARY)
这个 LOCAL_EXPORT_C_INCLUDES 定义确保了任何依赖这个预编译库的模块会自动在自己的 LOCAL_C_INCLUDES 变量中增加到这个预编译库的include目录的路径,从而能够找到其中的头文件。
IV. 调试预编译库
建议你在预编译库中保留调试信息。位于 $PROJECT/libs/ 的版本都是不含调试信息的(被NDK编译系统执行strip过的),调试版的库才能用于 ndk-gdb。
V. 共享库ABI的选择
如前所述,共享库与目标系统的ABI兼容性至关重要。应检查一下
TARGET_ARCH_ABI 的值,可以是以下值:
armeabi 目标系统CPU是ARMv5TE或更高
armeabi-v7a 目标系统CPU是ARMv7或更高
x86 目标系统CPU是x86
注意,armeabi-v7a的CPU可以很好地执行armeabi的程序。
举一个例子,我们提供一个预编译库的两个版本,然后选择不同的ABI:
[plain] view
plaincopy
-
include $(CLEAR_VARS)
-
LOCAL_MODULE := foo-prebuilt
-
LOCAL_SRC_FILES := $(TARGET_ARCH_ABI)/libfoo.so
-
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
-
include $(PREBUILT_SHARED_LIBRARY)
这里假设要拷贝的预编译库所在的目录结构如下:
Android.mk --> 编译这个预编译库的Android.mk
armeabi/libfoo.so --> armeabi版本的共享库
armeabi-v7a/libfoo.so --> armeabi-v7a版本的共享库
include/foo.h --> 预编译库导出的头文件
注意:你不必提供armeabi-v7a版本,因为armeabi版本的共享库能够被armeabi-v7a的兼容,但是反过来就不行。