控制Log

像Java一样，本地的loggingAPIs仅仅让你发出log消息到logger内核模块
。在实际中，你可能既不使用断言也不使用日志在同样在你发布和debug建立
时。不幸的是，这个Android日志API并不提供任何压缩日志消息的能力
基于他们的优先级。它并不和Log4J或者Log4CXX一样先进的。这个Andoid
的日志框架假定你能够去除你不需要的日志信息。尽管这能很容易的被做
在Java应用程序中依赖Proguard，但是在本地代码中是不容易的。
   日志的封装：
  这部分将介绍一个基于这个问题的解决方案的一个预处理器。为了看到
效果，需要修改这个hello-jni本地项目。jni-》右键-》new file-》
my_log.h.
#pragma once
/**
* Basic logging framework for NDK.
*
* @author Onur Cinar
*/
#include <android/log.h>
#define MY_LOG_LEVEL_VERBOSE 1
#define MY_LOG_LEVEL_DEBUG 2
#define MY_LOG_LEVEL_INFO 3
#define MY_LOG_LEVEL_WARNING 4
#define MY_LOG_LEVEL_ERROR 5
#define MY_LOG_LEVEL_FATAL 6
#define MY_LOG_LEVEL_SILENT 7
#ifndef MY_LOG_TAG
# define MY_LOG_TAG __FILE__
#endif
#ifndef MY_LOG_LEVEL
# define MY_LOG_LEVEL MY_LOG_LEVEL_VERBOSE
#endif
#define MY_LOG_NOOP (void) 0
#define MY_LOG_PRINT(level,fmt,...) \
__android_log_print(level, MY_LOG_TAG, "(%s:%u) %s: " fmt, \
__FILE__, __LINE__, __PRETTY_FUNCTION__, ##__VA_ARGS__)
#if MY_LOG_LEVEL_VERBOSE >= MY_LOG_LEVEL
# define MY_LOG_VERBOSE(fmt,...) \
MY_LOG_PRINT(ANDROID_LOG_VERBOSE, fmt, ##__VA_ARGS__)
#else
# define MY_LOG_VERBOSE(...) MY_LOG_NOOP
#endif
#if MY_LOG_LEVEL_DEBUG >= MY_LOG_LEVEL
# define MY_LOG_DEBUG(fmt,...) \
MY_LOG_PRINT(ANDROID_LOG_DEBUG, fmt, ##__VA_ARGS__)
#else
# define MY_LOG_DEBUG(...) MY_LOG_NOOP
#endif
#if MY_LOG_LEVEL_INFO >= MY_LOG_LEVEL
# define MY_LOG_INFO(fmt,...) \
MY_LOG_PRINT(ANDROID_LOG_INFO, fmt, ##__VA_ARGS__)
#else
# define MY_LOG_INFO(...) MY_LOG_NOOP
#endif
#if MY_LOG_LEVEL_WARNING >= MY_LOG_LEVEL
# define MY_LOG_WARNING(fmt,...) \
MY_LOG_PRINT(ANDROID_LOG_WARN, fmt, ##__VA_ARGS__)
MY_LOG_PRINT(ANDROID_LOG_ERROR, fmt, ##__VA_ARGS__)
# define MY_LOG_FATAL(fmt,...) \
MY_LOG_PRINT(ANDROID_LOG_FATAL, fmt, ##__VA_ARGS__)
#else
# define MY_LOG_FATAL(...) MY_LOG_NOOP
#endif
#if MY_LOG_LEVEL_FATAL >= MY_LOG_LEVEL
# define MY_LOG_ASSERT(expression, fmt, ...) \
if (!(expression)) \
{ \
__android_log_assert(#expression, MY_LOG_TAG, \
fmt, ##__VA_ARGS__); \
}
#else
# define MY_LOG_ASSERT(...) MY_LOG_NOOP
#endif
通过这一套预处理命令，这个my_log.h头文件定义了一个基本的logging
框架对于本地代码。这些预处理命令封装了android日志函数和运行他们
在编译时被调试。
增加日志：
   你能够增加日志语句在本地代码。使用Project Explorer，在hello-jni.c
点击右键，编辑。为了使用基本的日志框架，这个my_log.h头文件需要被包含。
不在需要包含android/log.h,因为已经通过my_log.h被包含。
   #include"my_log.h"
   你能增加这日志语句到本地函数，如下：
   jstring
Java_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv* env,
jobject thiz )
{
MY_LOG_VERBOSE("The stringFromJNI is called.");
MY_LOG_DEBUG("env=%p thiz=%p", env, thiz);
MY_LOG_ASSERT(0 != env, "JNIEnv cannot be NULL.");
MY_LOG_INFO("Returning a new string.");
return (*env)->NewStringUTF(env, "Hello from JNI !");
}
更新Android.mk
你可以更新这个Android.mk文件来调节这个基本日志框架。编辑Android.mk
日志标签：
  上面提到，每个日志消息包含了一个日志标签来识别这组件，发出日志
消息。这个对于模块的日志标签被定义在Android.mk文件，如下：
  LOCAL_MODULE := hello-jni
  ...
  # Define the log tag
  MY_LOG_TAG := \"hello-jni\"
日志水平：
    基本的日志框架的主要优势是能够定义一个日志水平.
这Android.mk文件被修改来定义不同的日志水平来调试和发布建立，如下：
     LOCAL_MODULE := hello-jni
...
# Define the log tag
MY_LOG_TAG := \"hello-jni\"
MY_LOG_LEVEL := MY_LOG_LEVEL_ERROR
MY_LOG_LEVEL := MY_LOG_LEVEL_VERBOSE
应用这日志配置：
基于定义的MY_LOG_TAG和MY_LOG_LEVEL建立系统变量，这日志
系统配置被应用在这模块，如下：
  LOCAL_MODULE := hello-jni
...
# Define the log tag
MY_LOG_TAG := hello-jni
# Define the default logging level based build type
ifeq ($(APP_OPTIM),release)
MY_LOG_LEVEL := MY_LOG_LEVEL_ERROR
else
MY_LOG_LEVEL := MY_LOG_LEVEL_VERBOSE
endif
# Appending the compiler flags
LOCAL_CFLAGS += ?DMY_LOG_TAG=$(MY_LOG_TAG)
LOCAL_CFLAGS += ?DMY_LOG_LEVEL=$(MY_LOG_LEVEL)
# Dynamically linking with the log library
LOCAL_LDLIBS += ?llog
运行项目观察。
控制台日志：
   当整合第三方的了类库和（legacy）模块到Android应用程序项目，
改变他们的日志机制到Android-specific可能是不可能的。大部分
日志机制发出日志信息到一个文件或者直接到这控制台。
    这控制台描述符，STDOUT和STDERR，默认情况下在Android平台
是不可见的。为重定位这些日志小到这Android系统日志，打开一个
命令窗口来执行ADB命令，如下：
   adb shell stop
   adb shell setprop log.redirect-stdio true
   adb shell start