Android中的NDK的例子

前幾天研究了JNI技術後，想在Android上試一試研究結果，查閱了很多資料後，總結如下步驟:

首先來看一下什麼是NDK:

     NDK 提供了一系列的工具，幫助開發者快速開發C（或C++）的動態庫，並能自動將so 和java 應用一起打包成apk。這些工具對開發者的幫助是巨大的。
     NDK 集成了交叉編譯器，並提供了相應的mk 文件隔離CPU、平臺、ABI 等差異，開發人員只需要簡單修改mk 文件（指出“哪些文件需要編譯”、“編譯特性要求”等），就可以創建出so。NDK 可以自動地將so 和Java 應用一起打包，極大地減輕了開發人員的打包工作。比較簡單的說，NDK是一套交叉編譯工具，它可以幫你把你用C或C++書寫的代碼，編譯爲.so（類似與 win下的.dll）格式的文件，使你可以在你的Android程序當中用Java語言（JNI）調用這些代碼

下面來看一下具體的操作步驟:

第一步：搭建NDK環境

下載Android NDK。下載地址：http://developer.android.com/tools/sdk/ndk/index.html

下載放到指定的目錄下，解壓即可，這一步很簡單的

第二步：下載安裝cygwin

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

下載地址:http://cygwin.com/install.html
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、 這是選擇要下載的站點,選擇後點下一步.
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文件，我的是：c:\cygwin\home\Administrator\.bash_profile，

2、打開bash_profile文件，添加NDK=/cygdrive/<你的盤符>/<android ndk 目錄> ,就是第一步中下載下來的NDK解壓的目錄我的目錄是:

例如：
NDK=/cygdrive/e/android-ndk-r9c
export NDKRoot
(NDKRoot這個名字是隨便取的，爲了方面以後使用方便，選個簡短的名字，然後保存)

