Android NDK開發(三)——常見錯誤集錦以及LOG使用

        轉載請註明出處:http://blog.csdn.net/allen315410/article/details/41826511 

        Android NDK開發經常因某些因素會出現一些意想不到的錯誤,很多時候調試這些錯誤的時候,顯得比調試Java代碼要複雜,一方面是導致錯誤的原因很多很雜,另一方面NDK開發涉及到C/C++代碼的編寫,很多程序員對此不熟悉。那麼這篇博客就總結一下,在NDK開發中經常出現的一些問題,並且嘗試提供一些正確的解決方案,方便在開發時能夠快速定位到錯誤,更改錯誤,當然了,錯誤是多種多樣的,很難把所有的錯誤都總結出來,在這裏僅作爲一個筆記吧,以後在NDK開發中發現一個錯誤或者解決一個錯誤後,我就在這裏記錄一下,日積月累,就不錯了!

常見錯誤及解決方法


1,Android.mk文件不存在



錯誤描述:Android NDK: Your APP_BUILD_SCRIPT points to an unknown file: ./jni/Android.mk  
                   /cygdrive/e/ndk/android-ndk-r10d/build/core/add-application.mk:199: *** Android NDK: Aborting...    。 停止。

解決方法:報這個錯誤就需要查看一下工程目錄下的jni目錄下,是否有Android.mk文件,或者Android.mk文件名是否輸入錯誤了。


2,Android.mk文件配置出錯


錯誤描述:/cygdrive/e/ndk/android-ndk-r10d/build/core/build-shared-library.mk:23: *** Android NDK: Missing LOCAL_MODULE before including                                                                    BUILD_SHARED_LIBRARY in jni/Android.mk    。 停止。

解決方法:檢查Android.mk文件配置信息。Missing LOCAL_MODULE表明LOCAL_MODULE配置出錯,查看並修正。


3,C語言代碼有錯誤


錯誤描述:[armeabi] Compile thumb  : Hello <= Hello.c
                    jni/Hello.c: In function 'Java_com_example_ndk_MainActivity_java_1From_1JNI':
                    jni/Hello.c:17:9: warning: division by zero [-Wdiv-by-zero]
                    int i=5/0;
                              ^
                    [armeabi] SharedLibrary  : libHello.so
                    [armeabi] Install        : libHello.so => libs/armeabi/libHello.so

解決方法:C語言報錯通常錯誤信息很多,我們可以根據cygwin上的LOG定位到錯誤。


4,Java代碼中沒有找到C代碼庫


錯誤描述:AndroidRuntime(1171): java.lang.UnsatisfiedLinkError: Couldn't load Hello1 from loader dalvik.system.PathClassLoader[DexPathList[[zip file "/data/app/com.example.ndk-1.apk"],nativeLibraryDirectories=[/data/app-lib/com.example.ndk-1, /system/lib]]]: findLibrary returned null

解決方法:說明Java代碼在加載C代碼庫的時候弄粗了C代碼庫的名稱,請在java層中改正。


5,C代碼函數簽名錯誤


錯誤描述:java.lang.UnsatisfiedLinkError: Native method not found: com.example.ndk.MainActivity.java_From_JNI:()Ljava/lang/String;

解決方法:Native method not found。這個應該不難吧,一看就知道是C語言中的函數簽名出錯了。


6,ndk版本問題


錯誤描述:Android NDK: WARNING: APP_PLATFORM android-19 is larger than android:minSdkVersion 8 in ./AndroidManifest.xml
                    [armeabi] Compile thumb  : Hello <= Hello.c
                    [armeabi] SharedLibrary  : libHello.so
                    [armeabi] Install        : libHello.so => libs/armeabi/libHello.so

