Android源码学习之如何使用eclipse+NDK【二】










windows下eclipse集成cygwin编译android_NDK  

http://www.docin.com/p-88450636.html

一、前言

Google Android 发布了 NDK ,引起了很多发人员的兴趣。 NDK 全称: Native Development Kit,官方下载地址:http://androidappdocs.appspot.com/sdk/ndk/index.html

1.         NDK是什么

The Android NDK is a toolset that lets you embed components that make use of native code in your Android applications.

Android applications run in the Dalvik virtual machine. The NDK allows you to implement parts of your applications using native-code languages such as C and C++. This can provide benefits to certain classes of applications, in the form of reuse of existing code and in some cases increased speed.

英语不好的,自己GOOGLE吧。简而言之,NDK就是一套基于C和C++底层开发API的集成工具组件,使用NDK开发编译的应用程序同样可以基于虚拟机Dalvik上“疯跑”。如果你问为啥推出NDK,敝人以为C和C++开发的应用程序其卓越性能不用提了,至少C和C++被反编译的可能性降低了很多,要比JAVA安全保密多了。

2.         ANDROID NDK 带来了什么

a)       一套工具,基于本机编译的C和C++源代码库。

b)       一种部署在ANDROID设备上,可以将so和java一起打包成APK的方法。

c)       A set of native system headers and libraries that will be supported in all future versions of the Android platform, starting from Android 1.5. Applications that use native activities must be run on Android 2.3 or later.(自个理解吧,最好别用GOOGLE,我试过了不是人话。)

d)       NDK集成了交叉编译器,并提供了相应的 mk 文件隔离 CPU 、平台、 ABI 等差异,开发人员只需要简单修改 mk 文件(指出 “ 哪些文件需要编译 ” 、 “ 编译特性要求 ” 等),就可以创建出 so。(此句出自网络)

 

二、“大力神”合体前的准备

1.         集成Cygwin

a)       什么是cygwin

cygwin是一个在windows平台上运行的unix模拟环境,是cygnus solutions公司开发的自由软件(该公司开发了很多好东西,著名的还有eCos,不过现已被Redhat收 购)。它对于学习unix/linux操作环境,或者从unix到windows的应用程序移植,或者进行某些特殊的开发工作, 尤其是使用gnu工具集在windows上进行嵌入式系统开发,非常有用。随着嵌入式系统开发 在国内日渐流行,越来越多的开发者对cygwin产生了兴趣。(出自百度百科)

b)       为啥要集成cygwin

相信你该知道可爱的android是基于linux内核的,所以咱们要基于NDK开发,至少得有一个linux的环境吧。当然你可已选择虚拟机VM,可是如果你是在windows上成长起来的,对Linux的了解程度比我还差的话,那么相信我,还是选择cygwin吧,至少你不用来回切换窗口了。

c)       Cygwin下载与安装

下载地址:http://www.cygwin.com。下载后会保存成setup.exe,双击开始安装。在线安装时首选要选择镜像站点,此处考虑到咱公司的网络现状,建议选择台湾的HTTP站点,http://ftp.ntu.edu.tw。如下图所示

组件安装有两种方式可供选择,一是选择必须的组件如devel 下的gcc-core,gcc-g++, make和lib下的glib2,glib2-devel,各位注意要版本号对应,尽量选择最新的版本。具体选择的如下图:

上图中注意左侧skip的刷新图标,点击后会出现install,而右边是选择组件的名称。(相信智商在90以上的都能看懂。)二是选择All后面的回旋图标,这样无论任何组件都将安装,其下载量大概能有1.7G左右。(尽管这是比较脑残的做法,可是目的还是达到了,也不用选择组件了。因为哥就是这么干的!没错,那两天网速慢就是哥干的。)如下图所示:

 

2.         下载Android NDK.

官方下载地址:http://androidappdocs.appspot.com/sdk/ndk/index.html。最好下载V1.5以上。下载后直接解压即可。鉴于都属于android 开发,所以最好把其放在android SDK的相同目录下,这样寻找Samples的时候会比较省事。

3.         Eclipse组件

Android SDK 不用说了,这不是重点。ADT也不说了,单说CDT。CDT是Eclipse开发C++的组件包,可以在Eclipse的菜单栏HELP选项里选择Install new software ,然后添加站点http://download.eclipse.org/tools/cdt/releases/galileo,在线安装。有必要说明一下,使用NDK开发包来开发android,是不需要CDT的。但是你如果安装了CDT,会在review其他人写的C++ code时有帮助。

三、大力神正式合体。

1、  确保cygwin v1.71以上安装无误后,找到目录C:\cygwin\etc\defaults\etc\skel下的.bash_profile文件,用记事本打开,在最后面加入下面这句话

ANDROID_NDK_ROOT=/cygdrive/e/android/android-ndk-r5  (此处表示NDK安装目录)

export ANDROID_NDK_ROOT

这句话表示的是添加环境变量,就像windows下添加环境变量。然后注意保存。再打开桌面图标Cygwin,在命令行输入:cd $ ANDROID_NDK_ROOT如下图所示

注意环境变量的大小写。回车后会定位至你的NDK安装目录,如下图所示

输入命令 :ls –a,会显示目录下的所有文件已验证目录配置正确。如下图所示

到此处,如果你没弄出来,不要紧,别慌,要淡定。听哥继续说,请把刚才改写的.bash_profile文件拷贝至目录C:\cygwin\home\admin下,关闭cygwin后并重新启动cygwin。按照上述步骤再验证一回。再不好使,那就是人品问题了。

2、  Eclipse下调试samples

