Eclipse下NDK开发与调试

客官°小女子只卖身不卖艺 2022-07-14 11:24 219阅读 0赞

**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][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][http_download.csdn.net_download_bigmaxim_5474055]

**1. 相关软件**

adt-bundle-windows-x86.zip --- Eclipse集成ADT插件，需要联网安装相应的Android SDK。

jdk-6u43-windows-i586.exe --- JDK6Eclipse运行需要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的路径。

![Center][]

AndroidManifest.xml文件中Debuggable设为true。

![Center 1][]

NDK编译设置：ndk-build NDK\_DEBUG=1 V=1。

![Center 2][]

在android工程中的项目上点击右键，选择android tools中的add natie support，这样会增加c/c++等的编译链接选项。

![Center 3][]

**5. Native方法中C源码级调试**

**5.1. 编译完应用，生成文件。**

![Center 4][]

**5.2. 右键点击工程 \->Run As->Android Application。**

![Center 5][]

下载安装应用程序到开发板（或模拟器）中，并启动应用程序。

注意：这里只是要将生成的应用程序安装到开发板（或模拟器）

**5.3. 启动Cygwin进入当前工程目录。**

![Center 6][]

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

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

在目录obj\\local\\ armeabi下增加了4个文件。

![Center 7][]

**5.4. 右键点击工程 \->Debug As->Android Native Application。**

![Center 8][]

在需要调试的位置设好断点，开始C源码级调试。

![Center 9][]

**6.参考资料**

[http://download.csdn][http_download.csdn.net_download_bigmaxim_5474055][.NET][]/download/bigmaxim/5474055

[http://xzhoumin.blog.163.com/blog/static/408811362013230517254/][http_xzhoumin.blog.163.com_blog_static_408811362013230517254]

[Java]: http://lib.csdn.net/base/javase
[Android]: http://lib.csdn.net/base/android
[Linux]: http://lib.csdn.net/base/linux
[http_developer.android.com_sdk_ndk_index.html]: http://developer.android.com/sdk/ndk/index.html
[http_download.csdn.net_download_bigmaxim_5474055]: http://download.csdn.net/download/bigmaxim/5474055
[Center]: /images/20220714/0e4cdf6ed88b43e98a687aa4f5358c64.png
[Center 1]: /images/20220714/45a8ee047d544c2b9c0ead85946093b0.png
[Center 2]: /images/20220714/aaad9b4e6775435789620a800356a54e.png
[Center 3]: /images/20220714/d9d189dfbddf4e4e81e47651cef4d5fe.png
[Center 4]: /images/20220714/c822ecffae1c44d98210c9362ad55634.png
[Center 5]: /images/20220714/677461d54be542eb937ddab7c17cd140.png
[Center 6]: /images/20220714/5fe5410ac0a24d9f8bbcf18cc807a86c.png
[Center 7]: /images/20220714/8feaeee98bb24b0db201dfc1351e56bf.png
[Center 8]: /images/20220714/d4b333e7e0c84a5aa3540f500f4cfa3b.png
[Center 9]: /images/20220714/e0c00a6d1d4f4ed886a7b67d2a770852.png
[.NET]: http://lib.csdn.net/base/dotnet
[http_xzhoumin.blog.163.com_blog_static_408811362013230517254]: http://xzhoumin.blog.163.com/blog/static/408811362013230517254/