Android NDK 学习小结
一:什么是NDK?
NDK 提供了一系列的工具,帮助开发者快速开发C(或C++)的动态库,并能自动将so 和java 应用一起打包成apk。这些工具对开发者的帮助是巨大的。
NDK 集成了交叉编译器,并提供了相应的mk 文件隔离CPU、平台、ABI 等差异,开发人员只需要简单修改mk 文件(指出“哪些文件需要编译”、“编译特性要求”等),就可以创建出so。NDK 可以自动地将so 和Java 应用一起打包,极大地减轻了开发人员的打包工作。比较简单的说,NDK是一套交叉编译工具,它可以帮你把你用C或C++书写的代码,编译为.so(类似与 win下的.dll)格式的文件,使你可以在你的Android程序当中用Java语言(JNI)调用这些代码.
二:下载安装cygwin
由于NDK编译代码时必须要用到make和gcc,所以你必须先搭建一个linux环境, cygwin是一个在windows平台上运行的unix模拟环境,它对于学习unix/linux操作环境,或者从unix到windows的应用程序 移植,非常有用。通过它,你就可以在不安装linux的情况下使用NDK来编译C、C++代码了。下面我们一步一步的安装cygwin吧。
(安装的时候忘记截图了)
首先,你得先跑到http://www.cygwin.com下载setup.exe
1、 然后双击运行吧,运行后你将看到安装向导界面:
2、 点击"下一步" 此时让你选择安装方式:
1)Install from Internet:直接从Internet上下载并立即安装(安装完成后,下载好的安装文件并不会被 删除,而是仍然被保留,以便下次再安装)。
2)Download Without Installing:只是将安装文件下载到本地,但暂时不安装。
3)Install from Local Directory:不下载安装文件,直接从本地某个含有安装文件的目录进行安装。
3、选择第一项,然后点击下一步:
4、选择要安装的目录,注意,最好不要放到有中文和空格的目录里,似乎会造成安装出问题,其它选项不用变, 之后点下一步:
5、上一步是选择安装cygwin的目录,这个是选择你下载的安装包所在的目录,默认是你运行setup.exe的目 录,直接点下一步就可以:
6、此时你共有三种连接方式选择:
1) Direct Connection:直接连接。
2) Use IE5 Settings:使用IE的连接参数设置进行连接。
3) Use HTTP/FTP Proxy:使用HTTP或FTP代理服务器进行连接(需要输入服务器地址、端口号)。
用户可根据自己的网络连接的实情情况进行选择,一般正常情况下,均选择第一种,也就是直接连接方式。然后 再点击“下一步”,
7、 这是选择要下载的站点,我用的是http://mirrors.kernel.org,速度感觉还挺快,选择后点下一步
8、 此时会下载加载安装包列表
9、Search是可以输入你要下载的包的名称,能够快速筛选出你要下载的包。那四个单选按钮是选择下边树的样式,默认就行,不用动。View默认是 Category,建议改成full显示全部包再查,省的一些包被隐藏掉。左下角那个复选框是是否隐藏过期包,默认打钩,不用管它就行,下边开始下载我们 要安装的包吧,为了避免全部下载,这里列出了后面开发NDK用得着的包:autoconf2.1、automake1.10、binutils、gcc- core、gcc- 、g++、gcc4-core、gcc4-g++、gdb、pcre、pcre-devel、gawk、make共12个包
10、 然后开始选择安装这些包吧,点skip,把它变成数字版本格式,要确保Bin项变成叉号,而Src项是源码,这个就没必要选了。
11、 下面测试一下cygwin是不是已经安装好了。
运行cygwin,在弹出的命令行窗口输入:cygcheck -c cygwin命令,会打印出当前cygwin的版本和运行状态,如果status是ok的话,则cygwin运行正常。
然后依次输入gcc –version,g++ --version,make –version,gdb –version进行测试,如果都打印出版本信息和一些描述信息,非常高兴的告诉你,你的cygwin安装完成了!
三:配置NDK环境变量
1、 首先找到cygwin的安装目录,找到一个home\<你的用户名>\.bash_profile文件,我的是:D:\cygwin \home\Administrator\.bash_profile,(注意:我安装的时候我的home文件夹下面神马都没有,解决 的办法:首先打开环境变量,把里面的用户变量中的HOME变量删掉,在E:\cygwin\home文件夹下建立名为Administrator的文件夹 (是用户名),然后把D:\cygwin\etc\skel\.bash_profile拷贝到该文件夹下)。
2、 打开bash_profile文件,添加NDK=/cygdrive/<你的盘符>/<android ndk 目录> 例 如:NDK=/cygdrive/d/android-ndk-r5b
export NDK
NDK这个名字是随便取的,为了方面以后使用方便,选个简短的名字,然后保存
3、打开cygwin,输入cd $NDK,如果输出上面配置的/cygdrive/d/android-ndk-r5b信息,则表明环境变量设置成功了。
四:用NDK来编译程序
1、 现在我们用安装好的NDK来编译一个简单的程序吧,我们选择ndk自带的例子hello-jni,我的位于D:\android-ndk-r5b\samples\hello-jni(根据你具体的安装位置而定),
2、 运行cygwin,输入命令cd /cygdrive/d/android-ndk-r5b/samples/hello-jni,进入到E:\android-ndk-r5b\samples\hello-jni目录。
3、 输入$NDK/ndk-build,执行成功后,它会自动生成一个libs目录,把编译生成的.so文件放在里面。($NDK是调用我们之前配置好的环境变量,ndk-build是调用ndk的编译程序)
4、 此时去hello-jni的libs目录下看有没有生成的.so文件,如果有,你的ndk就运行正常啦!
五:在eclipse中集成c/c++开发环境
1、 装Eclipse的C/C++环境插件:CDT,这里选择在线安装。
首先登录http://www.eclipse.org/cdt/downloads.php,找到对应你Eclipse版本的CDT插件的在线安装地址。
2、 然后点Help菜单,找到Install New Software菜单
3、 点击Add按钮,把取的地址填进去,出来插件列表后,选Select All,然后选择下一步即可完成安装
4、 安装完成后,在eclispe中右击新建一个项目,如果出现了c/c++项目,则表明你的CDT插件安装成功啦!
六:配置C/C++的编译器
1、 打开eclipse,导入ndk自带的hello-jni例子,右键单击项目名称,点击Properties,弹出配置界面,之后再点击 Builders,弹出项目的编译工具列表,之后点击New,新添加一个编译器,点击后出现添加界面,选择Program,点击OK
2、 出现了添加界面,首先给编译配置起个名字,如:C_Builder
设 置Location为<你cygwin安装路径>\bin\bash.exe程序,例如:D:\cygwin\bin\bash.exe,设 置Working Directory为<你cygwin安装路径>\bin目录,例如:D:\cygwin\bin
设置Arguments为
--login -c "cd /cygdrive/d/android-ndk-r5b/samples/hello-jni && $NDK/ndk-build"
上 面的配置中/cygdrive/d/android-ndk-r5b/samples/hello-jni是你当前要编译的程序的目录,$NDK是之前配 置 的ndk的环境变量,这两个根据你具体的安装目录进行配置,其他的不用变,Arguments这串参数实际是给bash.exe命令行程序传参数,进入 要编译的程序目录,然后运行ndk-build编译程序
3、 接着切换到Refresh选项卡,给Refresh resources upon completion打上钩
4、 然后切换到Build Options选项卡,勾选上最后三项
5、 之后点击Specify Resources按钮,选择资源目录,勾选你的项目目录即可
6、 最后点击Finish,点击OK一路把刚才的配置都保存下来,注意:如果你配置的编译器在其它编译器下边,记得一定要点Up按钮,把它排到第一位,否则C代码的编译晚于Java代码的编译,会造成你的C代码要编译两次才能看到最新的修改
7、 这一路下来肯定很累了吧,现在再次恭喜你,编译配置也配置完成啦,现在来测试一下是否可以自动编译呢,打开项目jni目录里的hello-jni.c文件 把提示Hello from JNI!改成其他的文字:如:Hello,My name is alex.,然后再模拟器中运行你的程序,如果模拟器中显示了你最新修改的文字,那么Congratulations!你已经全部配置成功啦!
注:
《1》为什么不能用NDK开发:
1,没有提供系统事件处理支持
2,没有提供程序生命周期的维护
3,没有提供UI方面的API
《2》使用NDK的好处
1,可以将对性能要求比较高的应用逻辑用C开发,从而提高效率
2,可以将需要保密的应用逻辑用C开发,毕竟java包都是能反编译的
《3》NDK适合用于独立的,占用内存少,占用较多cpu资源的处理,例如,信号处理,物理仿真等
《4》
Android.mk 用来指定要编译的源代码
Application.mk 用来指定对应的目标Android应用,这个文件将一个Android SDK应用工程与<ndk>/sources中的共享库关联起来,并且指定了接受共享库的应用工程所在的目录
《5》
共享库应该根据标准的Unix公约来命名,即:lib<sth>.so
《6》
GDB调试本地代码
《7》
NDK开发步骤:
1,运行 build/host-setup.sh 配置你的NDK
2,放置你的代码到目录sources/<mysrc>
3,编写sources/<mysrc>/Android.mk文件描述你的代码给NDK编译系统
4,编写apps/<myapp>/Application.mk文件描述你需要NDK编译系统编译的应用程序和本地代码
5,在NDK顶级目录中运行"make APP=<myapp>"编译你的本地代码(此步骤是在Cygwin中执行)
注:如果编译成功的话,最后一步将拷贝so库到你应用工程根目录下,然后你就可以通过正常手段生成最后的apk文件
《8》
第一次试验,各参数使用相同变量,结果成功,和预期一样,但从中无法分析出它参数之间的关 系。
第二次:失败,从错误提示信息中,得到提示,应该输入Ndk_demo1,从中分析出makeAPP参数 应该是apps目录下的文件夹名称。
第三次:成功,检证了推想。
第四次:上成功的基础上,修改了app_modules参数,结果失败,从参数名观察,APP_MODULES
和LOCAL_MODULE两者应该有关联.
第五次:修改LOCAL_MODULE参数结果成功,检证了推想。
第六次:修改source下的工程文件夹名,不影响结果,说明,source文件夹下的文件夹名不影响编
第七次:为了验证APP_MODULES和LOCAL_MODULE两者是否有关联,再次试验。预期失败
和真实结果一致。
第八次:验证了APP_MODULES和LOCAL_MODULE有关联的猜想。
《9》
1,在make APP的参数是使用apps目录下的文件名做为参数
2,APP_MODULES 和 LOCAL_MODULE 必须相等,最后生成的 so 文件是要根据 APP_MODULES配置生成的,在android.mk文件中主要是配置源文件的路径等相关信息。
以下是关系图
《10》
把so拷到hello-jni工程中hello-jni\project\libs\armeabi文件夹下,修改代码
static {
System.loadLibrary("ndk_demo ");
}
运行代码,成功。(个人觉得此处应该加上单例模式)
观察函数名特点,发现除java外,Java_com_example_hellojni_HelloJni_stringFromJNI中
com_example_hellojni_HelloJni这个字符串就是包名+类名的组合,只是把.改成了_
所以在使用一个so接口时,这点一定要注意。JNI的命名规则:java_包名_类名_方法名
以下是JNI的书写步骤:
1. 编写带有native声明的方法的java类
2. 使用javac命令编译所编写的java类
3. 使用javah?jnijava类名生成扩展名为h的头文件
4. 使用C/C++实现本地方法
5. 将C/C++编写的文件生成动态连接库
从上面流程可以看出,jni是先写java类,然后通过工具生成头文件,所以函数接名要使用上面
的规则。在使用NDK时,如果要写的so是需要提供给其它人使用,在命名时就要考虑这点,
同时,为了方便他人使用,最好提供一下java的函数接口包。