有些同志很喜欢上网去找例子,然后拖下来运行。其实这习惯不好,NDK下有现成的例子如samples文件下的hello-jni。请将NDK下的例子拷贝至wokespace目录下,我的是E:\VSS\android\android-ndk-r5\samples,先拷贝hello-jni。这个helloworld程序员最熟悉不过了。接下来你按部就班选择import 后,发现里面没有项目链接文件。别傻,听哥详解。要选择new—>project-->android projectà接下来如下图所示

输入项目名称à选择从源码创建àlocation位置要选择刚才拷贝至workspace下的源码hello-jni。(注意别跟哥学,哥懒了没拷贝源码,直接选择NDK下的samples)。

3、  工程编译

http://blog.163.com/cp7618@yeah/blog/static/702347772011027104219448/

工程目录如下图所示

到这步,你的工程可能会报错,不过别慌。请右键选择项目hellojni-->Build path---> config build path--->Builders--->new,如下图所示

选择program,配置如下图:

我的arguments是:--login -c "cd /cygdrive/E/VSS/android/android-ndk-r5/samples/hello-jni && $ANDROID_NDK_ROOT/ndk-build"

注意选择你自己的真实目录,别抄我的,不然你死定了。

接着配置Refresh选项

再配置Build Options选项

特别要注意选择specify resources,因为要编译C++,所以必须选择jni目录的C++ code ,如下图所示

 

当以上步骤都正确配置无误,保存配置后应该就会自动编译jni目录下的C相关代码并输出相应的.so库文件到工程的libs目录下,libs目录会自动创建。

到此全部配置已经结束,欢迎你进入嵌入式开发的初级阶段。











Eclipse配置NDK_R4开发环境(集成Cygwin 、CDT)  

安装前确认Cygwin已经安装成功,
并在Cygwin 运行环境里配置了NDK 的路径(如F:\android\NDK\android-ndk-r4)到  PATH 环境变量里。
1. 为NDK工程添加Builder 
选择 相应的 Project ,点击右键 选择 Properties ,在窗口里选择Builders ,
新增一个“Android NDK Builder”编译配置:
Eclipse配置NDK_R4开发环境(集成Cygwin 、CDT) - 陈波 - cp7618@yeah的博客
2. 配置 
2.1 在Main 页面里 
Location 栏 选择 你安装Cygewin时配置的root目录下的 bash.exe 所在路径,
F:\android\NDK\Cygewin\root\bin\bash.exe
在Working Directory 里配置路径为 root下的bin目录的路径
F:\android\NDK\Cygewin\root\bin\bash.exe
Eclipse配置NDK_R4开发环境(集成Cygwin 、CDT) - 陈波 - cp7618@yeah的博客
最重要的是在Arguments的配置,(注意! NDK r4版本编译C,C++程序的方式做了变化)
--login -c "cd /cygdrive/f/android/workspace/HelloNDK/jni &&  ndk-build "
以上参数表示 首先 登陆 Cygwin , 然后 进入 HelloNDK 这个工程 下的jni 目录(该目录下存放 c或c++的文件和 Android.mk)。最后 执行 “ndk-build” 命令 执行编译。
如果ndk-build命令无法识别,先确认是否成功配置了NDK 的所在路径(如F:\android\NDK\android-ndk-r4)到Path环境变量里。
2.2 在Refresh 页,选择 Specific resources 并选择要刷新的文件
Eclipse配置NDK_R4开发环境(集成Cygwin 、CDT) - 陈波 - cp7618@yeah的博客
2.3 在Build Options 页 如下选择,则可以实现修改C或C++程序后立自动编译生成**.so 文件
同样选择 C或者C++原程序所在目录下的所有文件,作为相关的资源
Eclipse配置NDK_R4开发环境(集成Cygwin 、CDT) - 陈波 - cp7618@yeah的博客
3. 添加 CDT插件 
直接在线安装就可以了
我的eclipse 是 3.5.1版 ,安装CDT 3.1 也可以用
更新的URL
http://download.eclipse.org/tools/cdt/releases/eclipse3.1 
最后补充一下:如果在Linux下开发NDK ,配置Eclipse自动编译器时,
配置方式略有不同:
其中
Location栏填当前NDK工具包“ndk-build”文件在Linux环境下的路径即可
如:/home/justinchen/AndroidDEV/android-ndk-r4b/ndk-build
告诉Eclipse在程序文件发生变更时,执行ndk-build命令,
Working Directory 
配置为当前工程里的jni所在目录即可
如:/home/justinchen/AndroidDEV/workspace/HelloWorldAndroid/jni 
也可以通过配置变量的方式配置以上路径。










NDK入门实战  

目标:

利用NDK 生成 SO 库,使用 SO 库进行 JNI 调用,在 Android sdcard 创建文件并写入数据。

工具:

NDK1.5 R1, android SDK1.5 R1, SDCARD, Eclipse , ADT 0.9, Eclipse Galileo for C/C++, Cygwin 1.5。

工具比较多,我是在Windows XP 进行操作的,如果在 Ubuntu 或者其他的 Linux 系统下进行操作直接进入步骤 2 即可。请看步骤:

1.  安装Cygwin

关于Cygwin 的安装请自行百度或者 google ,因为网速原因,建议大家使用本地安装包进行下载:http://www.gougou.com/search?search=cygwin&id=2  下载一个 38.2M  即可,我用的就是这个版本。

2.  安装NDK

进入正题安装NDK ,首先打开 cygwin ,然后使用 cd 命令进入你的 NDK 根目录,(不会用 linux 命令?? Google 去),然后运行: build/host-setup.sh

 

 


 

如果出现以上的信息,说明安装正确,如果出现GCC 为找到,请输入 gcc 命令查看,如果出现 toolchain 未找到的信息,请试着修改 build/host-setup.sh 文件第一行代码,将: #!/bin/sh 改成 #!/bin/bash , 在 Ubuntu 上这个是需要修改的

