Eclipse NDK 配置

CDT安裝說明連接地址:http://blog.csdn.net/alvin969/article/details/3466867

NDK直接編譯:http://blog.csdn.net/wchinaw/article/details/7378730

一、關於NDK:
NDK全稱:Native Development Kit。 
1、NDK是一系列工具的集合。 
NDK提供了一系列的工具,幫助開發者快速開發C(或C++)的動態庫,並能自動將so和java應用一起打包成apk。這些工具對開發者的幫助是巨大的。 
NDK集成了交叉編譯器,並提供了相應的mk文件隔離CPU、平臺、ABI等差異,開發人員只需要簡單修改mk文件(指出“哪些文件需要編譯”、“編譯特性要求”等),就可以創建出so。
NDK可以自動地將so和Java應用一起打包,極大地減輕了開發人員的打包工作。 
2、NDK提供了一份穩定、功能有限的API頭文件聲明。 
Google明確聲明該API是穩定的,在後續所有版本中都穩定支持當前發佈的API。從該版本的NDK中看出,這些API支持的功能非常有限,包含有:C標準庫(libc)、標準數學庫(libm)、壓縮庫(libz)、Log庫(liblog)。

二、NDK實例的實現:
對於Windows環境下NDK的開發,如果使用的NDK是r7之前的版本,必須要安裝Cygwin才能使用NDK,所以爲Eclipse需要配置的builder,其實是執行Cygwin,然後傳遞ndk-build作爲參數。在NDKr7開始,Google的Windows版的NDK提供了一個ndk-build.cmd的腳本,這樣,就可以直接利用這個腳本編譯,而不需要使用Cygwin了。只需要爲Eclipse Android工程添加一個Builders,就能讓Eclipse自動編譯NDK。

本文是講述NDK-r7下的實現實例。
下面是使用NDK-r7在windows下配置自動編譯的builders的過程(實際上對於Linux,只需要修改ndk-build.cmd爲ndk-build就可以了。)。

第一種方式:
(1)先下載安裝NDK-r7。
下載地址:http://developer.android.com/sdk/ndk/index.html
下載後解壓縮就可以用了。
(2)打開Eclipse,新建一個Android工程(我的取名爲TestNdk),在工程目錄TestNdk下新建jni文件夾,該文件夾就用來保存NDK需要編譯的文件代碼等。
(3)新建並配置一個Builder:
  (a)Project->Properties->Builders->New,新建一個Builder。 
  (b)在彈出的【Choose configuration type】對話框,選擇【Program】,點擊【OK】: 
  (c)在彈出的【Edit Configuration】對話框中,配置選項卡【Main】。
       在“Name“中輸入新builders的名稱(我取名爲Ndk_Builder)。
       在“Location”中輸入nkd-build.cmd的路徑。
      (我的是D:\AndroidDev\android-ndk-r7\ndk-build.cmd,根據各自的ndk路徑設置,也可以點擊“Browser File System…”來選取這個路徑)。
       在“Working Diretcoty”中輸入${workspace_loc:/TestNdk}(也可以點擊“Browse Workspace”來選取TestNdk目錄)。
 
  (d)【Edit Configuration】對話框中,配置選項卡【Refresh】。
      勾選“Refresh resources upon completion”,
      勾選“The entire workspace”,
      勾選“Recuresively include sub-folders”。
 
  (e)【Edit Configuration】對話框中,配置選項卡【Build options】。
      勾選“After a “Clean””,
      勾選“During manual builds”,
      勾選“During auto builds”,
      勾選“Specify working set of relevant resources”。
 
      點擊“Specify Resources…”
      勾選TestNdk工程的“jni“目錄,點擊”finish“。 
點擊“OK“,完成配置。
OK,到這裏Eclipse就能夠自動調用NDK編譯jin目錄下的C/C++代碼了。
(4)在TestNdk工程中新建一個JniClient.class(爲了調用C/C++代碼),其內容如下:
package com.ndk.test;

public class JniClient {

