AndroidLog日志调试(android.utl.log类)

    Android调试要通过模拟器运行，或者直接USB远程连接到一部手机调试。即使在不关闭模拟进行调试时候，也要经过编译、apk打包、上传apk、运行apk的过程，时间也不短，所以应该在程序固定一次运行中，产生更多我们需要关注的信息，来更清楚的了解程序的运行和逻辑，以便减少上述较长的过程(以前开发用过最土的做法，为了check某个变量的值，使用Toast.makeText()然后show出来，很麻烦)。

        做过互联网后台系统服务或大型程序的人们都知道，如果后台服务异常了，第一反应就是去查日志，看看到底哪里出了问题(提示一下，许多人认为打日志是磁盘操作很影响性能，其实不然，Linux的文件系统会对read/write等系统调用做page cache缓存，只要不是Direct I/O方式基本都可以认为是内存操作)，Android系统亦是如此(不过是在调试时候，发布时候则不会带日志)。

        今天要提到的就是Android为我们提供的android.util.log类，可以边运行边打日志，打出的日志可以通过Eclipse的View的LogCat来查询。

        * Android日志实现原理(不关心细节实现可以跳过) :

     首先用户态的App经过Java VM(Android是dalvikvm)产生LOG信息，并与ADB Device Daemon(手机端的adb进程，打开”手机调试“功能时启动的，这就是为什么安装豌豆荚时候手机要开启"手机调试"功能)交互输出这些信息，而ADB Device Daemon又通过相应的协议通过USB（Device）或本地连接（Emulator），与PC上运行的ADB Host Daemon交互，通过PC上的调试工具传递给Eclipse中的ADK插件进行显示。

     具体流程 : 

        App通过util.log.<x>产生日志->JVM->JNI(Native C)调用->log_write的sys_call()->logger驱动->dispatch分发给订阅者

        logger是android系统级的驱动程序，会把注册在系统里的读log的请求者(例如链接过来的eclipse和adb进程、或者linux命令行工具logcat)，通过IO复用函数select()来推送数据。

        

        打印日志语句实例 :

[java]  view plain copy print ?

1. Log.v("MyTag", "This is Verbose.");     // 输出verbose级别的字符串  

        

        java.util.log里定义了不同级别的输出，分别在LogCat里显示不同的颜色，以便更精准的查找:

Log.v 的调试颜色为黑色的，任何消息都会输出，这里的v代表verbose啰嗦的意思，平时使用就是Log.v("","");

Log.d的输出颜色是蓝色的，仅输出debug调试的意思，但他会输出上层的信息，过滤起来可以通过DDMS的Logcat标签来选择.

Log.i的输出为绿色，一般提示性的消息information，它不会输出Log.v和Log.d的信息，但会显示i、w和e的信息

Log.w的意思为橙色，可以看作为warning警告，一般需要我们注意优化Android代码，同时选择它后还会输出Log.e的信息。

Log.e为红色，可以想到error错误，这里仅显示红色的错误信息，这些错误就需要我们认真的分析，查看栈的信息了。

        写程序的时候可以通过调用不同的Log.<x>来分级自己的输出。

        

        打印日志的时候，可能我们不只需要错误的msg，还希望得到调用者的堆栈(比如打log的函数名是什么，类名是什么)。所以，本人编写了一个可以封装这些信息的build函数来封装一些具体信息，用户只需要传入msg即可。并且通过debug开关，在程序发布时候关闭无用的日志调用:

[java]  view plain copy print ?

1. public static class LogMsgBuidler  
2. {  
3.   
4.     private static boolean DEBUG = true; /* 默认开启 */  
5.   
6.     public static void reverse()  
7.     {  
8.         DEBUG = !DEBUG; /* 反转DEBUG设置 */  
9.     }  
10.   
11.     public static String build(String msg)  
12.     {  
13.   
14.         if (!DEBUG)  
15.             return msg;  
16.         // 获取堆栈信息  
17.         StackTraceElement caller = new Throwable().fillInStackTrace().getStackTrace()[2];  
18.   
19.         return new StringBuilder().append(caller.getClassName())  
20.             .append(".").  
21.             append(caller.getMethodName())  
22.             .append("(): ")  
23.             .append(msg).toString();  
24.     }  
25. }  