解決方法:這只是一個警告而已,不處理的話程序也照樣運行。導致這個警告的原因是當前ndk的版本>工程中minSdkVersion,想要去掉這個警告就將minSdkVersion支持的最小版本號改成ndk版本號一致,當然了這是愚蠢的做法,但是我們可以使用ndk的低版本編譯,也不太好。下面是個好的解決方法:

1,在工程目錄jni下建立一個新的文件,文件名是 Application.mk

2,在Application.mk文件里加上這樣的一句:

APP_PLATFORM := android-8

3,保存工程,編譯一下,就看見這個警告沒有了。


7,使用javah命令生成函數簽名時,找不到class文件


錯誤描述:錯誤: 無法訪問android.app.Activity
                              找不到android.app.Activity的類文件

解決方法:這個錯誤的具體原因應該沒有找到對應的native方法所在的Java字節碼文件,但是我這裏確實路徑是正確,還是報錯了,很奇怪,不知道是不是Eclipse上的一個BUG。遇到這個問題時,可以這樣解決,既然切換到\bin\classes目錄下不行的話,那就切換到工程目錄\src目錄,再javah一下,這次居然生成了.h的頭文件,不知道爲什麼這樣,反正我測試的時候可行。

tip:獲得本地方法頭文件 
jdk6.0:在Android工程的bin\classes目錄下執行:javah 包名+類名
jdk7.0:在Android工程的src目錄下執行:javah 包名+類名


8,中文亂碼問題

錯誤描述:ndk開發中經常會在C語言代碼中往Java代碼返回一箇中文字符串,偶爾在Java中調用的時候,程序結果會出現中文亂碼情況,或者更有甚者導致程序直接崩潰掉,查看Log日誌也是說明出現亂碼的情況。

解決方法:

         中文亂碼的原因是英文C語言文件保存的格式不是UTF-8的格式,或者整個工程都不是UTF-8的格式,因爲C語言jni傳遞字符串時採用的UTF-8編碼,這一點可以在(*env)->NewStringUTF(env, "hello jni!")看出,NewStringUTF(env,char*)這個方法說明返回的是UTF-8編碼形式的字符串。所以我們在建立工程的時候,或者新建一個C語言代碼文件的時候,需要指定工程編碼爲UTF-8或者C語言代碼文件的保存格式是UTF-8。


9,編碼GBK的不可映射的字符


錯誤描述:編碼GBK的不可映射字符。

解決方法:引起這個錯誤的原因是使用javah時沒有指定java的編碼集,這種情況下編譯器自動根據windows默認的編碼(GBK)編譯,而Java支持UTF-8的編碼集。解決這個問題的方法是在javah命令執行時爲編譯器指定一個編碼集,使用javah命令的參數-encoding 編碼集,如圖



LOG日誌的使用

        上面列舉了一些ndk開發中經常會遇見的問題以及解決方法,但是唯獨沒有列出的,也是最常見的錯誤,就是C語言代碼中出現錯誤,這個不太好解決,而且出現的問題是各種各樣,具體情況具體對待。已知在使用Java開發Android程序時,Google爲了方便程序員調試,在SDK中提供了LOG輸出功能,程序員用來輸出程序中的日誌使用。那麼慶幸的是,Google在NDK中也提供了類似的LOG機制,幫助native層代碼錯誤的定位。下面就嘗試一下使用這個LOG機制。

       在ndk解壓目錄下platforms\android-8\arch-arm\usr\include\android有個log.h的頭文件,這個log.h的頭文件用來管理C語言代碼中的LOG輸出,代碼如下:

#ifndef _ANDROID_LOG_H
#define _ANDROID_LOG_H

#include <stdarg.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Android log priority values, in ascending priority order.
 */
typedef enum android_LogPriority {
    ANDROID_LOG_UNKNOWN = 0,
    ANDROID_LOG_DEFAULT,    /* only for SetMinPriority() */
    ANDROID_LOG_VERBOSE,
    ANDROID_LOG_DEBUG,
    ANDROID_LOG_INFO,
    ANDROID_LOG_WARN,
    ANDROID_LOG_ERROR,
    ANDROID_LOG_FATAL,
    ANDROID_LOG_SILENT,     /* only for SetMinPriority(); must be last */
} android_LogPriority;

