Linux下Android NDK環境配置以及配合eclipse使用NDK
轉自:http://blog.csdn.net/zhouyuanjing/article/details/7553706 ,感謝作者!
一.下載NDK
二.配置環境
從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工程的目錄:
程式碼:
[email protected]:~$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檔案了:
程式碼:
[email protected]:~/android_env/eclipse/Workspace/HelloJni$javah -classpath bin/classes -d jni com.xxx.hello.HelloJni
-classpathbin:表示類的路勁
-djni: 表示生成的標頭檔案存放的目錄
com.xxx.hello.HelloJni則是完整類名
現在可以看到jni目錄下多了個.h檔案:
程式碼:
[email protected]:~/android_env/eclipse/Workspace/HelloJni$cd jni/
[email protected]:~/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共享庫檔案
程式碼:
[email protected]:~/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檔案內。