Android开发手记一 NDK编程实例

https://dl-ssl.google.com/android/eclipse/

，

然后选择安装

ADT.

上面我们搭建好了

SDK

的环境，可以开发

Java

应用程序了。要开发

C

的程序，还得搭建

NDK

环境。

NDK

给我们提供了以下内容：

libc(Clibrary)headers

libm(mathlibrary)headers

JNIinterfaceheaders

bz(Zlibcompression)headers

blog(Androidlogging)header

AMinimalsetofheadersforC++support

1.2.1NDK

的安装

下载

NDK

安装包，下载地址

http://androidappdocs.appspot.com/sdk/ndk/index.html

，下载后解压即可使用。

1.2.2

若在

Linux

开发环境下那么，这样就可以使用了。若是在

window

环境下，还需要安装

cygwin

。

cygwin

下载地址：

http://www.cygwin.com/

这样，

NDK

的环境也搭建好了。下面我们来进行实战演习。

二

NDK

开发实例

关于

NDK

的使用，首先需要了解一个概念：

JNI

。什么是

JNI

？

2.1Hello-jni

这个是

NDK

自带的例子程序，安装官方网站的说明，一步步来，应该没有什么问题，这里就不细说了。

2.2MyGodIdidit

学习的第一步，就是模仿。我们依照上面

Hello-jni

的例子，在创建自己的

NDK

程序。在此过程中，对相关的内容和概念进行分析和说明。

首先，创建自己的

NDK

工程。我们在

ndk

的

sample

目录下创建自己的工程

myjni

，然后在这个文件夹子下，创建两个目录

jni

和

src

，

jni

用来放我们的

c

文件，

src

是调用的

c

库

java

接口文件。创建好目录，接着创建文件

jni/myjni.c

，该文件比较简单，就是输出一个字符串，内容如下

#include<string.h>

#include<stdio.h>

#include<jni.h>

#include<android/log.h>

#defineLOG_TAG"MYJNI"

#defineLOGI(...)__android_log_print(ANDROID_LOG_DEBUG,LOG_TAG,__VA_ARGS__)

staticchars_string[]="Mygod,Ididit!";

jstring

Java_com_jpf_myjni_MyJNI_stringFromJNI(JNIEnv*env,

jobjectthiz)

{

LOGI("MyJNIiscalled!");

return(*env)->NewStringUTF(env,s_string);

}

这个程序，唯一和

hello-jni

不同的就是引用了

<android/log.h>

这个头文件。在该头文件中，声明了函数

__android_log_print(),

可以根据不同的

log

级别，输出

log

，方便代码的调试。在

NDK

中，

printf()

没法输出，所以我们需要借助

log

库来将我们

c

代码库中需要输出的内容，通过

java

控制台输出。调用函数

__android_log_print(),

就可以在

Eclipse

中，查看

LogCat

来查看相关的输出信息了。

注意：

在

c

文件中，函数名这样定义：

Java_com_jpf_myjni_MyJNI_stringFromJNI

，有什么讲究么？这个是

JNI

的标准，定义需要按照如下格式：

Java_packagename_classname_methodname,

例如：

Java

_com_jpf_myjni_MyJNI_stringFromJNI

接着创建文件

jni/Android.mk.

这个文件是我们本地

c

代码的

Makefile

。文件内容如下：

LOCAL_PATH:=$(callmy-dir)

include$(CLEAR_VARS)

LOCAL_MODULE:=myjni

LOCAL_SRC_FILES:=myjni.c

LOCAL_LDLIBS+=-llog

include$(BUILD_SHARED_LIBRARY)

分别对上述

Makefile

的语句进行说明。

LOCAL_PATH:=$(callmy-dir)

这句用来指定编译的路径。通过调用宏

my-dir

，获取到当前工作的路径。

include$(CLEAR_VARS)CLEAR_VARS

这个变量是编译系统提供的，用来指明一个

GNUmakefile

文件，添加这句，主要的目的是清理所有的

LOCAL_XXX.

，比如

LOCAL_MODULE

，

LOCAL_LDLIBS

。在每个新模块的开始处，需要添加这句。

LOCAL_MODULE:=myjni

这句定义了模块名称，将来编译的库就以此命名。若果编译的是动态库，那么库名就是

libmyjni.so.

需要注意的是，如果你定义

module

为

libmyjni

，那么系统在生成动态库的时候，就不要再为你添加

lib

的前缀了，生成德动态库名字还是

libmyjni.so.

LOCAL_LDLIBS+=-llog

这句指定了需要另外链接的库。我们在代码中，用到了

log

库，所以这里加上这句。

include$(BUILD_SHARED_LIBRARY)

这句说明将来生产的库是共享库，及动态链接库。若需要生产静态库，可以这样写：

include$(BUILD_STATIC_LIBRARY)

。

写完了

c

文件和

Makefile

文件，是否可以编译了呢？我们试一下。在

cygwin

中，进入工程目录，运行

ndk-build

，得到下面的结果：

Administrator@lenovo-0e47e162/android/android-ndk-r4/samples/myndk

$ndk-build

AndroidNDK:Couldnotfindapplication'smanifestfromcurrentdirectory.

AndroidNDK:Pleaseensurethatyouareinsidetheproject'sdirectory!