在程序中输出日志, 使用 android. util. Log 类.
该类提供了若干静态方法

Log.v(String tag, String msg);
Log.d(String tag, String msg);
Log.i(String tag, String msg);
Log.w(String tag, String msg);
Log.e(String tag, String msg);

分别对应 Verbose, Debug, Info, Warning,Error.

tag是一个标识,可以是任意字符串,通常可以使用类名+方法名, 主要是用来在查看日志时提供一个筛选条件.


程序运行后 并不会在 ide的控制台内输出任何信息.

如果要后查看日志 请使用

adb logcat

关于adb的更多信息请查看官方网站.

当执行 adb logcat 后会以tail方式实时显示出所有的日志信息.

这时候我们通常需要对信息进行过滤,来显示我们需要的信息, 这时候我们指定的 tag就派上了用场.

adb logcat -s MyAndroid:I

这时将只显示tag为MyAndroid,级别为I或级别高于I(Warning,Error)的日志信息.

示例代码如下:

Java代码

1. package com.zijun;   
2.   
3. import android.app.Activity;   
4. import android.content.Context;   
5. import android.graphics.Canvas;   
6. import android.os.Bundle;   
7. import android.util.Log;   
8. import android.view.MotionEvent;   
9. import android.view.View;   
10.   
11. public class MyAndroid extends Activity {   
12.        
13.     protected static final String ACTIVITY_TAG="MyAndroid";   
14.        
15.     @Override  
16.     protected void onCreate(Bundle icicle) {   
17.         super.onCreate(icicle);   
18.         setContentView(new MyView(this));   
19.     }   
20.     public class MyView extends View {   
21.         public MyView(Context c) {   
22.             super(c);   
23.         }   
24.         @Override  
25.         protected void onDraw(Canvas canvas) {   
26.     
27.         }   
28.         @Override  
29.         public boolean onMotionEvent(MotionEvent event) {   
30.             Log.i(MyAndroid.ACTIVITY_TAG, "=============================");   
31.                
32.             Log.d(MyAndroid.ACTIVITY_TAG, "Haha , this is a DEBUG of MyAndroid. ");   
33.             Log.i(MyAndroid.ACTIVITY_TAG, "Haha , this is a INFO of MyAndroid. ");   
34.             Log.w(MyAndroid.ACTIVITY_TAG, "Haha , this is a WARNING of MyAndroid. ");   
35.   
36.             return true;   
37.         }   
38.            
39.     }   
40.   
41. }  

package com.zijun;
import android.app.Activity;
import android.content.Context;
import android.graphics.Canvas;
import android.os.Bundle;
import android.util.Log;
import android.view.MotionEvent;
import android.view.View;
public class MyAndroid extends Activity {
protected static final String ACTIVITY_TAG="MyAndroid";
@Override
protected void onCreate(Bundle icicle) {
super.onCreate(icicle);
setContentView(new MyView(this));
}
public class MyView extends View {
public MyView(Context c) {
super(c);
}
@Override
protected void onDraw(Canvas canvas) {
}
@Override
public boolean onMotionEvent(MotionEvent event) {
Log.i(MyAndroid.ACTIVITY_TAG, "=============================");
Log.d(MyAndroid.ACTIVITY_TAG, "Haha , this is a DEBUG of MyAndroid. ");
Log.i(MyAndroid.ACTIVITY_TAG, "Haha , this is a INFO of MyAndroid. ");
Log.w(MyAndroid.ACTIVITY_TAG, "Haha , this is a WARNING of MyAndroid. ");
return true;
}
}
}

