Ubuntu上使用android4.0.3模拟器实现JNI例子

上一篇文章写了在Ubuntu环境下搭建NDK R7的过程，这篇文章来实现我的第一个JNI例子，Android sdk的API版本是 4.0.3，NDK的版本是R7的。

一.    创建一个Android项目。

          打开Eclipse后，执行File->New->Project,选择Android->Android Project，然后依照填好项目名字（我的项目名为MyJniTest），包名（比如我的包名为

          com.example.myjnitest）等等信息以完成项目的创建。创建项目这里没有仔细说明，如有不会者，请自行参考其他资料。

二.     编写JAVA部分的代码。

          1）首先编写布局文件main.xml,这里面我定义了两个Button，一个显示文字的TextView         

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

    <Button
        android:id="@+id/btn1"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/Text_from_jni" />

    <Button
        android:id="@+id/btn2"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/Clear_text" />
    <TextView
        android:id="@+id/textdisplay"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="Nothing"
    />

</LinearLayout>

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <Button android:id="@+id/btn1" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/Text_from_jni" /> <Button android:id="@+id/btn2" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/Clear_text" /> <TextView android:id="@+id/textdisplay" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="Nothing" /> </LinearLayout>

         2）编译strings.xml文件，这里我定义了显示在Button上的描述语言。    

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="hello">Hello World, MyJniTestActivity!</string>
    <string name="app_name">MyJniTest</string>
    <string name="Text_from_jni">Text1 from jni</string>
    <string name="Clear_text">Text2 from jni</string>
</resources>

<?xml version="1.0" encoding="utf-8"?> <resources> <string name="hello">Hello World, MyJniTestActivity!</string> <string name="app_name">MyJniTest</string> <string name="Text_from_jni">Text1 from jni</string> <string name="Clear_text">Text2 from jni</string> </resources>

        3）编写MyJniTestActivity.java文件

package com.example.myjnitest;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;

public class MyJniTestActivity extends Activity implements OnClickListener{
    /** Called when the activity is first created. */

    /**
     * 定义了两个native method.
     * 可以看到这两个方法的声明中有native关键字，这个关键字表示这两个方法是本地方法，
     * 也就是说这两个方法是通过本地代码（C/C++）实现的，在java代码中仅仅是声明
     */
    public native String String1FromJni();
    public native String String2FromJni();

    private Button m_btn1;
    private Button m_btn2;
    private TextView m_text;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        m_btn1 =(Button) findViewById(R.id.btn1);
        m_btn2 =(Button) findViewById(R.id.btn2);
        m_text = (TextView) findViewById(R.id.textdisplay);
        //注册BUTTON的监听事件。
        m_btn1.setOnClickListener(this);
        m_btn2.setOnClickListener(this);
    }
    //BUTTON的监听事件监听到点击事件后调用此函数。
    public void onClick(View v)
    {
        switch(v.getId())
        {
        case R.id.btn1:
        {
            //通过JNI会调用到libMyJniTest.so库中对应的该函数处理。
            m_text.setText(String1FromJni());
        }
        break;
        case R.id.btn2:
        {
            m_text.setText(String2FromJni());
        }
        break;
        default:break;

        }
    }
  /**
   * 表明程序开始运行的时候会加载MyJniTest, static区声明的代码会先于onCreate方法执行
   * 如果你的程序中有多个类，而且如果MyJniTestActivity这个类不是你应用程序的入口,
   * 那么 MyJniTest（完整的名字是libMyJniTest.so）这个库会在第一次使用MyJniTestActivity这个类的时候加载。
   */
    static{
        System.loadLibrary("MyJniTest");
    }
}

