android jni——helloworld

看了网上好多牛人写的学习系列都是用HelloWorld作为开始，我们这里也用HelloWorld来开始我们的学习，首先我们来介绍下JNI吧。

JNI作为java代码和C/C++的桥梁而存在的，为了让java代码更加接近原生代码，大家都知道在linux中，C语言可以直接访问硬件，但是java代码想要直接操作硬件或者说是直接读写寄存器的话不行，所以需要jni来作为桥梁来访问更底层的东西。

JIN使得JAVA代码更加优越，但是用起来也不是那么容易的，特别是在规范方面，作为java虚拟机实现的一部分，jni是java应用程序调用原生代码的途径。下面这种图显示了JNI的角色扮演：

OK，知道了JNI的作用我们就开始我们的例子吧，我这里编译jni是在ubunt下编译的，eclipse是在windows下面的开发环境，在ubuntu下配置ndk开发环境请看我前面一篇文章，这里跳过环境配置，这里我们要实现的功能是：

功能：点击一个按钮，吐出来一个toast，toast中的字符串是在jni中传进来的。

这样就演示了如何在java中去调用jni，我这边的jni是使用c语言编写的，也可以使用C++，稍有一点区别，用C++编写我比较喜欢在android BSP源码中编译。

下面首先是android.mk文件，其实就是linux中的makefile文件而已，这里就是说明了一些编译方法以及生成模块的名字。

 

 LOCAL_PATH := $(call my-dir)

 include $(CLEAR_VARS)

 LOCAL_C_INCLUDE := $(LOCAL_PATH)/include
 LOCAL_LDLIBS += -L$(SYSROOT)/usr/lib -llog

 LOCAL_MODULE := HelloWorld
 LOCAL_SRC_FILES := \
     HelloWorld.c

 include $(BUILD_SHARED_LIBRARY)

Android.mk的编写也是有规范的。

 

 

一个Android.mk file用来向编译系统描述你的源代码。具体来说：该文件是GNU Makefile的一小部分，会被编译系统解析一次或多次。你可以在每一个Android.mk file中定义一个或多个模块，你也可以在几个模块中使用同一个源代码文件。编译系统为你处理许多细节问题。

一个工程中的源文件不计数，其按类型、功能、模块分别放在若干个目录中，makefile定义了一系列的规则来指定，哪些文件需要先编译，哪些文件需要后编译，哪些文件需要重新编译，甚至于进行更复杂的功能操作，因为 makefile就像一个Shell脚本一样，其中也可以执行操作系统的命令。

makefile带来的好处就是——“自动化编译”，一旦写好，只需要一个make命令，整个工程完全自动编译，极大的提高了软件开发的效率。make是一个命令工具，是一个解释makefile中指令的命令工具，一般来说，大多数的IDE都有这个命令，比如：Delphi的make，Visual C++的nmake，Linux下GNU的make。可见，makefile都成为了一种在工程方面的编译方法。

Make工具最主要也是最基本的功能就是通过makefile文件来描述源程序之间的相互关系并自动维护编译工作。而makefile 文件需要按照某种语法进行编写，文件中需要说明如何编译各个源文件并连接生成可执行文件，并要求定义源文件之间的依赖关系。makefile 文件是许多编译器--包括 Windows NT 下的编译器--维护编译信息的常用方法，只是在集成开发环境中，用户通过友好的界面修改 makefile 文件而已。

1、LOCAL_PATH := $(call my-dir) 

一个Android.mk file首先必须定义好LOCAL_PATH变量。它用于在开发树中查找源文件。在这个例子中，宏函数’my-dir’, 由编译系统提供，用于返回当前路径（即包含Android.mk file文件的目录）。

2、include $( CLEAR_VARS)

CLEAR_VARS 由编译系统提供，指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量（例如 LOCAL_MODULE, LOCAL_SRC_FILES,LOCAL_STATIC_LIBRARIES, 等等...),除LOCAL_PATH 。这是必要的，因为所有的编译控制文件都在同一个GNU MAKE执行环境中，所有的变量都是全局的。

3、LOCAL_MODULE :=  HcSyncml

LOCAL_MODULE变量必须定义，以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的，而且不包 含任何空格。注意编译系统会自动产生合适的前缀和后缀，换句话说，一个被命名为'HcSyncml'的共享库模块，将会生成'libHcSyncml.so'文件。

4、LOCAL_C_INCLUDES :=$(LOCAL_PATH)/extra_inc$(LOCAL_PATH)/main_inc

LOCAL_C_INCLUDES 中加入所需要包含的头文件路径

5、LOCAL_SRC_FILES

LOCAL_SRC_FILES中加入源文件路径(需要编译的文件),多个文件用 ‘\’ 隔开

6、LOCAL_LDLIBS+= -L$(SYSROOT)/usr/lib –llog

表示允许打印Log

----------------------------------------------------------------------------------

下面是我们HelloWorld的jni代码：

 

 //
 //Jay-----HelloWorld
 //HelloWorld.c
 #include <string.h>
 #include <jni.h>

 Jstring
 Java_com_android_jni_HelloWorld_getString(JNIEnv *env,jobject jobj)
 {
     return (*env)->NewStringUTF(env,"HelloWorld! From C!");
 }

 

很简单吧，2个头文件，大家一看就知道第二个头文件，jni.h里面肯定定义了jni使用的一些库函数，还有jni的一些模板。

JNI的函数名字也是要注意的一个地方，我们这边是：Java_com_android_jni_HelloWorld_getString

Java+package name+class name+function name组成的

-----------------------------------------------------------------------------------

下面是java代码：

 

 // package name
 package com.android.jni;
 //use inport
 import android.app.Activity;
 import android.content.Context;
 import android.os.Bundle;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.widget.Button;
 import android.widget.Toast;

 public class HelloWorld extends Activity {
     /** Called when the activity is first created. */
     Context mContext = null;
     Button bt = null;
     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         setContentView(R.layout.main);
         mContext = this;
         bt = (Button)findViewById(R.id.button);
         bt.setOnClickListener(new MyButtonListener());
     }
     class MyButtonListener implements OnClickListener{

         public void onClick(View v) {
             if(v.getId() == R.id.button ){
                 //调用原生函数得到字符串sre
                 String str=getString();
                 //吐出message
                 Toast.makeText(mContext, str, Toast.LENGTH_SHORT).show();
             }
         }
     }
     //声明jni原生函数
     public native String getString();
     //载入原生库
     static {
         System.loadLibrary("helloworld");
     }
 }

 

注释在java代码中都有，这边都比较简单，下面我们来运行模拟器。

点击button，会出现HelloWorld！ from C！

大功告成！