android_c++ 高级编程NDK学习笔记一
深入了解android NDK
2.1 Android 提供的组件:
ARM,x86和MIPS交驻编译器
构建系统
Java原生接口头文件
C库
Math库
POSIX线程
最小的c++库
ZLIB压缩库
动态链接库
Android日志库
Android像素缓冲库
Android 原生应用apis
OpenGL ES 3D 图形库
openSL ES 原生音频库
openMAX AL最小支持
2.2 android NDK的目录结构
| 名称 |
介绍 |
| Ndk-build |
Shell角本,构建系统的起始点 |
| Ndk-gdb |
Shell角本,GNU调试器原生组件 |
| Ndk-stack |
Shell角本,用于分析原生组件崩溃时的堆栈追踪 |
| build |
目录,包含了构建系统的所有模块 |
| platforms |
目录,支持不同android目标版本的头文件和库文件 |
| simple |
示例应用 |
| source |
可导入的共享模块 |
| toolchains |
不同版本的交叉编译器 |
2.3 简单的示例程序
配置eclipse,windows-àpreference-àandroid-àNDK,指定ndk的目录
导入ndk自带示例程序
向项目中添加原生支持右击项目àandroidTools-àadd Native Support,指定共享库名
运行项目
可以在控制台看到构建信息
13:08:35 **** Incremental Build ofconfiguration Default for project HelloJni ****
"D:\\tools\\android-ndk-r9b\\ndk-build.cmd"all
[armeabi] Gdbserver : [arm-linux-androideabi-4.6]libs/armeabi/gdbserver
[armeabi] Gdbsetup : libs/armeabi/gdb.setup
[armeabi] Install : libhello-jni.so =>libs/armeabi/libhello-jni.so
13:08:36 Build Finished (took 388ms)
用命令行对项目进行构建
A 构建原生组件
D:\workspace4>cdhello-jni
D:\workspace4\hello-jni>ls
AndroidManifest.xml default.properties jni res src tests
D:\workspace4\hello-jni>ndk-build
[armeabi] Gdbserver :[arm-linux-androideabi-4.6] libs/armeabi/gdbserver
[armeabi] Gdbsetup :libs/armeabi/gdb.setup
[armeabi] Compile thumb :hello-jni <= hello-jni.c
[armeabi] SharedLibrary :libhello-jni.so
[armeabi] Install :libhello-jni.so => libs/armeabi/libhello-jni.so
D:\workspace4\hello-jni>ls
AndroidManifest.xml default.properties jni libs obj res src tests
B 构建java应用程序,并将其与原生组件打包
生成apach ANT构建文件
D:\workspace4\hello-jni>android update project -p . -nhello-jni -t android-14 -
-subprojects
Updated and renamed default.properties to project.properties
Updated local.properties
Added file D:\workspace4\hello-jni\build.xml
Added file D:\workspace4\hello-jni\proguard-project.txt
Updated and renamed default.properties to project.properties
Updated local.properties
Added file D:\workspace4\hello-jni\tests\build.xml
Added file D:\workspace4\hello-jni\tests\proguard-project.txt
D:\workspace4\hello-jni>ls
AndroidManifest.xml jni local.properties proguard-project.txt res tests
build.xml libs obj project.properties src
执行ant debug构建并生成apk包
在项目的目录结构中
| jni |
原生组件源代码,描述原生组件方法的android.mk |
| libs |
构建过程中创建该目录 |
| obj |
编译源代码后产生的目标文件都放在该目录 |
2.4 构建环境
构建系统的片段位于build/core子目录中
Android.mk位于jni子目录中
示例代码如下
LOCAL_PATH := $(callmy-dir) //定位源文件,my-dir是一个宏
include $(CLEAR_VARS) //clear_vars.mk 擦除local_path以外的local_*
LOCAL_MODULE := hello-jni //定义模块名称 生成libhello-jni.so
LOCAL_SRC_FILES :=hello-jni.c //源文件列表
include$(BUILD_SHARED_LIBRARY) //成生共享库
@@@@@@构建多个共享库,示例代码如下:@@@@@@@@@@
LOCAL_PATH := $(call my-dir)
#模块一
include $(CLEAR_VARS)
LOCAL_MODULE := modul1
LOCAL_SRC_FILES := modul1.c
include $(BUILD_SHARED_LIBRARY)
#模块二
include $(CLEAR_VARS)
LOCAL_MODULE := modul2
LOCAL_SRC_FILES := modul2.c
include $(BUILD_SHARED_LIBRARY)
@@@@@@@@构建静态库(使用第三方源代码)@@@@@@@@@
LOCAL_PATH=$(cal l my-dir)
#第三方avi库
Include $(CLEAR_VARS)
LOCAL_MODULE :=avilib
LOCAL_SRC_FILES :=avilib.c,platform_posix.c
Include $(BUILD_STATIC_LIBRARY)
#原生模块
include $(CLEAR_VARS)
LOCAL_MODULE := modul
LOCAL_SRC_FILES := modul.c
LOCAL_STATIC_LIBRARIES :=avilib //定义变量,使用该模块
include $(BUILD_SHARED_LIBRARY)
@@@@@用共享库,共享通用模块(即多个模块使用同一第一方源代码)@@@@@@@
LOCAL_PATH=$(cal l my-dir)
#第三方avi库
Include $(CLEAR_VARS)
LOCAL_MODULE :=avilib
LOCAL_SRC_FILES :=avilib.c,platform_posix.c
Include $(BUILD_SHARED_LIBRARY)
#原生模块一
include $(CLEAR_VARS)
LOCAL_MODULE := modul1
LOCAL_SRC_FILES := modul1.c
LOCAL_SHARED_LIBRARIES :=avilib //
include $(BUILD_SHARED_LIBRARY)
#原生模块二
include $(CLEAR_VARS)
LOCAL_MODULE := modul2
LOCAL_SRC_FILES := modu2l.c
LOCAL_SHARED_LIBRARIES :=avilib //
include $(BUILD_SHARED_LIBRARY)
@@@@@@@@@@@@@在多个NDK项目中共享模块@@@@@@@@@@@@@@
#原生模块
include $(CLEAR_VARS)
LOCAL_MODULE := modul
LOCAL_SRC_FILES := modul.c
LOCAL_STATIC_LIBRARIES :=avilib
include $(BUILD_SHARED_LIBRARY)
$calll (import_module,**/***) //指定路径名,可以在一环境变量中定义一个共享模块路径(所以***/***可以是一个相对路径)
@@@@@@@@@@@使用prebuilt库@@@@@@@@@@@@@@@@
应用场景: A 在不发布源代码的情况下将你的模块发布给他人
B 想使用共享模块的预见版来加速构建过程
注:prebuilt库中不包含机器体系结构的信息
示例代码如下:
#第三方avi库
Include $(CLEAR_VARS)
LOCAL_MODULE :=avilib
LOCAL_SRC_FILES :=libavilib.so//需要将该库复制到libs目录下
Include $(PREBUILT_STATIC_LIBRARY)
#原生模块一
include $(CLEAR_VARS)
LOCAL_MODULE := modul
LOCAL_SRC_FILES := modul.c
LOCAL_SHARED_LIBRARIES :=avilib //
include $(BUILD_SHARED_LIBRARY)
@@@@@@@@@@@@构建独立的可执行文件@@@@@@@@@@@@@@@@@@
…
include $(BUILD_EXECUTABLE)
…
会生成android设备上的常规linux应用程序,可以直接执行
@@@@@@@@@@@@其他构建系统变量@@@@@@@@@@@@@@@@@@@
| 变量名 |
用途 |
| TARGET_ARCH |
目标CPU体系名称 |
| TARGET_PLATFORM |
Android平台的名称 |
| TARGET_ARCH_ABI |
目标CPU体系名称和ABI的名称 |
| LOCAL_MODULE_FILENAME |
重新定义生成输出文件的名称 |
| LOCAL_CPP_EXTENSION |
可以为c++源文件提供一个或多个扩展名 |
| LOCAL_CPP_FEATURES |
模块所依赖的c++的特性 |
| LOCAL_C_INCLUDES |
NDK安装目录的相对路径,用来搜索头文件 |
| LOCAL_CFLAGS |
编译器标志 |
| LOCAL_CPPFLAGS |
编译器标志 |
| LOCAL_LDLIBS |
目标文件进行链接时所需标志 |
| LOCAL_ALLOW_UNDEFINED _SYMBOLS |
禁止在生成文件中进行缺失符检查 |
| LOCAL_ARM_MODE |
生成ARM二进制类型 |
| LOCAL_ARM_NEON |
指定高给单指令流和多数据流内联函数 |
| LOCAL_DISABLE_NO_EXECUTE |
禁用nx bit安全特性 |
| LOCAL_EXPORT_CFLAGS |
编译标志 |
| LOCAL_EXPORT_CPPFLAGS |
编译标志 |
| LOCAL_EXPORT_LDFLAGS |
链接器标志 |
| LOCAL_EXPORT_C_INCLUDES |
允许记录路径集 |
| LOCAL_SHORT_COMMANDS |
对于有大量资源/独立静态库/共享库,应设为true |
| LOCAL_FLITER_ASM |
过虑来自 local_src_files变量的装配文件 |
@@@@@@@@@@@@@其他的构建系统宏函数@@@@@@@@@@@@@@@@@
| All_subdir_makefiles |
返回当前目录下的所有子目录下的android.mk构建文件列表 |
| This_makefile |
返回当前android.mk的路径 |
| Parent_makefile |
父android.mk路径 |
| Grand_parent_makefile |
祖父目录 |
@@@@@@@@@@@@@@@@定义新变量@@@@@@@@@@@@@@@@@@
变量名:=值
使用时: $(变量名)
@@@@@@@@@@@@@@条件操作@@@@@@@@@@@@@@@@@@@@@@@
Ifeq
…
Else
…
Endif
Application.mk
是一个可选构建文件,应用程序需要哪些模块
| APP_MODULES |
声明所有模块 |
| APP_OPTIM |
Release/debug改变生成二进制文件的优先级 |
| APP_CFLAGS |
编 译器标志 |
| APP_CPPFLAGS |
编译器标志 |
| APP_BUILD_SCRIPT |
在不同目录(非jni目录)下查找构建文件 |
| APP_ABI |
构建系统为armeabi ABI生成二进制文件 |
| APP_STL |
使用最小的STL运行库 |
| APP_GNUSTL_FORCE _CPP_FEATURES |
依赖c++特性 |
| APP_SHORT_COMMANDS |
可以在项目中使用更短的命令 |
2.5 使用NDK-Build角本
Ndk-build参数名称 项目名称
参数:
-C 指定项目路径
-B 重新构建目标
-j 指定并行执行数量(GNU make可以并行执行构建命令)
2.6 排除构建系统故障
开启日志 ndk-build NDK_LOG=1
只显示构建命令ndk-build V=1