安装成后,我们使用make 命令试试编译自带的程序,输入 make APP=hello-jni,hello-jni 为 apps 下 hello-jni 文件夹的名称,这个命令会先找到 apps\hello-jni 下地 Application.mk 文件,然后找到 source\samples\hello-jni 这个目录,然后找到 Android.mk 这个文件中的配置信息进行编译。看图:

因为我的已经编译过了,使用使用 make APP=hello-jni -B 进行重新编译

 


 

出现上面的信息,说明编译成功,so 文件在 apps/hello-jni/project/libs/armeabi 文件夹下。

3.  书写java native 接口

下面我们进入实战的阶段,写代码。

建立一个android1.5 的项目, NDK 不支持 1.5 以下的版本

 

 


 

 

JNI.java的代码:

 



 JniTest.java的代码:


 

 

4.  生成JNI  头文件

下面生成JNI 头文件啦,使用 javah 命令,对 JNI..java 这个文件生成,别搞错啦!

使用cmd 进入 android 项目的 bin 目录中,然后执行  javah -classpath .  -jni cc.androidos.jni.JNI 这个命令。别忘记包名!( ^_^ )

 


生成了一个cc_androidos_jni_JNI.h

打开看看:

 


里面都是c 语言的头文件声明

5.  书写C 代码,写入数据

下面进行c 语言代码的阶段,不会 C 的,可以去学习一下。

我这里使用eclipse for c/c++ 的进行开发,简单的代码大家可以使用记事本。

工程如下:

 


cc_androidos_jni_JNI.h内容不变

cc_androidos_jni_JNI.c的内容:

 


 

在这里的代码会在运行的时候向sdcard 写入 androidos.cc.txt 文件。然后写入 aaaa 数据。

6.  编译SO 文件

进行编译so 文件:

在NDK 的 apps 目录下面创建一个 myjni 文件夹,在 myjni 文件夹中创建一个 Application.mk 文件,文件的内容为:


 

 

在NDKsources 目录下创建 myjni 文件夹,在 myjni 文件中创建一个 Android.mk 文件,然后将 cc_androidos_jni_JNI.h 和 cc_androidos_jni_JNI.c 文件 copy 进来:

 


 

 

Android.mk中的内容如下:

 


里面内容的关键字含义请自行查看docs\OVERVIEW.TXT 文件

编译:


 

7.  加入到Android 项目中进行运行

将apps\myjni\libs 整个文件夹 copy 到 android 项目下:

 


运行android 项目使用 adb shell 进行查看:


 

进入sdcard 查看数据。

注意:sdcard 具有 system 的权限,如果你的目录是 root 权限的,那么是不能写成功的,除非是真机越权,模拟器是不成功的,并且在 Eclipse logcat 下会有 DEBUG 信息出现。








Android.mk文件语法规范  



序言:
-------------

此文档旨在描述Android.mk文件的语法,Android.mk文件为Android NDK(原生开发)描述了你C/C++源文件。
为了明白下面的内容,你必须已经阅读了docs/OVERVIEW.TXT的内容,它解释了Android.mk文件扮演的角色
和用途。

概述:
---------


写一个Android.mk文件是为了向生成系统描述你的源代码。更明确的说:

- 这个文件实际上是GNU Make文件的一小片段,它会被生成系统解析一次或多次。
因此,你应该在Android.mk里尽量少地声明变量,而不要误以为在解析的过程中
没有任何东西被定义。

- 该文件的语法的明的人为了让你能将你的源代码组织为组件(module).一个组件指的是下面的一项:
     - 一个静态库(static library)
     - 一个共享库(shared library)

   
只有一个动态库会被安装/拷贝至你的application package中。但是静态库可用来
生成动态库。

你可以在每个Android.mk文件定义一个或多个组件,并且我可以在几个组件中使用
相同的源文件。


- 生成系统为你处理了一些琐碎之事。比如,在你的Android.mk里,你不须要列出头文件或
列出生成的文件之间的明确认依赖关系。NDK生成系统会为你自动生成。

这也意味着,当更新至新的NDK版本时,你能得到新的工具链/平台支持(toolchain/platform support)
的好处,而无须修改你的android.mk文件。

需要注意的是,此语法与完全开源的Android平台的Android.mk文件的语法非常相似,但使用它们的
生成系统的实现不同,这个为了让开发者能更容易的复用“外部”库的源代码。


简单例子:
---------------

在详细描述语法之前,让我们探究一个简单的“hello JNI”例子,它的文件位于:
    apps/hello-jni/projec

这里,我们能看到:

- 放有Java源文件的src文件夹。

- 放有本地源文件,即jni/hello-jni.c的jni文件夹。

    这个源文件实现一个简单的共享库。这个共享库有一个本地方法(native method),它将一个字符串
    返回给虚拟机应用(著:即Java层应用程序)

- jni/Anroid.mk文件为NDK生成系统描述了这个共享库。它的内容为:

   ---------- cut here ------------------
   LOCAL_PATH := $(call my-dir)

   include $(CLEAR_VARS)

   LOCAL_MODULE    := hello-jni
   LOCAL_SRC_FILES := hello-jni.c

   include $(BUILD_SHARED_LIBRARY)
   ---------- cut here ------------------

现在,让我们逐行解释:

LOCAL_PATH := $(call my-dir)

每个Android.mk文件都必须以定义LOCAL_PATH变量开始。其目的是为了定位源文件的位置。在这个例子,
生成系统提供的宏函数(macro function)‘my-dir'用来返回当前路径(即放有Android.mk文件的文件夹)