以上程序运行后, 在命令行执行  adb logcat -s MyAndroid:I
然后在手机模拟器的屏幕上 点击 拖动鼠标 就能看到相应的日志信息.

 

 

logcat是Android中一个命令行工具，可以用于得到程序的log信息。

logcat使用方法如下所示:
logcat [options] [filterspecs]
logcat的选项包括:
  -s                    设置过滤器，例如指定 '*:s'
  -f <filename>   输出到文件，默认情况是标准输出。
  -r [<kbytes>]   Rotate log every kbytes. (16 if unspecified). Requires -f
  -n <count>      Sets max number of rotated logs to <count>, default 4
  -v <format>     设置log的打印格式,  <format> 是下面的一种:
                         brief process tag thread raw time threadtime long

  -c                   清除所有log并退出
  -d                   得到所有log并退出 (不阻塞)
  -g                   得到环形缓冲区的大小并退出
  -b <buffer>     请求不同的环形缓冲区    ('main' (默认), 'radio', 'events')
  -B                   输出log到二进制中。

过滤器的格式是一个这样的串：
  <tag>[:priority]

其中 <tag> 表示log的component， tag (或者使用 * 表示所有) ， priority 如下所示:
  V    Verbose
  D    Debug
  I    Info
  W    Warn
  E    Error
  F    Fatal
  S    Silent


事实上logcat的功能是由Android的类android.util.Log决定的，在程序中log的使用方法如下所示：
Log.v() －－－－－－－－－－－－－－－－－－－－ VERBOSE
Log.d() －－－－－－－－－－－－－－－－－－－－ DEBUG
Log.i() －－－－－－－－－－－－－－－－－－－－ INFO
Log.w() －－－－－－－－－－－－－－－－－－－－ WARN
Log.e() －－－－－－－－－－－－－－－－－－－－ ERROR
以上log的级别依次升高，DEBUG信息应当只存在于开发中，INFO, WARN，ERROR这三种log将出现在发布版本中。

对于JAVA类，可以声明一个字符串常量TAG，Logcat可以根据他来区分不同的log,例如在计算器（Calculator）的类中，定义如下所示：

public class Calculator extends Activity {
/* ...... */
    private static final String LOG_TAG = "Calculator";
    private static final boolean DEBUG  = false;
    private static final boolean LOG_ENABLED = DEBUG ? Config.LOGD : Config.LOGV;
/* ...... */
   由此，所有在Calculator中使用的log，均以"Calculator"为开头。

例如使用方法如下所示：
# logcat &
< 得到一个log片段 >
W/KeyCharacterMap(  130): No keyboard for id 0
W/KeyCharacterMap(  130): Using default keymap: /system/usr/keychars/qwerty.kcm.bin
I/ActivityManager(   52): Displayed activity com.android.contacts/.DialtactsContactsEntryActivity: 983 ms
I/ARMAssembler(   52): generated scanline__00000077:03545404_00000A04_00000000 [ 29 ipp] (51 ins) at [0x25c978:0x25ca44] in 1764174 ns
I/ARMAssembler(   52): generated scanline__00000077:03515104_00000001_00000000 [ 46 ipp] (65 ins) at [0x25d1c8:0x25d2cc] in 776789 ns
D/dalvikvm(  130): GC freed 834 objects / 81760 bytes in 63ms
D/dalvikvm(   52): GC freed 10588 objects / 425776 bytes in 94ms

其中W/I/D表示log的级别，“dalvikvm”“ARMAssembler”等是不同组件（component）的名称，后面括号里面的数字表示了发出log的进程号。

使用技巧：
1.使用logcat &在后台运行
2.使用-d得到所有log
3.使用-f或者重定向（>和>>）输出到文件
4.使用-s设置过滤器，得到想要的log。

当然，最重要的还是在程序中加入恰当的log.