调试JNI的c/c++代码,我一直使用打印log的方式,费时费力。在网上搜索使用GDB调试JNI的文章也不多。后来在stackoverflow偶然看到ndk-gdb才知道自己把NDK的重要文档忽略了。于是赶快试验,没想到确实不难。现把使用方法记录下来。
NDK文档我总结了一下,有几方面需要了解:
● 使用方式
cd $PROJECT
$NDK/ndk-gdb
● 前提条件
- 必须使用 ndk-build 编译native代码;使用 make APP= 是不行的
- AndroidManifest.xml 的 android:debuggable
- 使用Android 2.2+的设备或模拟器
- 使用Eclipse的话,ADT 0.9.7+
- 使用ant的话,Android 2.1 r2+ / 2.2 r1+
● ndk-gdb参数
--verbose 显示详细的会话启动信息。当不能启动GDB时,打开它可以得到更多帮助。
--force 如果存在了一个调试会话,先终止它,然后再启动自己。
--start 启动程序默认的activity,然后连接。默认是寻找系统中已经运行的程序。
--launch= 指定要启动的activity,其它的和上面一样。
--launch-list 打印出可启动的所有activity。
--project= 如果未进入项目目录而运行 ndk-gdb,必须使用该参数指明路径。
--port= 默认使用TCP端口5039和程序通信。指定别的端口可以同时调试多个设备。
--adb= 指明ADB的路径。最好把adb放到PATH环境变量里。
-d, -e, -s 调试设备?模拟器?或者指定号码(adb devices)
--exec=
-x 自定义一个初始化脚本,GDB每次启动都会调用。
● 只有Android 2.3的平台才能调试多线程。低版本的设备只能调试主线程。
下面是我调试JNI的步骤。
整个例子脱胎于NDK自带的hello-jni。
1. 先看java代码:
publicclassHelloAndroidextendsActivity
{
privateButton mButton;
privateTextView mText;
@Override
publicvoidonCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
mText = (TextView) findViewById(R.id.TVHelloAndroid);
mButton = (Button) findViewById(R.id.button1);
mButton.setOnClickListener(newView.OnClickListener()
{
@Override
publicvoidonClick(View v)
{
mText.setText(stringFromJNI());
}
});
}
publicnativeString stringFromJNI();
static{
System.loadLibrary("HelloAndroid-jni");
}
}
2. 再看JNI代码-HelloAndroid-jni.cpp:
#include
#include
#include
#include "util.h" // 引用另外一个自定义模块的函数
extern"C"{
JNIEXPORT jstring JNICALL
Java_com_android_helloandroid_HelloAndroid_stringFromJNI( JNIEnv* env, jobject thiz )
{
inti = GetRandomInt(2, 10);
std::string str(i, 'c');
str.append(", Hello Android from JNI");
returnenv->NewStringUTF(str.c_str());
}
}
3. 上面的JNI代码中使用了另外一个JNI模块定义的函数GetRandomInt,其代码util.c为:
#include
/**
* @return a random integer in [min, max].
*/
intGetRandomInt(intmin,intmax)
{
returnrand() % (max-min + 1) + min;
}
4. 然后,把util.c这个模块编译成libutil.a,使用到的Android.mk和Application.mk文件如下示意:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := util
LOCAL_SRC_FILES := util.c
include $(BUILD_STATIC_LIBRARY)
APP_ABI := armeabi
APP_STL := gnustl_static
5. 然后把HelloAndroid-jni.cpp编译成最后的.so文件:
LOCAL_PATH := $(call my-dir)
TARGET_ARCH_ABI := armeabi
###################
# prebuilt lib
###################
include $(CLEAR_VARS)
LOCAL_MODULE := util-prebuilt
LOCAL_SRC_FILES := ../../archive/util/obj/local/$(TARGET_ARCH_ABI)/libutil.a
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/../../archive/util/jni
include $(PREBUILT_STATIC_LIBRARY)
###################
# final target
###################
include $(CLEAR_VARS)
LOCAL_MODULE := HelloAndroid-jni
LOCAL_SRC_FILES := HelloAndroid-jni.cpp
LOCAL_CFLAGS := -fsigned-char
# prebuilt
LOCAL_STATIC_LIBRARIES := util-prebuilt
LOCAL_LDLIBS := -llog
include $(BUILD_SHARED_LIBRARY)
APP_STL := gnustl_static
6. 接下来就是编译、链接、安装apk文件了。注意,要安装到模拟器里。
7. 打开Cygwin的bash shell窗口,键入下面的命令:
export ANDROID_NDK_ROOT=/cygdrive/y/android_ndk_r5c
8. 最后键入下面的命令:
ndk-gdb --force --start -e
--force 表示关掉正在运行的实例
--start 表示启动新的实例
-e 表示使用模拟器
9. 等待十几秒钟,gdb会装入所有能找到的调试信息,最后出现gdb的提示符。成功!
使用ndk-gdb调试确实很简单。无需-g;自动寻找源文件;速度也可以。不足之处:若想在设备上使用,必须取得root权限才可。
(ba_jie)