上一篇文章写了在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后,效果如下:

好了,大功告成!
本文详细介绍了一个完整的JNI示例项目,包括创建Android项目、编写Java部分代码、生成并编写C/C++代码、编译生成.so库及最终打包APK的全过程。
5246

被折叠的 条评论
为什么被折叠?