package com.example.myjnitest; import android.app.Activity; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.TextView; public class MyJniTestActivity extends Activity implements OnClickListener{ /** Called when the activity is first created. */ /** * 定义了两个native method. * 可以看到这两个方法的声明中有native关键字，这个关键字表示这两个方法是本地方法， * 也就是说这两个方法是通过本地代码（C/C++）实现的，在java代码中仅仅是声明 */ public native String String1FromJni(); public native String String2FromJni(); private Button m_btn1; private Button m_btn2; private TextView m_text; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); m_btn1 =(Button) findViewById(R.id.btn1); m_btn2 =(Button) findViewById(R.id.btn2); m_text = (TextView) findViewById(R.id.textdisplay); //注册BUTTON的监听事件。 m_btn1.setOnClickListener(this); m_btn2.setOnClickListener(this); } //BUTTON的监听事件监听到点击事件后调用此函数。 public void onClick(View v) { switch(v.getId()) { case R.id.btn1: { //通过JNI会调用到libMyJniTest.so库中对应的该函数处理。 m_text.setText(String1FromJni()); } break; case R.id.btn2: { m_text.setText(String2FromJni()); } break; default:break; } } /** * 表明程序开始运行的时候会加载MyJniTest, static区声明的代码会先于onCreate方法执行 * 如果你的程序中有多个类，而且如果MyJniTestActivity这个类不是你应用程序的入口, * 那么 MyJniTest（完整的名字是libMyJniTest.so）这个库会在第一次使用MyJniTestActivity这个类的时候加载。 */ static{ System.loadLibrary("MyJniTest"); } }        然后用eclipse编译该工程，生成相应的.class文件，这步必须在下一步之前完成，因为生成.h文件需要用到相应的.class文件。
三.    编写相应的C/C++代码

         刚开始学的时候，有个问题会让人很困惑，相应的C/C++代码如何编写，函数名如何定义？ 这里讲一个方法，利用javah这个工具生成相应的.h文件，然后根据这个.h文件   

         编写相应的C/C++代码。

         1） 生成相应.h文件：
                首先在终端下进入刚刚建立的MyJniTest工程的目录：
                    root@XXX:/home/XXX#cd workspace/MyJniTest/
                    root@XXX:/home/XXX/workspace/MyJniTest# ls
                    AndroidManifest.xml  assets  bin  gen  proguard.cfg  project.properties  res  src
                在工程目录下建立一个jni文件夹：
                    root@XXX:/home/XXX/workspace/MyJniTest# mkdir jni
                    root@XXX:/home/XXX/workspace/MyJniTest# ls
                    AndroidManifest.xml  assets  bin  gen  jni  proguard.cfg  project.properties  res  src
               下面就可以生成相应的.h文件了：
                    -classpath bin：表示类的路径
                    -d jni: 表示生成的头文件存放的目录
                    com.example.hellojni.HelloJni 则是完整类名
                 这一步的成功要建立在已经在 bin/com/example/myjnitest/  目录下生成了 MyJniTestActivity.class的基础之上。

                   root@XXX:/home/XXX/workspace/MyJniTest# javah -classpath bin -d jni com.example.myjnitest.MyJniTestActivity
                   错误：无法访问 com.example.myjnitest.MyJniTestActivity
                   未找到 com.example.myjnitest.MyJniTestActivity 的类文件
                   javadoc: 错误 - 找不到类 com.example.myjnitest.MyJniTestActivity。
                   Error: 未在命令行中指定任何类。请尝试使用 -help。

               后来在网上查了一下，是跟指定目录有关系。后来我看了自己的程序生成MyJniTestActivity.class的路径为bin/classes/com/example/myjnitest/,
               所以重新执行命令：
                   root@XXX:/home/XXX/workspace/MyJniTest# javah -classpath bin/classes -d jni com.example.myjnitest.MyJniTestActivity
                   root@XXX:/home/XXX/workspace/MyJniTest# cd jni/
                   root@XXX:/home/XXX/workspace/MyJniTest/jni# ls
                     com_example_myjnitest_MyJniTestActivity.h
               成功生成了.h文件。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_example_myjnitest_MyJniTestActivity */

#ifndef _Included_com_example_myjnitest_MyJniTestActivity
#define _Included_com_example_myjnitest_MyJniTestActivity
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_example_myjnitest_MyJniTestActivity
 * Method:    String1FromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String1FromJni
  (JNIEnv *, jobject);

/*
 * Class:     com_example_myjnitest_MyJniTestActivity
 * Method:    String2FromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String2FromJni
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

/* DO NOT EDIT THIS FILE - it is machine generated */ #include <jni.h> /* Header for class com_example_myjnitest_MyJniTestActivity */ #ifndef _Included_com_example_myjnitest_MyJniTestActivity #define _Included_com_example_myjnitest_MyJniTestActivity #ifdef __cplusplus extern "C" { #endif /* * Class: com_example_myjnitest_MyJniTestActivity * Method: String1FromJni * Signature: ()Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String1FromJni (JNIEnv *, jobject); /* * Class: com_example_myjnitest_MyJniTestActivity * Method: String2FromJni * Signature: ()Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String2FromJni (JNIEnv *, jobject); #ifdef __cplusplus } #endif #endif

     从上面的源码中可以看出这个函数名那是相当的长啊。。。。 不过还是很有规律的， 完全按照：java_pacakege_class_mathod 形式来命名。如果想知道JNIEXPORT等宏的具体意思，那就需要自己去学习JNI指南了。 

     2） 编写c/c++文件

           首先在Eclipse里面New->File->MyJniTest(选择项目)->jni（选择新建文件存放路径），填写File Name: MyJniTest.c(我的命名)

            编写MyJniTest.c文件：

#include<string.h>
#include<jni.h>