(這裏還要注意的是盤符是"/"而不是"\"，因爲cygwind是Linux，不是windows的)

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

第四步：用NDK來編譯程序，測試功能是否可用

1、現在我們用安裝好的NDK來編譯一個簡單的程序吧，我們選擇ndk自帶的例子hello-jni，我的位於E:\android-ndk-r9c\samples\hello-jni(根據你具體的安裝位置而定).
2、運行cygwin，輸入命令cd /cygdrive/e/android-ndk-r9c/samples/hello-jni，進入到E:\android-ndk-r9c\samples\hello-jni目錄。
3、 輸入$NDK/ndk-build，執行成功後，它會自動生成一個libs目錄，把編譯生成的.so文件放在裏面。($NDK是調用我們之前配置好的環境變量，ndk-build是調用ndk的編譯程序)

(早期NDK版本是make APP=hello-jni ,還要對應app和source2個目錄的項目目錄，現在改成了$NDK/ndk-build）

第五步：開發一個簡單的Android NDK例子：

在Eclipse中新建一個AndroidNDKDemo工程

其中JNI.java是定義的本地方法的類,代碼如下：

[java] view plaincopy

package com.ndk.demo;
public class JNI {
    //獲取字符串
    public native String getString();
    //進行加法操作
    public native int plus(int a,int b);
}

在來看一下AndroidNDKDemoActivity.java，主要是測試的Demo，代碼如下：

[java] view plaincopy

package com.ndk.demo;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

import com.ndk.demo.R;

public class AndroidNDKDemoActivity extends Activity {
    //使用靜態代碼塊加載類庫
    static{
        System.loadLibrary("first_jni");//一定要注意名稱沒有“lib"
    }
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        Button btn1 = (Button)findViewById(R.id.show_btn);
        final EditText oneEdit = (EditText)findViewById(R.id.one_number);
        final EditText twoEdit = (EditText)findViewById(R.id.two_number);
        final Button btn2 = (Button)findViewById(R.id.calculate_btn);
        //定義本地類
        final JNI jni = new JNI();
        btn1.setOnClickListener(new OnClickListener(){
            public void onClick(View v) {
                //顯示從C代碼中返回的字符串
                Toast.makeText(getApplicationContext(), jni.getString(), 1500).show();
            }});
        btn2.setOnClickListener(new OnClickListener(){
            public void onClick(View v) {
                //調用C代碼中的加法操作
                String oneNumber = oneEdit.getText().toString();
                String twoNumber = twoEdit.getText().toString();
                int oneNumbers = Integer.valueOf(oneNumber);
                int twoNumbers = Integer.valueOf(twoNumber);
                btn2.setText(jni.plus(oneNumbers, twoNumbers)+"");
            }});
    }
}

上面的工作搞定後，就生成c代碼的頭文件吧！具體操作，這裏不再贅述，可以訪問我的博客：

http://blog.csdn.net/jiangwei0910410003/article/details/17465085

同時使用VC6.0建一個NDKDemo.c代碼，如下：

[cpp] view plaincopy

#include"jni.h"
/*
 * Class:     com_ndk_demo_JNI
 * Method:    getString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_ndk_demo_JNI_getString(JNIEnv* env, jobject obj)
{
    //返回一個字符串
    return (*env)->NewStringUTF(env,"Hello NDK!");
}

/*
 * Class:     com_ndk_demo_JNI
 * Method:    plus
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_ndk_demo_JNI_plus(JNIEnv* env, jobject obj, jint a, jint b)
{
    //返回計算結果
    return a+b;
}

到這一步，離成功就不遠了，現在需要將NDKDemo.c編譯成.so庫，在目錄中新建一個文件夾(這個目錄是隨便建立的)，這裏我爲了方便就在AndroidNDKDemo工程的bin\classes目錄中新建一個jni文件夾(這裏一定要注意文件夾的名稱一定是"jni"，不然後面的編譯會報錯的)，下面是我的目錄圖：

你同樣可以在D盤下新建一個jni文件夾，或者其他的目錄下都可以的，但是一定要注意文件夾的名稱必須是"jni"

然後將生成的C代碼的頭文件和你剛剛新建的.c文件拷貝到jni文件夾下，(這裏的NDKDemo.cpp不要管了，是C++代碼文件)

下面接着新建一個Android.mk文件，文件內容如下：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE    := first_jni (最終so文件名是libfirst_jni.so）
LOCAL_SRC_FILES := NDKDemo.c (C代碼)
include $(BUILD_SHARED_LIBRARY)

上面的準備工作都做完了，現在就開始編譯吧：

打開cygwin,輸入以下命令:

cd /cygdrive/e/workspace/AndroidNDKDemo/bin/classes   

進入到jni文件夾的根目錄，這個是我的目錄，你們要進入你們剛纔新建的jni文件夾的根目錄即可

然後輸入命令：

$NDK/ndk-build

進行編譯

上面說明編譯成功，這時候到jni的根目錄中可以看到多出兩個文件夾，一個是libs,一個是obj，我們這裏只關心libs中的文件

進 入到lib文件夾下，看到有一個libfirst_jni.so文件，這時候，我們的編譯工作全部搞定了，這時候只需要將libfirst_jni.so 文件拷貝到AndroidNDKDemo工程中的libs文件夾下，如果libs下沒有文件夾armeabi，就新建一個armeabi文件夾，將 libfirst_jni.so文件放到armeabi文件夾中，加載庫的代碼具體可以看上面。

運行結果如下：

可以看到，成功的運行了！

問題

就是我這裏面使用了C代碼測試的，其實我開始的時候是用C++代碼測試的，就是上面的NDKDemo.cpp文件：代碼如下：

[cpp] view plaincopy

#include"jni.h"
/*
 * Class:     com_ndk_demo_JNI
 * Method:    getString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_ndk_demo_JNI_getString(JNIEnv* env, jobject obj)
{
    //返回字符串
    return env->NewStringUTF("Hello NDK!");
}

/*
 * Class:     com_ndk_demo_JNI
 * Method:    plus
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_ndk_demo_JNI_plus(JNIEnv* env, jobject obj, jint a, jint b)
{
    //計算結果
    return a+b;
}

這裏面就是方法:JNICALL Java_com_ndk_demo_JNI_getString不一樣

C代碼中是:

return (*env)->NewStringUTF(env,"Hello NDK!");

C++代碼是:

return env->NewStringUTF("Hello NDK!");