include $(CLEAR_VARS)

CLEAR_VARS变量是生成系统提供的,它指向一个特殊的GNU Makefile.这个Makefile将会为你自动清除
许多名为LOCAL_XXX的变量(比如:LOCAL_MODULE,LOCAL_SRC_FILES,LOCAL_STATIC_LIBRARIES,等),
但LOCAL_PATH是例外,它不会被清除。这些变量的清除是必须的,因为所有的控制文件是在单一的GNU make
执行环境中解析的,在这里所有的变量都是全局的。

LOCAL_MODULE := hello-jni

为了在你的Android.mk文件标识每个组件,必须定义LOCAL_MODULE变量。这个名字必须要唯一的并且不能
包含空格。注意:生成系统会自动地为相应生成的文件加入前缀或后缀。换言之,一个名叫foo的共享库组件
会生成'libfoo.so'.

重要注意事项:
如果你把组件取名为‘libfoo',生成系统将不会加上‘lib'前缀,还是
生成libfoo.so。这是为了支持源于Android平台源代码的Android.mk文件。

LOCAL_SRC_FILES := hello-jni.c

LOCAL_SRC_FILES变量必须包含一系列将被构建和组合成组件的C/C++源文件。注意:你
不需要列出头文件或include文件,因为生成系统会为你自动计算出源文件的依赖关系。
仅仅列出那些将直接传给编译器的源文件足矣。