/*
 * Class:     com_example_myjnitest_MyJniTestActivity
 * Method:    String1FromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String1FromJni
  (JNIEnv * env, jobject  thiz)
{

 return (*env)->NewStringUTF(env,"Welcome to study JNI!");
}


/*
 * Class:     com_example_myjnitest_MyJniTestActivity
 * Method:    String2FromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String2FromJni
  (JNIEnv * env, jobject thiz)
{
    return (*env)->NewStringUTF(env,"Hello From JNI!");

}

#include<string.h> #include<jni.h> /* * Class: com_example_myjnitest_MyJniTestActivity * Method: String1FromJni * Signature: ()Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String1FromJni (JNIEnv * env, jobject thiz) { return (*env)->NewStringUTF(env,"Welcome to study JNI!"); } /* * Class: com_example_myjnitest_MyJniTestActivity * Method: String2FromJni * Signature: ()Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_example_myjnitest_MyJniTestActivity_String2FromJni (JNIEnv * env, jobject thiz) { return (*env)->NewStringUTF(env,"Hello From JNI!"); }           Java_com_example_myjnitest_MyJniTestActivity_String1FromJni和Java_com_example_myjnitest_MyJniTestActivity_String2FromJni函数只是简单的返回了

  一个内容分别为 "Welcome to study JNI!"和“Hello From JNI!”的jstring对象（对应于java中的String对象）。

  一个内容分别为 "Welcome to study JNI!"和“Hello From JNI!”的jstring对象（对应于java中的String对象）。

           MyJniTest.c文件已经编写好了，现在可以把com_example_myjnitest_MyJniTestActivity.h文件给删了，当然留着也行，我是没有去删除它。

四.    编译 MyJniTest.c文件生成对应的库。

         1）编写生成库的Android.mk文件。

            首先在Eclipse里面New->File->MyJniTest(选择项目)->jni（选择新建文件存放路径），填写File Name: Android.mk

            编写Android.mk文件：

# Copyright (C) 2009 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE    := MyJniTest
LOCAL_SRC_FILES :=MyJniTest.c

include $(BUILD_SHARED_LIBRARY)

# Copyright (C) 2009 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := MyJniTest LOCAL_SRC_FILES :=MyJniTest.c include $(BUILD_SHARED_LIBRARY)   这段对Android.mk分析的转载于http://407827531.iteye.com/blog/1313926：

LOCAL_PATH := $(call my-dir)

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

include $( CLEAR_VARS)

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

LOCAL_MODULE := hello-jni

编译的目标对象，LOCAL_MODULE变量必须定义，以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的，而且不包含任何空格。

注意：编译系统会自动产生合适的前缀和后缀，换句话说，一个被命名为'hello-jni'的共享库模块，将会生成'libhello-jni.so'文件。

重要注意事项：

如果你把库命名为‘libhello-jni’，编译系统将不会添加任何的lib前缀，也会生成 'libhello-jni.so'，这是为了支持来源于Android平台的源代码的Android.mk文件，如果你确实需要这么做的话。

LOCAL_SRC_FILES := hello-jni.c

LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意，你不用在这里列出头文件和包含文件，因为编译系统将会自动为你找出依赖型的文件；仅仅列出直接传递给编译器的源代码文件就好。

注意，默认的C++源码文件的扩展名是’.cpp’. 指定一个不同的扩展名也是可能的，只要定义LOCAL_DEFAULT_CPP_EXTENSION变量，不要忘记开始的小圆点（也就是’.cxx’,而不是’cxx’）

include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY表示编译生成共享库，是编译系统提供的变量，指向一个GNU Makefile脚本，负责收集自从上次调用'include $(CLEAR_VARS)'以来，定义在LOCAL_XXX变量中的所有信息，并且决定编译什么，如何正确地去做。还有 BUILD_STATIC_LIBRARY变量表示生成静态库：lib$(LOCAL_MODULE).a， BUILD_EXECUTABLE 表示生成可执行文件。

            2）生成.so共享库文件

              Andro文件已经编写好了，现在可以用android NDK开发包中的 ndk-build脚本生成对应的.so共享库了，方法如下：

                       root@XXX:/home/XXX/workspace/MyJniTest# ndk-build
                       Compile thumb  : MyJniTest <= MyJniTest.c
                        SharedLibrary  : libMyJniTest.so
                       Install        : libMyJniTest.so => libs/armeabi/libMyJniTest.so

              可以看到已经正确的生成了libMyJniTest.so共享库了， 我们去 libs/armeabi/ 目录下看看：

                       root@XXX:/home/XXX/workspace/MyJniTest# cd libs/
                       root@XXX:/home/XXX/workspace/MyJniTest/libs# ls
                       armeabi
                       root@XXX:/home/XXX/workspace/MyJniTest/libs# cd armeabi/
                       root@XXX:/home/XXX/workspace/MyJniTest/libs/armeabi# ls
                       libMyJniTest.so

五.    在Eclipse中重新编译MyJniTest工程，生成新的APK。

           eclipse中刷新下MyJniTest工程，重新编译生成apk，libMyJniTest.so共享库会一起打包在apk文件内。

           在模拟器中看看运行结果：

          

           点击Text1 from jni BUTTON后，效果如下：

          

           点击Text2 from jni BUTTON后，效果如下：

           

          好了，大功告成！