Linux下Android NDK環境配置以及配合eclipse使用NDK

Hello-Jni進階源碼http://download.csdn.net/detail/zhouyuanjing/4774195

.下載NDK

http://developer.android.com/sdk/ndk/index.html

目前最新版本是r8android-ndk-r8-linux-x86.tar.bz2 

.配置環境

r7版本開始,Linux下直接解壓就可以使用,在windowscygwin也已經集成在NDK裏面了,解壓完配置下環境變量就可以使用了。

~/.bashrcLinux下配置環境變量的文件)文件末尾加上:

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

上面代碼中的JNIEXPORTJNICALLjni的宏,在androidjni中不需要,當然寫上去也不會有錯。

從上面的源碼中可以看出這個函數名那是相當的長啊。。。。不過還是很有規律的, 完全按照:java_pacakege_class_mathod形式來命名。

也就是說:

Hello.javastringFromJNI()方法對應於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;表示函數的返回值是javaString對象。

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文件是Androidmakefile文件,內容如下:

代碼:

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變量必須包含將要編譯打包進模塊中的CC++源代碼文件。注意,你不用在這裏列出頭文件和包含文件,因爲編譯系統將會自動爲你找出依賴型的文件;僅僅列出直接傳遞給編譯器的源代碼文件就好。

注意,默認的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).aBUILD_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工程,重新編譯生成apklibhello-jni.so共享庫會一起打包在apk文件內。



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章