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>
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>
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");
}
} 然后用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
从上面的源码中可以看出这个函数名那是相当的长啊。。。。 不过还是很有规律的， 完全按照：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!");
} Java_com_example_myjnitest_MyJniTestActivity_String1FromJni和Java_com_example_myjnitest_MyJniTestActivity_String2FromJni函数只是简单的返回了
一个内容分别为 "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)这段对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共享库文件
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后，效果如下：
好了，大功告成！