/android/android-ndk-r4/build/core/build-local.mk:74:***AndroidNDK:Aborting

.Stop.

看到这个错误的意思是，缺少

manifest

文件。老版本的

NDk

，工程中有一个

apps

，里面包含了应用的程序文件和

Application.mk

。现在的版本，不需要我们自己编写

Application.mk,

，不过仍需要工程相关的配置信息。那么如何做到呢？需要手工去写

manifest

文件么？不需要。我们只需要在

Eclipse

中，创建工程就可以了，这些配置文件会自动生成。

前面讲过，在工程的

src

夹子下用来放置

Java

文件。我们打开

Eclipse

，然后新建一个

Android

工程，工程名就叫

MyJNI

，工程路径选择我们创建的

NDK

的路径。这里需要注意的是，工程名，包名等，需要和上面的

c

文件中的保持一致。

(Java

_com_jpf_myjni_MyJNI_stringFromJNI)

工程建立好后，编辑

src/com/jpf/myjni/MyJNI.java

文件，内容如下：

需要说明的几点：

建立好工程，再次编译，在

cygwin

中运行

ndk-build

，结果

OK

。

Administrator@lenovo-0e47e162/android/android-ndk-r4/samples/myndk

$ndk-build

Compilethumb:myjni<=/android/android-ndk-r4/samples/myndk/jni/myjni.c

SharedLibrary:libmyjni.so

Install:libmyjni.so=>/android/android-ndk-r4/samples/myndk/libs/armea

bi

我们看到，需要的共享库已经生成，并且安装好了。下面就可以生成

apk

了。

在

Cygwin

中进行工程的

build

，编译后，在工程的

bin

目录下，会看到我们的

apk

包。

好，我们试试看，能否正常运行。在

Eclipse

选择执行方式为

AndroidApplication

，点击

run

，以下

console

的输出：

[2010-07-0714:26:18-MyJNI]------------------------------

[2010-07-0714:26:18-MyJNI]AndroidLaunch!

[2010-07-0714:26:18-MyJNI]adbisrunningnormally.

[2010-07-0714:26:18-MyJNI]Performingcom.jpf.myjni.MyJNIactivitylaunch

[2010-07-0714:26:18-MyJNI]AutomaticTargetMode:usingexistingemulator'emulator-5554'runningcompatibleAVD'android21'

[2010-07-0714:26:18-MyJNI]WARNING:ApplicationdoesnotspecifyanAPIlevelrequirement!

[2010-07-0714:26:18-MyJNI]DeviceAPIversionis7(Android2.1-update1)

[2010-07-0714:26:18-MyJNI]UploadingMyJNI.apkontodevice'emulator-5554'

[2010-07-0714:26:18-MyJNI]InstallingMyJNI.apk...

[2010-07-0714:26:24-MyJNI]Success!

[2010-07-0714:26:25-MyJNI]Startingactivitycom.jpf.myjni.MyJNIondevice

[2010-07-0714:26:29-MyJNI]ActivityManager:Starting:Intent{act=android.intent.action.MAINcat=[android.intent.category.LAUNCHER]cmp=com.jpf.myjni/.MyJNI}

下图为执行的效果：

2.3StudyHard

有了上面的基础，我们就可以用

NDK

来进行项目开发了。

我们经常会遇到这样的问题，就是将一些现有的，成熟的

C

库移植到

Android

平台上。通过上面我们的介绍，我们已经知道，我们需要用

JNI

来对现有的

C

库包装一下，然后提供

Java

接口，供上层调用。

首先的问题，就是

C

库的编译和测试。其实

Android

底层用的是

Linux

的内核，所以，和其他

Linux

程序开发一样，无法使进行交叉编译。不过，

Android

有些特殊的地方，我们需要注意。下面就以一个很简单的例子，讲讲如何应用

NDK

，做一个

C

的应用终端测试程序。

首先，创建

study-hadr/study-hard.c

文件，程序非常简单，就是

HelloWorld

的

c

程序。

#include<string.h>

#include<stdio.h>

staticchars_string[]="Studyhard!";

intmain()

{

printf("%s/n",s_string);

return0;

}

别看程序很简单，不过这个程序的编译可不简单。

若是在

Linux

下，只需要执行：

gcc–ostudy-hardstudy-hard.c

就可以生成应用程序

study-hard

了。

在

Android

下就不是这么简单了。在

Window

环境开发环境下，用到的交叉工具链，目录是

/android-ndk-r4/build/prebuilt/windows/arm-eabi-4.4.0

。

在这个目录的

bin

路径下，你会看到

arm-eabi

为前缀的诸多工具，这些就是

Android

用的编译工具。那么

c

库和

c

头文件又在哪里呢？对于

Android

，不同的

Platform

，有不同的库和头文件，需要我们自己选择。比如，现在我们要用

Platform5

，那么

C

头文件的路径为：

/android-ndk-r4/build/platforms/android-5/arch-arm/usr/include

C

库的路径为：

/android-ndk-r4/build/platforms/android-5/arch-arm/usr/lib

好了，我们知道了

C

的编译工具链，知道了

C

库路径和

C

头文件路径，应该可以编译了。写个简单的

Makefile

，试一下，结果出错了。

crt0.o

没有找到。