Hello-Jni進階源碼:http://download.csdn.net/detail/zhouyuanjing/4774195
一.下載NDK
http://developer.android.com/sdk/ndk/index.html
目前最新版本是r8(android-ndk-r8-linux-x86.tar.bz2)
二.配置環境
從r7版本開始,Linux下直接解壓就可以使用,在windows下cygwin也已經集成在NDK裏面了,解壓完配置下環境變量就可以使用了。
在~/.bashrc(Linux下配置環境變量的文件)文件末尾加上:
export NDK_HOME=/home/xxx/android_env/android-ndk-r8/ export PATH=$NDK_HOME:$PATH 到這裏 NDK 的環境就已經配置好了,在任意目錄下就給使用 NDK 提供的工具, NDK 提供的主要的工具是 ndk-build,在任意目錄下執行:ndk-build
執行結果:
AndroidNDK: Could not find application project directory !
Android NDK: Please define the NDK_PROJECT_PATH variable topoint to it.
/home/xxx/android_env/android-ndk-r8/build/core/build-local.mk:130:*** Android NDK: Aborting . Stop.
說明配置成功。
三.代碼的編寫
1.首先是寫java代碼
建立一個Android應用工程HelloJni,創建HelloJni.java文件:
HelloJni.java:
代碼:
package com.xxx.hello;
import android.app.Activity;
importandroid.os.Bundle;
importandroid.widget.TextView;
public class HelloJniextendsActivity {
/**Called when the activity is first created. */
@Override
publicvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
TextViewtv =newTextView(this);
tv.setText(stringFromJNI());
setContentView(tv);
}
public native String stringFromJNI();
static{
System.loadLibrary("hello-jni");
}
}
這段代碼很簡單,註釋也很清晰,這裏只提兩點:
a:
static{
System.loadLibrary("hello-jni");
}
表明程序開始運行的時候會加載hello-jni,static區聲明的代碼會先於onCreate方法執行。如果你的程序中有多個類,而且如果HelloJni這個類不是你應用程序的入口,那麼hello-jni(完整的名字是libhello-jni.so)這個庫會在第一次使用HelloJni這個類的時候加載。
b:
publicnative String stringFromJNI();
可以看到這兩個方法的聲明中有native關鍵字,這個關鍵字表示這兩個方法是本地方法,也就是說這兩個方法是通過本地代碼(C/C++)實現的,在java代碼中僅僅是聲明。
用eclipse編譯該工程,生成相應的.class文件,這步必須在下一步之前完成,因爲生成.h文件需要用到相應的.class文件。
2.編寫相應的C/C++代碼
剛開始學的時候,有個問題會讓人很困惑,相應的C/C++代碼如何編寫,函數名如何定義?這裏講一個方法,利用javah這個工具生成相應的.h文件,然後根據這個.h文件編寫相應的C/C++代碼。
2.1生成相應.h文件:
就拿我這的環境來說,首先在終端下進入剛剛建立的HelloJni工程的目錄:
代碼:
xxx@xion-driver:~$cd android_env/eclipse/Workspace/HelloJni/
ls查看工程文件
代碼:
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$ls
AndroidManifest.xml assets bin default.properties gen res src
可以看到目前僅僅有幾個標準的android應用程序的文件(夾)。
首先我們在工程目錄下建立一個jni文件夾:
代碼:
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$mkdir jni
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$ls
AndroidManifest.xml assets bin default.properties gen jni res src
下面就可以生成相應的.h文件了:
代碼:
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$javah -classpath bin/classes -d jni com.xxx.hello.HelloJni
-classpathbin:表示類的路勁
-djni: 表示生成的頭文件存放的目錄
com.xxx.hello.HelloJni則是完整類名
現在可以看到jni目錄下多了個.h文件:
代碼:
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$cd jni/
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni/jni$ls
com_xxx_hello_HelloJni.h
我們來看看com_xxx_hello_HelloJni.h的內容:
com_xxx_hello_HelloJni.h:
代碼:
/* DONOT EDIT THIS FILE - it is machine generated */
#include<jni.h>
/*Header for class com_xxx_hello_HelloJni */
#ifndef_Included_com_xxx_hello_HelloJni
#define_Included_com_xxx_hello_HelloJni
#ifdef__cplusplus
extern"C" {
#endif
/*
*Class: com_xxx_hello_HelloJni
*Method: stringFromJNI
*Signature: ()Ljava/lang/String;
*/
JNIEXPORTjstring JNICALL Java_com_xxx_hello_HelloJni_stringFromJNI
(JNIEnv*, jobject);
#ifdef__cplusplus
}
#endif
#endif
上面代碼中的JNIEXPORT和JNICALL是jni的宏,在android的jni中不需要,當然寫上去也不會有錯。
從上面的源碼中可以看出這個函數名那是相當的長啊。。。。不過還是很有規律的, 完全按照:java_pacakege_class_mathod形式來命名。
也就是說:
Hello.java中stringFromJNI()方法對應於C/C++中的Java_com_xxx_hello_HelloJni_stringFromJNI方法
注意下其中的註釋:
代碼:
Signature:()Ljava/lang/String;
()Ljava/lang/String;
()表示函數的參數爲空(這裏爲空是指除了JNIEnv*, jobject這兩個參數之外沒有其他參數,JNIEnv*,jobject是所有jni函數必有的兩個參數,分別表示jni環境和對應的java類(或對象)本身),
Ljava/lang/String;表示函數的返回值是java的String對象。
2.2編寫相應的.c文件:
hello-jni.c:
代碼:
#include<string.h>
#include<jni.h>
JNIEXPORTjstring JNICALL Java_com_xxx_hello_HelloJni_stringFromJNI(JNIEnv*env, jobject obj)
{
return(*env)->NewStringUTF(env,"Hello from JNI !");
}
Java_com_xxx_hello_HelloJni_stringFromJNI函數只是簡單的返回了一個內容爲"Hellofrom JNI !"的jstring對象(對應於java中的String對象)。
hello-jni.c文件已經編寫好了,現在可以把com_xxx_hello_HelloJni.h文件給刪了,當然留着也行,只是我還是習慣把不需要的文件給清理乾淨了。
3.編譯hello-jni.c生成相應的庫
3.1編寫Android.mk文件
在jni目錄下(即hello-jni.c同級目錄下)新建一個Android.mk文件,Android.mk文件是Android的makefile文件,內容如下:
代碼:
LOCAL_PATH:= $(call my-dir)
include$(CLEAR_VARS)
LOCAL_MODULE := hello-jni
LOCAL_SRC_FILES:= hello-jni.c
include$(BUILD_SHARED_LIBRARY)
LOCAL_PATH:= $(call my-dir)
一個Android.mk文件首先必須定義好LOCAL_PATH變量。它用於在開發樹中查找源文件。在這個例子中,宏函數’my-dir’,由編譯系統提供,用於返回當前路徑(即包含Android.mkfile文件的目錄)。
include$( CLEAR_VARS)
CLEAR_VARS由編譯系統提供,指定讓GNUMAKEFILE爲你清除許多LOCAL_XXX變量(例如LOCAL_MODULE, LOCAL_SRC_FILES,LOCAL_STATIC_LIBRARIES, 等等...),
除LOCAL_PATH。這是必要的,因爲所有的編譯控制文件都在同一個GNUMAKE執行環境中,所有的變量都是全局的。
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表示編譯生成共享庫,是編譯系統提供的變量,指向一個GNUMakefile腳本,負責收集自從上次調用'include$(CLEAR_VARS)'以來,定義在LOCAL_XXX變量中的所有信息,並且決定編譯什麼,如何正確地去做。還有BUILD_STATIC_LIBRARY變量表示生成靜態庫:lib$(LOCAL_MODULE).a,BUILD_EXECUTABLE表示生成可執行文件。
3.2生成.so共享庫文件
代碼:
xxx@xion-driver:~/android_env/eclipse/Workspace/HelloJni$ndk-build
Install : libhello-jni.so => libs/armeabi/libhello-jni.so
可以看到已經正確的生成了libhello-jni.so共享庫了。
4.在eclipse重新編譯HelloJni工程,生成apk
eclipse中刷新下HelloJni工程,重新編譯生成apk,libhello-jni.so共享庫會一起打包在apk文件內。