调试JNI的c/c++代码,我一直使用打印log的方式,费时费力。在网上搜索使用GDB调试JNI的文章也不多。后来在stackoverflow偶然看到ndk-gdb才知道自己把NDK的重要文档忽略了。于是赶快试验,没想到确实不难。现把使用方法记录下来。
NDK文档我总结了一下,有几方面需要了解:
● 使用方式
cd $PROJECT
$NDK/ndk-gdb
● 前提条件
- 必须使用 ndk-build 编译native代码;使用 make APP=<name> 是不行的
- 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=<name> 指定要启动的activity,其它的和上面一样。
--launch-list 打印出可启动的所有activity。
--project=<path> 如果未进入项目目录而运行 ndk-gdb,必须使用该参数指明路径。
--port=<port> 默认使用TCP端口5039和程序通信。指定别的端口可以同时调试多个设备。
--adb=<file> 指明ADB的路径。最好把adb放到PATH环境变量里。
-d, -e, -s <serial> 调试设备?模拟器?或者指定号码(adb devices)
--exec=<file>
-x <file> 自定义一个初始化脚本,GDB每次启动都会调用。
● 只有Android 2.3的平台才能调试多线程。低版本的设备只能调试主线程。
下面是我调试JNI的步骤。
整个例子脱胎于NDK自带的hello-jni。
1. 先看java代码:
- public class HelloAndroid extends Activity
- {
- private Button mButton;
- private TextView mText;
-
- @Override
- public void onCreate(Bundle savedInstanceState)
- {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
-
- mText = (TextView) findViewById(R.id.TVHelloAndroid);
- mButton = (Button) findViewById(R.id.button1);
-
- mButton.setOnClickListener(new View.OnClickListener()
- {
- @Override
- public void onClick(View v)
- {
- mText.setText(stringFromJNI());
- }
- });
- }
-
- public native String stringFromJNI();
-
- static {
- System.loadLibrary("HelloAndroid-jni");
- }
- }
2. 再看JNI代码-HelloAndroid-jni.cpp:
- #include <string>
- #include <jni.h>
- #include <android/log.h>
- #include "util.h" // 引用另外一个自定义模块的函数
-
- extern "C" {
-
- JNIEXPORT jstring JNICALL
- Java_com_android_helloandroid_HelloAndroid_stringFromJNI( JNIEnv* env, jobject thiz )
- {
- int i = GetRandomInt(2, 10);
- std::string str(i, 'c');
- str.append(", Hello Android from JNI");
- return env->NewStringUTF(str.c_str());
- }
-
- }
3. 上面的JNI代码中使用了另外一个JNI模块定义的函数GetRandomInt,其代码util.c为:
- #include <stdlib.h>
-
-
-
-
- int GetRandomInt(int min, int max)
- {
- return rand() % (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) |