    static public native String AddStr(String strA, String strB);
    static public native int AddInt(int a, int b);
}
(5)用cmd命令定位到JniClient.class 所在目錄,輸入“javac JniClient.java“後回車,生成JniClinet.class文件(如果是用的Eclipse建的工程,在TestNdk\bin\classes\com\ndk\test目錄下就已經有JniClinet.class文件了)。
(6)將JniClinet.class拷貝到TestNdk\bin\classes\com\ndk\test目錄,將cmd命令定位到TestNdk\bin\classes目錄,輸入”javah -jni com.ndk.test.JniClient“(切記  是包全名 )後回車,在TestNdk\bin\classes目錄下就生成了C++頭文件com_ndk_test_JniClient.h。com_ndk_test_JniClient.h的文件內容如下:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_ndk_test_JniClient */

#ifndef _Included_com_ndk_test_JniClient
#define _Included_com_ndk_test_JniClient
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_ndk_test_JniClient
 * Method:    AddStr
 * Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr
  (JNIEnv *, jclass, jstring, jstring);

/*
 * Class:     com_ndk_test_JniClient
 * Method:    AddInt
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt
  (JNIEnv *, jclass, jint, jint);

#ifdef __cplusplus
}
#endif
#endif

(7)在jni目錄下新建一個Android.mk文件,其內容如下:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := TestNdk
LOCAL_SRC_FILES := com_ndk_test_JniClient.c
include $(BUILD_SHARED_LIBRARY)

這個Androd.mk文件很短,下面我們來逐行解釋下:

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 表示生成可執行文件。


(8)將com_ndk_test_JniClient.h拷貝到TestNdk工程的jni目錄下, 然後新建一個com_ndk_test_JniClient.c文件完成頭文件中函數的實現,其內容如下(本來Java_com_ndk_test_JniClient_AddStr是想完成字符串相加的功能的,但數據轉換有點問題,想先寫完本文檔,後續再研究jni數據類型的問題,所以只簡單的返回一個字符串。):
#include "com_ndk_test_JniClient.h"
#include <stdlib.h>
#include <stdio.h>

#ifdef __cplusplus   
extern "C"  
{   
#endif  
/*
 * Class:     com_ndk_test_JniClient
 * Method:    AddStr
 * Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr
  (JNIEnv *env, jclass arg, jstring instringA, jstring instringB)
{
    jstring str = (*env)->NewStringUTF(env, "HelloWorld from JNI !");
    return str;       
}

/*
* Class:     com_ndk_test_JniClient
* Method:    AddInt
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt
  (JNIEnv *env, jclass arg, jint a, jint b)
{
    return a + b;
}

#ifdef __cplusplus   
}   
#endif

編輯com_ndk_test_JniClient.c並保存後,可以看到TestNkd工程下的obj/local/armeabi目錄下將自動生成libTestNdk.so庫。

(9)在TestNdkActivity.java中完成對JniClient.java中函數的調用:
package com.ndk.test;

import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;

public class TestNdkActivity extends Activity {
    static {
        System.loadLibrary("TestNdk");
    }

    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
//        setContentView(R.layout.main);
        
        String str = JniClient.AddStr("prefix", "suffix");
        
        
        int iSum = JniClient.AddInt(5, 2);        
        String strSum = "5 + 7 = " + iSum;
        
        TextView tv1 = new TextView(this);
        tv1.setText(str);
        setContentView(tv1);
    }
}
(10)運行TestNdk工程,在模擬器中可以看到界面輸出來自com_ndk_test_JniClient.c 文件中的“HelloWorld from JNI ! “。

OK,NDK實例到此完成。後續就可以深入的學習NDK/JNI了,比如C/C++與Java的數據類型轉換,Android.mk文件的編寫格式等。


第二種方式:

下載安裝cygwin

     由於NDK編譯代碼時必須要用到make和gcc,所以你必須先搭建一個linux環境, cygwin是一個在windows平臺上運行的unix模擬環境,它對於學習unix/linux操作環境,或者從unix到windows的應用程序移植,非常有用。通過它,你就可以在不安裝linux的情況下使用NDK來編譯C、C++代碼了。下面我們一步一步的安裝cygwin吧。

 (安裝的時候忘記截圖了)

首先,你得先跑到http://www.cygwin.com下載setup.exe

1、 然後雙擊運行吧,運行後你將看到安裝嚮導界面:

2、 點擊下一步

    此時讓你選擇安裝方式:

          1)Install from Internet:直接從Internet上下載並立即安裝(安裝完成後,下載好的安裝文件並不會被                  刪除,而是仍然被保留,以便下次再安裝)。

          2)Download Without Installing:只是將安裝文件下載到本地,但暫時不安裝。

          3)Install from Local Directory:不下載安裝文件,直接從本地某個含有安裝文件的目錄進行安裝。

3、選擇第一項,然後點擊下一步:

4、選擇要安裝的目錄,注意,最好不要放到有中文和空格的目錄裏,似乎會造成安裝出問題,其它選項不用變,                 之後點下一步:

5、上一步是選擇安裝cygwin的目錄,這個是選擇你下載的安裝包所在的目錄,默認是你運行setup.exe的目                     錄,直接點下一步就可以:

6、此時你共有三種連接方式選擇:

    1) Direct Connection:直接連接。

    2) Use IE5 Settings:使用IE的連接參數設置進行連接。

     3) Use HTTP/FTP Proxy:使用HTTP或FTP代理服務器進行連接(需要輸入服務器地址、端口號)。

         用戶可根據自己的網絡連接的實情情況進行選擇,一般正常情況下,均選擇第一種,也就是直接連接方式。然後               再點擊“下一步”,

7、 這是選擇要下載的站點,我用的是http://mirrors.kernel.org,速度感覺還挺快,選擇後點下一步

8、 此時會下載加載安裝包列表

9、Search是可以輸入你要下載的包的名稱,能夠快速篩選出你要下載的包。那四個單選按鈕是選擇下邊樹的樣式,默認就行,不用動。View默認是Category,建議改成full顯示全部包再查,省的一些包被隱藏掉。左下角那個複選框是是否隱藏過期包,默認打鉤,不用管它就行,下邊開始下載我們要安裝的包吧,爲了避免全部下載,這裏列出了後面開發NDK用得着的包:autoconf2.1、automake1.10、binutils、gcc-core、gcc- g++、gcc4-core、gcc4-g++、gdb、pcre、pcre-devel、gawk、make共12個包

10、 然後開始選擇安裝這些包吧,點skip,把它變成數字版本格式,要確保Bin項變成叉號,而Src項是源碼,這個就沒必要選了。

11、 下面測試一下cygwin是不是已經安裝好了。

     運行cygwin,在彈出的命令行窗口輸入:cygcheck -c cygwin命令,會打印出當前cygwin的版本和運行狀       態,如果status是ok的話,則cygwin運行正常。

     然後依次輸入gcc –version,g++ --version,make –version,gdb –version進行測試,如果都打印出版本信息和一些描述信息,非常高興的告訴你,你的cygwin安裝完成了!

配置NDK環境變量

1、  首先找到cygwin的安裝目錄,找到一個home\<你的用戶名>\.bash_profile文件,我的是:E:\cygwin\home\Administrator\.bash_profile,(注意:我安裝的時候我的home文件夾下面神馬都沒有,解決 的辦法:首先打開環境變量,把裏面的用戶變量中的HOME變量刪掉,在E:\cygwin\home文件夾下建立名爲Administrator的文件夾(是用戶名),然後把E:\cygwin\etc\skel\.bash_profile拷貝到該文件夾下)。

2、  打開bash_profile文件,添加NDK=/cygdrive/<你的盤符>/<android ndk 目錄>例如:NDK=/cygdrive/e/android-ndk-r5

export NDK

NDK這個名字是隨便取的,爲了方面以後使用方便,選個簡短的名字,然後保存

3、打開cygwin,輸入cd $NDK,如果輸出上面配置的/cygdrive/e/android-ndk-r5信息,則表明環境變量設置成功了。

用NDK來編譯程序  

1、  現在我們用安裝好的NDK來編譯一個簡單的程序吧,我們選擇ndk自帶的例子hello-jni,我的位於E:\android-ndk-r5\samples\hello-jni(根據你具體的安裝位置而定),

2、 運行cygwin,輸入命令cd /cygdrive/e/android-ndk-r5/samples/hello-jni,進入到E:\android-ndk-r5\samples\hello-jni目錄。

3、 輸入$NDK/ndk-build,執行成功後,它會自動生成一個libs目錄,把編譯生成的.so文件放在裏面。($NDK是調用我們之前配置好的環境變量,ndk-build是調用ndk的編譯程序)

4、  此時去hello-jni的libs目錄下看有沒有生成的.so文件,如果有,你的ndk就運行正常啦!

在eclipse中集成c/c++開發環境

   1、 裝Eclipse的C/C++環境插件:CDT,這裏選擇在線安裝。

         首先登錄http://www.eclipse.org/cdt/downloads.php,找到對應你Eclipse版本的CDT插件的在線安裝地址。

  2、  然後點Help菜單,找到Install New Software菜單

  3、  點擊Add按鈕,把取的地址填進去,出來插件列表後,選Select All,然後選擇下一步即可完成安裝

  4、  安裝完成後,在eclispe中右擊新建一個項目,如果出現了c/c++項目,則表明你的CDT插件安裝成功啦!

配置C/C++的編譯器

  1、  打開eclipse,導入ndk自帶的hello-jni例子,右鍵單擊項目名稱,點擊Properties,彈出配置界面,之後再點擊Builders,彈出項目的編譯工具列表,之後點擊New,新添加一個編譯器,點擊後出現添加界面,選擇Program,點  擊OK

  2、出現了添加界面,首先給編譯配置起個名字,如:C_Builder

  設置Location爲<你cygwin安裝路徑>\bin\bash.exe程序,例如:E:\cygwin\bin\bash.exe,設置WorkingDirectory爲<你cygwin安裝路徑>\bin目錄,例如:E:\cygwin\bin

  設置Arguments爲

  --login -c "cd /cygdrive/I/JavaWorkSpace/Blog/NDK_02&& $NDK/ndk-build"

上面的配置中 /cygdrive/I/JavaWorkSpace/Blog/NDK_02是你當前要編譯的程序的目錄,$NDK是之前配置  的ndk的環境變量,這兩個根據你具體的安裝目錄進行配置,其他的不用變,Arguments這串參數實際是  給bash.exe命令行程序傳參數,進入要編譯的程序目錄,然後運行ndk-build編譯程序

3、接着切換到Refresh選項卡,給Refresh resources upon completion打上鉤

4、然後切換到Build Options選項卡,勾選上最後三項

5、之後點擊Specify Resources按鈕,選擇資源目錄,勾選你的項目目錄即可

 6、  最後點擊Finish,點擊OK一路把剛纔的配置都保存下來,注意:如果你配置的編譯器在其它編譯器下邊,記得一定要點Up按鈕,把它排到第一位,否則C代碼的編譯晚於Java代碼的編譯,會造成你的C代碼要編譯兩次才能看到最新的修改

 7、  這一路下來肯定很累了吧,現在再次恭喜你,編譯配置也配置完成啦,現在來測試一下是否可以自動編譯呢,打開項目jni目錄裏的hello-jni.c文件把提示Hello from JNI!改成其他的文字:如:Hello,My name is alex.,然後再模擬器中運行你的程序,如果模擬器中顯示了你最新修改的文字,那麼Congratulations!你已經全部配置成功啦!



 最新版本NDK編譯已經無須cygwin支持,它可以通過命令行直接進行編譯,從編譯log來看,似乎是應用了mingw

log: This program built for i586-pc-mingw32

 

1.下載NDK http://developer.android.com/sdk/ndk/index.html

2.解壓,使用 ndk-build.cmd命令即可進行編譯,最簡單的編譯命令: ndk-build.cmd -C $project_path   後面是你工程路徑

3.在eclipse中配置,並在文件有更改時自動編譯

  (1)在工程上右鍵並選中Properties -> Builders->New ->Program->配置Name -> Location (配置成你ndk-build.cmd在本地的路徑)->Working Directory (NDK路徑)->Arguments(配置-C ${build_project}) ${build_project}等同於你當前項目的路徑.

按下圖配置

 

點擊Specifiy Resources進行配置:

 

 

 

點擊Specifiy Resources進行配置:

 

 

 

當修改了工程中JNI目錄下的文件之後,保存,它便會自動編譯:

 

make: Entering directory `E:/work/source/Workspace_JNI/firstJNI'
"Compile thumb : firstjni <= firstjni.c

SharedLibrary  : libfirstjni.so

Install        : libfirstjni.so => libs/armeabi/libfirstjni.so

make: Leaving directory `E:/work/source/Workspace_JNI/firstJNI'

 

OK.編譯成功。並生成APK...


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