/*
 * Send a simple string to the log.
 */
int __android_log_write(int prio, const char *tag, const char *text);

/*
 * Send a formatted string to the log, used like printf(fmt,...)
 */
int __android_log_print(int prio, const char *tag,  const char *fmt, ...)
#if defined(__GNUC__)
    __attribute__ ((format(printf, 3, 4)))
#endif
    ;

/*
 * A variant of __android_log_print() that takes a va_list to list
 * additional parameters.
 */
int __android_log_vprint(int prio, const char *tag,
                         const char *fmt, va_list ap);

/*
 * Log an assertion failure and SIGTRAP the process to have a chance
 * to inspect it, if a debugger is attached. This uses the FATAL priority.
 */
void __android_log_assert(const char *cond, const char *tag,
			  const char *fmt, ...)    
#if defined(__GNUC__)
    __attribute__ ((noreturn))
    __attribute__ ((format(printf, 3, 4)))
#endif
    ;

#ifdef __cplusplus
}
#endif

#endif /* _ANDROID_LOG_H */
         上面的代碼看不懂也沒關係,我們只需要知道怎麼用就行了。

1,在C語言代碼中引用log.h的頭文件,並且預定義LOG_TAG標記Tag名稱,預定義輸出規則:

2,用上面預定義的名稱定義LOG輸出的內容

#include<stdio.h>
#include<jni.h>
#include"com_example_ndk_MainActivity.h"
#include <android/log.h>
#define LOG_TAG "System.out.c"
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)

JNIEXPORT jstring JNICALL Java_com_example_ndk_MainActivity_javaFromJNI(
		JNIEnv* env, jobject obj) {
	return (*env)->NewStringUTF(env, "hello jni!");
}

/*
 * Class:     com_example_ndk_MainActivity
 * Method:    java_From_JNI
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_ndk_MainActivity_java_1From_1JNI(
		JNIEnv* env, jobject obj) {

	LOGI("function called");
	LOGI("array init");
	char c1[3] = { 'a', 'b', 'c' };
	char c2[2] = { 'd', 'e' };
	LOGI("array init finish");
	LOGI("copy array");
	strcat(c1, c2); //把c2的內容放在c1的後面,要求c1長度>c2長度
	LOGI("copy array finish");

	return (*env)->NewStringUTF(env, "hello_jni__");
}
上述的代碼中
#include <android/log.h>
#define LOG_TAG "System.out.c"
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)
是必須添加的,告訴編譯器這裏需要輸出LOG,LOG的TAG標記是“System.out.c”,並且預定義LOGD(...)代表Debug輸出,LOGI(...)代表Info輸出。然後在C語言主題代碼中就可以使用LOGD和LOGI了,傳遞字符串就可以了,需要注意的是傳遞的字符串要用英文字符,不支持中文。

3,在Android.mk文件中配置LOG輸出

    LOCAL_PATH := $(call my-dir)

    include $(CLEAR_VARS)

    LOCAL_MODULE    := Hello

    LOCAL_SRC_FILES := Hello.c
    
    LOCAL_LDLIBS += -llog

    include $(BUILD_SHARED_LIBRARY)
注意:就一句 LOCAL_LDLIBS += -llog 就行了,但是必須得加在 include $(BUILD_SHARED_LIBRARY) 之前。

4,重新編譯代碼,運行看看效果


        好了,我們在Logcat裏面過濾出來System.out.c的TAG,可以看到在輸出copy array之後程序停止了,說明LOGI("copy array");下面的strcat(c1, c2);出現了錯誤,這裏需要修改代碼中的錯誤,程序才能正確執行,是不是很方便啊?試試吧! 


源碼請在這裏下載


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