注意,默认的C++源文件的扩展名是‘.cpp'。但你可以通过定义LOCAL_DEFAULT_EXTENSION
来指定一个扩展名。别忘了扩展名开始的那一点(比如,‘.cxx’,能行,但‘cxx'不行)。

include $(BUILD_SHARED_LIBRARY)

生成系统提供的BUIL_SHARED_LIBRARY变量指向一个GNU Makefile脚本,这个脚本主管
收集在最近的一次#include $(CLEAR_VARS)(著:即清除'本地'变量)之后你所定义的
LOCAL_XXX变量的信息,并决定生成什么,如何准确的生成。BUILD_STATIC_LIBRARY可
生成一个静态库。

There are more complex examples under apps/, with commented
Android.mk files that you can look at.
在apps文件下有一些复杂点的例子,它带有注释的Android.mk文件以供你学习。

参考:
-----------

以下列出你在Android.mk里应该依赖或定义的变量。你能定义其它变量,但下列的变量名是
由NDK生成系统保留的。

- 以LOCAL_ 开头的变量名 (比如,LOCAL_MODULE)
- 以PRIVATE_ ,NDK_ 或 APP_ (内部使用)开头的量名
_ 小写字母变量名(内部使用,如 my-dir).


如果你需要在Android.mk里定义方便自己使用的变量名,我们建议使用MY_ 前缀,
如下面一个简单例子:

   ---------- cut here ------------------
    MY_SOURCES := foo.c
    ifneq ($(MY_CONFIG_BAR),)
      MY_SOURCES += bar.c
    endif

    LOCAL_SRC_FILES += $(MY_SOURCES)
   ---------- cut here ------------------
  

So, here we go:


NDK提供的变量:
- - - - - - - - - - - - - -

下列的这些GNU Make变量是在你的Android.mk被解析之前,就被生成系统事先定义
的了.注意,在某些情况下,NDK可能会多次解析你的Android.mk,每次对其中一些变量的
定义不同。

CLEAR_VARS
    指向一个生成脚本,这个脚本取消几乎所有LOCAL_XXX变量的定义(译者注:除了LOCAL_PATH)。
    在开始描述一个新的组件之前,你必须include这个脚本,e.g.:
    
      include $(CLEAR_VARS)
    
    
BUILD_SHARED_LIBRARY
   指向一个生成脚本,这个脚本通过LOCAL_XXX变量收集关于组件的信息,并决定如何
   根据你列出来的源文件生成目标分享库。注意,在include这个脚本文件之前你必须
   至少已经定义了LOCAL_MODULE和LOCAL_SRC_FILES。用法举例:
     include $(BUILD_SHARED_LIBRARY)
     
   注意,这会生成一个名为 lib$(LOCAL_MODULE).so的文件。(译者注:$(BUILD_SHARED_MODULE)为文件名)

    
BUILD_STATIC_LIBRARY
    与BUILD_SHARED_LIBRARY类似,但用来生成目标静态库。静态库不会被拷贝至你的
    project/packages文件夹下,但可用来生成分享库(参考 LOCAL_STATIC_LIBRARIES
    和LOCAL_STATIC_WHOLE_LIBRARIES,将在后面描述)
    用法示例:

       include $(BUILD_STATIC_LIBRARY)

    注意,这会生成一个方件名叫lib$(LOCAL_MODULE).a
   

TARGET_ARCH
   目标CPU的名字,在完整的Android开源代码的生成中指定。对于基于ARM兼容的CPU,
   它被指定为'arm',与CPU架构的修订无关。
    
   
TARGET_PLATFORM
   当解析该Android.mk文件时用它来指定Andoid目标平台的名称。譬如,'android-3'与
   Android 1.5系统镜像相对应。若要了解所有的平台名称及其相应的Android系统镜像,
   请阅读docs/STABLE-APIS.TXT

    
TARGET_ARCH_ABI
    当解析该Android.mk时,CPU+ABI的名称。目前只有一个值。
    (译者注:ABI,Application Binary Interface,二进制应用程序接口)

       armeabi    For Armv5TE
       
       armeabi    指定Armv5TE
          
    注意:到NDK 1.6_r1为止,仅简单的定义这个变量为'arm'。但为了更好地配合
    Android平台的内部使用,该值已重定义。
    
    关于ABI与相应的兼容问题更多详情,请阅读docs/CPU-ARCH-ABIS.TXT

    未来的NDK版本将会引入其它的平台的ABI并会有不同的名称。注意,所有基于ARM的ABI会
    使TARGET_ARCH定义为'arm',但可能拥有不同的TARGET_ARCH_ABI
   
    
TARGET_ABI   
    目标平台与abi的连接,它实际上被定义为 $(TARGET_PLATFORM)-$(TARGET_ARCH_ABI),
    当你想在一个真实的装置上测试特定的目标系统镜像时,它就很有用了。
    
    默认下,它的值为'android-3-armeabi'
    
    (在Android NDK 1.6_r1及之前的版本,它的默认值为'android-3-arm')
    
   

NDK提供的宏函数:
----------------------------

以下是一些GNU Make的宏‘函数’,必须通过这样的形式调用:'$(call <function>)'。
函数返回文本信息。
        
my-dir
    返回放置当前Android.mk的文件夹相对于NDK生成系统根目录的路径。可用来
    在Android.mk的开始处定义LOCAL_PATH的值:
    
       LOCAL_PATH := $(call my-dir)      

        
all-subdir-makefiles
      返回‘my-dir’子目录下的所有Android.mk。比如,代码的结构如下:
     sources/foo/Android.mk
        sources/foo/lib1/Android.mk
        sources/foo/lib2/Android.mk
        
    如果sources/foo/Android.mk里有这样一行:
        
        include $(call all-subdir-makefiles)
    
    那么,它将会自动地includesources/foo/lib1/Android.mk和sources/foo/lib2/Android.mk
    
    这个函数能将深层嵌套的代码文件夹提供给生成系统。注意,默认情况下,NDK仅在
    source/*/Android.mk里寻找文件。

    
this-makefile
     返回当前Makefile(译者注:指的应该是GNU Makefile)的路径(即,这个函数是在哪里调用的)


parent-makefile
     返回在列入树(inclusion tree)中的父makefile的路径。
    即,包含当前makefile的那个makefile的路径。  


grand-parent-makefile
    猜猜看...(译者注:原文为Guess what...)


组件描述相关的变量:
- - - - - - - - - -


以下的变量是用来向生成系统描述你的组件的。你应该在'include $(CLEAR_VARS)'
和'include $(BUILD_XXXXX)'之间定义其中的一些变量。正如在前面所说的,$(CLEAR_VARS)
是一个将会取消所有这些变量的脚本,除非在对变量的描述时有显式的说明。

    
LOCAL_PATH
   这个变量用来设置当前文件的路径。你必须在Android.mk的开始处定义它,比如:
     
    LOCAL_PATH := $(call my-dir)
    
   这个变量不会被$(CLEAR_VARS)消除,所以每个Android.mk仅需一个定义(以防你在
   同一个文件里定义几个组件)。
  
    
LOCAL_MODULE
   定义组件的名称。对于所有的组件名,它必须是唯一,且不能包含空格。
   在include $(BUILD_XXX)之前你必须定义它。
  
   这个组件名决定生成的文件(译者注:即库名)。比如,lib<foo>,即这个组件的名称
   为<foo>。但是在你的NDK生成文件(不管是Android.mk还是Application.mk)中
   你只能通过‘正常’的名称(如,<foo>)来引用其它的组件。
  
          
LOCAL_SRC_FILES
   用它来定义所有用来生成组件的源文件。仅须列出传给编译器的文件,因为
   生成系统会自动地计算它们的相互依赖关系。
  
   注意,所有文件名都是相对于LOCAL_PATH的,你可以用到路径组件(path component)
   如:
     LOCAL_SRC_FILES := foo.c \ (译者注:‘\’为连接符)
                         toto/bar.c

        
LOCAL_CPP_EXTENSION
   这是一个可选的变量,可用它来指明C++源文件的扩展名。默认情况下是'.cpp',
   但你可以改变它。比如:
    
     LOCAL_CPP_EXTENSION := .cxx

      
    
LOCAL_C_INCLUDES
   一个相对于相对于NDK*根*目录可选的路径名单,当编译所有的源文件(C,C++和汇编)时,
   它将被添加进include搜索路径。例如:
   
      LOCAL_C_INCLUDES := sources/foo
  
     或者甚至:
     
      LOCAL_C_INCLUDES := $(LOCAL_PATH)/../foo


LOCAL_CFLAGS
    一个可选的编译标记集,在生成C与C++源文件时,将解析它。
    
    对指定额外的宏定义或编译选项很有用。
               
    重要:不要试图改变你Android.mk里的optimization/debuggin level,通过
          在你的Android.mk里指定合适的信息,它将被自动处理,并使NDK生成
          调试时可用的有用的数据文件。
          
    注意:在android-ndk-1.5_r1,相应的标记(flags)只适用于C源文件,对C++
        源文件并不适用。为了适用于完整的Android生成系统的特性,已作了修
        正。(现在,你可以使用LOCAL_CPPFLAGS为C++文件指定标记)

LOCAL_CXXFLAGS
    LOCAL_CPPFLAGS的别名。注意,不建议使用这个变量,因为在未来的NDK版本中,
    它可能会消失。

LOCAL_CPPFLAGS
     一个可选的编译标记集,*仅*在生成C++源文件时解析它。在编译器的命令行里
     它将在LOCAL_CFLAGS之后出现。

    注意:在android-ndk-1.5_r1,相应的标记(flags)适用于C与C++源文件。
        为了适用于完整的Android生成系统的特性,已作了修
        正。(现在,你可以使用LOCAL_CFLAGS为C和C++源文件指定标记)

LOCAL_STATIC_LIBRARIES
    一份static libraries组件的名单(以BUILD_STATIC_LIBRARY的方式生成),它将被
    连接到欲生成的组件上。这仅在生成shared library组件时有意义。(译者注:将指定
    的一个或多个static library module转化为一个shared library module)

LOCAL_SHARED_LIBRARIES
    一份该组件在运行期依赖于它的shared libraries *组件*。在连接时间(link time)里
    与及为该生成的文件嵌入相应的信息都要用到它。

    注意,它并不将这份组件名单添加入生成图表(build graph)。即,在你的Android.mk
    里,你仍应该将它们加入到你的应用程序要求的组件。

LOCAL_LDLIBS
    一份能在生成你的组件时用到的额外的连接器标记(linkerflags)的名单。在传递
    有“-l”前缀的特殊系统库的名称时很有用。比如,下面的语句会告诉连接器在装载 
    时间(load time)里生成连接到/system/lib/libz.so的组件。

      LOCAL_LDLIBS := -lz

    若想知道在这个NDK版本可以连接哪些暴露的系统库(exposed system libraries),
    请参见docs/STABLE-APIS。

LOCAL_ALLOW_UNDEFINED_SYMBOLS
    缺省值情况下,当尝试生成一个shared library遇到没有定义的引用时,会导致“undefined 
    symbol”error。这对在你的源代码里捕捉bugs有很大的帮助。
    
    但是,因为一些原因你须要disable这个检查,将这个变量设置为'true’。注意,相应
    的shared library可能在运行期装载失败。

LOCAL_ARM_MODE
    缺省值情况下,ARM目标二进制将会以‘thumb’模式生成,这时每个指令都是16-bit宽的。
    如果你想强迫组件的object文件以‘arm’(32位的指令)的模式生成,你可以将这个变量
    定义为'arm'。即:

      LOCAL_ARM_MODE := arm

    注意,你也可以通过将‘.arm’后缀添加到源文件名字的后面指示生成系统将指定的
    源文件以arm模式生成。例如:
   

       LOCAL_SRC_FILES := foo.c bar.c.arm

    告诉生成系统总是以arm模式编译‘bar.c’,但根据LOCAL_ARM_MODE的值生成foo.c

    注意:在你的Application.mk里将APP_OPTIM设置为'debug',这也会强迫生成ARM二进制
    代码。这是因为工具链的调度器有bugs,它对thumb码的处理不是很好。

 

 

怎样添加一个模块
LOCAL_PATH:= $(call my-dir)
#编译静态库
include $(CLEAR_VARS)
LOCAL_MODULE = libhellos
LOCAL_CFLAGS = $(L_CFLAGS)
LOCAL_SRC_FILES = hellos.c
LOCAL_C_INCLUDES = $(INCLUDES)
LOCAL_SHARED_LIBRARIES := libcutils
LOCAL_COPY_HEADERS_TO := libhellos
LOCAL_COPY_HEADERS := hellos.h
include $(BUILD_STATIC_LIBRARY)

#编译动态库
include $(CLEAR_VARS)
LOCAL_MODULE = libhellod
LOCAL_CFLAGS = $(L_CFLAGS)
LOCAL_SRC_FILES = hellod.c
LOCAL_C_INCLUDES = $(INCLUDES)
LOCAL_SHARED_LIBRARIES := libcutils
LOCAL_COPY_HEADERS_TO := libhellod
LOCAL_COPY_HEADERS := hellod.h
include $(BUILD_SHARED_LIBRARY)

BUILD_TEST=true
ifeq ($(BUILD_TEST),true)
#使用静态库
include $(CLEAR_VARS)
LOCAL_MODULE := hellos
LOCAL_STATIC_LIBRARIES := libhellos
LOCAL_SHARED_LIBRARIES :=
LOCAL_LDLIBS += -ldl
LOCAL_CFLAGS := $(L_CFLAGS)
LOCAL_SRC_FILES := mains.c
LOCAL_C_INCLUDES := $(INCLUDES)
include $(BUILD_EXECUTABLE)

#使用动态库
include $(CLEAR_VARS)
LOCAL_MODULE := hellod
LOCAL_MODULE_TAGS := debug
LOCAL_SHARED_LIBRARIES := libc libcutils libhellod
LOCAL_LDLIBS += -ldl
LOCAL_CFLAGS := $(L_CFLAGS)
LOCAL_SRC_FILES := maind.c
LOCAL_C_INCLUDES := $(INCLUDES)
include $(BUILD_EXECUTABLE)
endif # ifeq ($(WPA_BUILD_SUPPLICANT),true)

########################
#local_target_dir := $(TARGET_OUT)/etc/wifi
#include $(CLEAR_VARS)
#LOCAL_MODULE := wpa_supplicant.conf
#LOCAL_MODULE_TAGS := user
#LOCAL_MODULE_CLASS := ETC
#LOCAL_MODULE_PATH := $(local_target_dir)
#LOCAL_SRC_FILES := $(LOCAL_MODULE)
#include $(BUILD_PREBUILT)
########################
系统变量解析
LOCAL_MODULE - 编译的目标对象
LOCAL_SRC_FILES - 编译的源文件
LOCAL_C_INCLUDES - 需要包含的头文件目录
LOCAL_SHARED_LIBRARIES - 链接时需要的外部库
LOCAL_PRELINK_MODULE - 是否需要prelink处理
BUILD_SHARED_LIBRARY - 指明要编译成动态库


LOCAL_PATH - 编译时的目录
$(call 目录,目录….) 目录引入操作符
如该目录下有个文件夹名称 src,则可以这样写 $(call src),那么就会得到 src 目录的完整路径

include $(CLEAR_VARS) -清除之前的一些系统变量
CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk
在 build/core/config.mk 定义 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk
通过include 包含自定义的.mk文件(即是自定义编译规则)或是引用系统其他的.mk文件(系统定义的编译规则)。

LOCAL_SRC_FILES - 编译的源文件
可以是.c, .cpp, .java, .S(汇编文件)或是.aidl等格式
不同的文件用空格隔开。如果编译目录子目录,采用相对路径,如子目录/文件名。也可以通过$(call 目录),指明编译某目录
下所有.c/.cpp/.java/.S/ .aidl文件.追加文件 LOCAL_SRC_FILES += 文件

LOCAL_C_INCLUDES - 需要包含的头文件目录
可以是系统定义路径,也可以是相对路径. 如该编译目录下有个include目录,写法是include/*.h

LOCAL_SHARED_LIBRARIES - 链接时需要的外部共享库
LOCAL_STATIC_LIBRA RIES - 链接时需要的外部外部静态
LOCAL_JAVA_LIBRARIES 加入jar包

LOCAL_MODULE - 编译的目标对象
module 是指系统的 native code,通常针对c,c++代码
./system/core/sh/Android.mk:32:LOCAL_MODULE:= sh
./system/core/libcutils/Android.mk:71:LOCAL_MODULE := libcutils
./system/core/cpio/Android.mk:9:LOCAL_MODULE := mkbootfs
./system/core/mkbootimg/Android.mk:8:LOCAL_MODULE := mkbootimg
./system/core/toolbox/Android.mk:61:LOCAL_MODULE:= toolbox
./system/core/logcat/Android.mk:10:LOCAL_MODULE:= logcat
./system/core/adb/Android.mk:65:LOCAL_MODULE := adb
./system/core/adb/Android.mk:125:LOCAL_MODULE := adbd
./system/core/init/Android.mk:20:LOCAL_MODULE:= init
./system/core/vold/Android.mk:24:LOCAL_MODULE:= vold
./system/core/mountd/Android.mk:13:LOCAL_MODULE:= mountd

LOCAL_PACKAGE_NAME 
Java 应用程序的名字用该变量定义
./packages/apps/Music/Android.mk:9:LOCAL_PACKAGE_NAME := Music
./packages/apps/Browser/Android.mk:14:LOCAL_PACKAGE_NAME := Browser
./packages/apps/Settings/Android.mk:8:LOCAL_PACKAGE_NAME := Settings
./packages/apps/Stk/Android.mk:10:LOCAL_PACKAGE_NAME := Stk
./packages/apps/Contacts/Android.mk:10:LOCAL_PACKAGE_NAME := Contacts
./packages/apps/Mms/Android.mk:8:LOCAL_PACKAGE_NAME := Mms
./packages/apps/Camera/Android.mk:8:LOCAL_PACKAGE_NAME := Camera
./packages/apps/Phone/Android.mk:11:LOCAL_PACKAGE_NAME := Phone
./packages/apps/VoiceDialer/Android.mk:8:LOCAL_PACKAGE_NAME := VoiceDialer


BUILD_SHARED_LIBRARY - 指明要编译成动态库。
编译的目标,用include 操作符
UILD_STATIC_LIBRARY来指明要编译成静态库。
如果是java文件的话,会用到系统的编译脚本host_java_library.mk,用BUILD_PACKAGE来指明。三个编译
-------------------
include $(BUILD_STATIC_LIBRARY)
BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk
-------------------
include $(BUILD_SHARED_LIBRARY)
./build/core/config.mk:50:BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk
-------------------
include $(BUILD_HOST_SHARED_LIBRARY)
BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk
-------------------
include $(BUILD_EXECUTABLE)
build/core/config.mk:51:BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk
-------------------
include $(BUILD_HOST_EXECUTABLE)
./build/core/config.mk:53:BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk
-------------------
BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk
-------------------
BUILD_JAVA_LIBRARY
./build/core/config.mk:58:BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk
------------------
BUILD_STATIC_JAVA_LIBRARY 编译静态JAVA库
./build/core/config.mk:59:BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk
------------------
BUILD_HOST_JAVA_LIBRARY 编译本机用的JAVA库
./build/core/config.mk:60:BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk
------------------

BUILD_HOST_STATIC_LIBRARY:= $(BUILD_SYSTEM)/host_static_library.mk
BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk
BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk
BUILD_RAW_STATIC_LIBRARY := $(BUILD_SYSTEM)/raw_static_library.mk
BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk
BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk
BUILD_RAW_EXECUTABLE:= $(BUILD_SYSTEM)/raw_executable.mk
BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk
BUILD_PACKAGE:= $(BUILD_SYSTEM)/package.mk
BUILD_HOST_PREBUILT:= $(BUILD_SYSTEM)/host_prebuilt.mk
BUILD_PREBUILT:= $(BUILD_SYSTEM)/prebuilt.mk
BUILD_MULTI_PREBUILT:= $(BUILD_SYSTEM)/multi_prebuilt.mk
BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk
BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk
BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk
BUILD_DROIDDOC:= $(BUILD_SYSTEM)/droiddoc.mk
BUILD_COPY_HEADERS := $(BUILD_SYSTEM)/copy_headers.mk
BUILD_KEY_CHAR_MAP := $(BUILD_SYSTEM)/key_char_map.mk

============
LOCAL_PRELINK_MODULE
Prelink利用事先链接代替运行时链接的方法来加速共享库的加载,它不仅可以加快起动速度,还可以减少部分内存开销,
是各种Linux架构上用于减少程序加载时间、缩短系统启动时间和加快应用程序启动的很受欢迎的一个工具。程序运行时的
动态链接尤其是重定位(relocation)的开销对于大型系统来说是很大的。
动态链接和加载的过程开销很大,并且在大多数的系统上, 函数库并不会常常被更动, 每次程序被执行时所进行的链接
动作都是完全相同的,对于嵌入式系统来说尤其如此。因此,这一过程可以改在运行时之前就可以预先处理好,即花一些时间
利用Prelink工具对动态共享库和可执行文件进行处理,修改这些二进制文件并加入相应的重定位等信息,节约了本来在程序
启动时的比较耗时的查询函数地址等工作,这样可以减少程序启动的时间,同时也减少了内存的耗用。 
Prelink的这种做法当然也有代价:每次更新动态共享库时,相关的可执行文件都需要重新执行一遍Prelink才能保
证有效,因为新的共享库中的符号信息、地址等很可能与原来的已经不同了,这就是为什么 android framework代码一改动,
这时候就会导致相关的应用程序重新被编译。
这种代价对于嵌入式系统的开发者来说可能稍微带来一些复杂度,不过好在对用户来说几乎是可以忽略的。
--------------------
变量设置为false那么将不做prelink操作
LOCAL_PRELINK_MODULE := false
默认是需要prlink的,同时需要在 build/core/prelink-linux-arm.map 中加入
libhellod.so 0x96000000
这个map文件好像是制定动态库的地址的,在前面注释上面有一些地址范围的信息,注意库与库之间的间隔数,
如果指定不好的话编译的时候会提示说地址空间冲突的问题。另外,注意排序,这里要把数大的放到前面去,
按照大小降序排序。
解析 LOCAL_PRELINK_MODULE 变量
build/core/dynamic_binary.mk:94:ifeq ($(LOCAL_PRELINK_MODULE),true)
ifeq ($(LOCAL_PRELINK_MODULE),true)
$(prelink_output): $(prelink_input) $(TARGET_PRELINKER_MAP) $(APRIORI)
$(transform-to-prelinked)
transform-to-prelinked定义:
./build/core/definitions.mk:1002:define transform-to-prelinked
define transform-to-prelinked
@mkdir -p $(dir $@)
@echo "target Prelink: $(PRIVATE_MODULE) ($@)"
$(hide) $(APRIORI) \
--prelinkmap $(TARGET_PRELINKER_MAP) \
--locals-only \
--quiet \
$< \
--output $@
endef
./build/core/config.mk:183:APRIORI := $(HOST_OUT_EXECUTABLES)/apriori$(HOST_EXECUTABLE_SUFFIX)
prelink工具不是常用的prelink而是apriori,其源代码位于” <your_android>/build/tools/apriori”
参考文档:
动态库优化——Prelink(预连接)技术
http://www.eefocus.com/article/09-04/71629s.html


===============
LOCAL_ARM_MODE := arm
目前Android大部分都是基于Arm处理器的,Arm指令用两种模式Thumb(每条指令两个字节)和arm指令(每条指令四个字节)

LOCAL_CFLAGS += -O3 -fstrict-aliasing -fprefetch-loop-arrays
通过设定编译器操作,优化级别,-O0表示没有优化,-O1为缺省值,-O3优化级别最高
LOCAL_CFLAGS += -W -Wall
LOCAL_CFLAGS += -fPIC -DPIC
LOCAL_CFLAGS += -O2 -g -DADB_HOST=1 -Wall -Wno-unused-parameter
LOCAL_CFLAGS += -D_XOPEN_SOURCE -D_GNU_SOURCE -DSH_HISTORY
LOCAL_CFLAGS += -DUSEOVERLAY2
根据条件选择相应的编译参数
ifeq ($(TARGET_ARCH),arm)
LOCAL_CFLAGS += -DANDROID_GADGET=1
LOCAL_CFLAGS := $(PV_CFLAGS)
endif
ifeq ($(TARGET_BUILD_TYPE),release)
LOCAL_CFLAGS += -O2
endif

LOCAL_LDLIBS := -lpthread
LOCAL_LDLIBS += -ldl

ifdef USE_MARVELL_MVED
LOCAL_WHOLE_STATIC_LIBRARIES += lib_il_mpeg4aspdecmved_wmmx2lnx lib_il_h264decmved_wmmx2lnx
LOCAL_SHARED_LIBRARIES += libMrvlMVED
else
LOCAL_WHOLE_STATIC_LIBRARIES += lib_il_h264dec_wmmx2lnx lib_il_mpeg4aspdec_wmmx2lnx
endif









基于bert实现关系三元组抽取python源码+数据集+项目说明.zip基于bert实现关系三元组抽取python源码+数据集+项目说明.zip基于bert实现关系三元组抽取python源码+数据集+项目说明.zip基于bert实现关系三元组抽取python源码+数据集+项目说明.zip基于bert实现关系三元组抽取python源码+数据集+项目说明.zip 个人大四的毕业设计、课程设计、作业、经导师指导并认可通过的高分设计项目,评审平均分达96.5分。主要针对计算机相关专业的正在做毕设的学生和需要项目实战练习的学习者,也可作为课程设计、期末大作业。 [资源说明] 不懂运行,下载完可以私聊问,可远程教学 该资源内项目源码是个人的毕设或者课设、作业,代码都测试ok,都是运行成功后才上传资源,答辩评审平均分达到96.5分,放心下载使用! 1、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 2、本项目适合计算机相关专业(如计科、人工智能、通信工程、自动化、电子信息等)的在校学生、老师或者企业员工下载学习,也适合小白学习进阶,当然也可作为毕设项目、课程设计、作业、项目初期立项演示等。 3、如果基础还行,也可在此代码基础上进行修改,以实现其他功能,也可用于毕设、课设、作业等。 下载后请首先打开README.md文件(如有),供学习参考。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值