Eclipse下NDK開發與調試

Eclipse下NDK開發

一、關於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 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)

(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文件的編寫格式等。

 

Eclipse下NDK調試C++代碼

轉載 http://download.csdn.net/download/bigmaxim/5474055

1. 相關軟件

adt-bundle-windows-x86.zip --- Eclipse集成ADT插件,需要聯網安裝相應的Android SDK

jdk-6u43-windows-i586.exe --- JDK6 Eclipse運行需要JAVA環境,編譯ANDROID應用也需要JAVA編譯器。

android-ndk-r8e-windows-x86.zip --- NDK r8e,支持在ANDROID應用中用C語言進行開發。說明:ndk-build可以不需要cygwin環境。

Cygwin --- 使用ndk-gdb調試C源碼,需要Cygwin環境的支持。

2. WinXP系統環境變量配置

ADB_PATH=D:\GreenProgram\adt-bundle-windows-x86\sdk\platform-tools

classpath=.;%JAVA_HOME%\lib;%JAVA_HOME\lib\tools.jar

CYGWIN_BIN=C:\cygwin\bin

ECLIPSE_PATH=D:\GreenProgram\adt-bundle-windows-x86\eclipse

JAVA_HOME=C:\Program Files\Java\jdk1.6.0_43

NDK_ROOT=D:\GreenProgram\adt-bundle-windows-x86\android-ndk-r8e

Path=%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;%NDK_ROOT%;%ADB_PATH%;%CYGWIN_BIN%;%ECLIPSE_PATH%

3. Cygwin配置

在當前用戶的home目錄下文件.bash_profile末尾添加以下2

NDK_ROOT=/cygdrive/d/GreenProgram/adt-bundle-windows-x86/android-ndk-r8e

export NDK_ROOT

爲方便調試程序,可添加以下一行。當啓動cygwin時,直接進入項目目錄。

cd /cygdrive/f/EclipseWorkspace/01_Capella/05_Test/01_L1Test/EMVTest

4. 應用工程配置

在“window –> preferences ->Android -> NDK”中添加NDK的路徑。


AndroidManifest.xml文件中Debuggable設爲true


NDK編譯設置:ndk-build NDK_DEBUG=1 V=1


在android工程中的項目上點擊右鍵,選擇android tools中的add natie support,這樣會增加c/c++等的編譯鏈接選項。


5. Native方法中C源碼級調試

5.1. 編譯完應用,生成文件


5.2. 右鍵點擊工程 ->Run As->Android Application


下載安裝應用程序到開發板(或模擬器)中,並啓動應用程序。

注意:這裏只是要將生成的應用程序安裝到開發板(或模擬器)

5.3. 啓動Cygwin進入當前工程目錄


執行命令 ndk-gdb --force --verbose –start

在提示符<gdb>下輸入quit退出。

在目錄obj\local\ armeabi下增加了4個文件


5.4. 右鍵點擊工程 ->Debug As->Android Native Application


在需要調試的位置設好斷點,開始C源碼級調試


6.參考資料

http://download.csdn.net/download/bigmaxim/5474055

http://xzhoumin.blog.163.com/blog/static/408811362013230517254/

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