isLoggable是什么

        在Android源码中，我们经常可以看到如下代码：

//packages/apps/InCallUI/src/com/android/incallui/Log.java

public static final String TAG = "InCall";
public static final boolean DEBUG = android.util.Log.isLoggable(TAG, android.util.Log.DEBUG);
public static void d(String tag, String msg) {
    if (DEBUG) {
        android.util.Log.d(TAG, delimit(tag) + msg);
    }
}

//packages/apps/InCallUI/src/com/android/incallui/InCallPresenter.java
private InCallState startOrFinishUi(InCallState newState) {
    Log.d(this, "startOrFinishUi: " + mInCallState + " -> " + newState);
    //... ...
}

isLoggable定义

        什么是isLoggable？isLoggable是android.util.Log提供的方法，用于检查指定TAG的level，是否满足输出条件，如满足则返回true反之则返回false。isLoggable在源码中的定义如下：

    /**
     * Checks to see whether or not a log for the specified tag is loggable at the specified level.
     *
     *  The default level of any tag is set to INFO. This means that any level above and including
     *  INFO will be logged. Before you make any calls to a logging method you should check to see
     *  if your tag should be logged. You can change the default level by setting a system property:
     *      'setprop log.tag.<YOUR_LOG_TAG> <LEVEL>'
     *  Where level is either VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT, or SUPPRESS. SUPPRESS will
     *  turn off all logging for your tag. You can also create a local.prop file that with the
     *  following in it:
     *      'log.tag.<YOUR_LOG_TAG>=<LEVEL>'
     *  and place that in /data/local.prop.
     *
     * @param tag The tag to check.
     * @param level The level to check.
     * @return Whether or not that this is allowed to be logged.
     * @throws IllegalArgumentException is thrown if the tag.length() > 23.
     */
    public static native boolean isLoggable(String tag, int level);

1. isLoggable默认level为android.util.Log.INFO；

2. 只有 level >= INFO才能输出，即level >= INFO时isLoggable返回true，反之则返回false；

3. 可以通过setprop log.tag.<YOUR_LOG_TAG> <LEVEL>来改变log的默认level，如adb shell setprop log.tag.InCall D。也可以将这些属性按照log.tag.InCall=D的形式，写入/data/local.prop中；

4. tag的长度如果超过23个字符则会抛出IllegalArgumentException异常；

        在android.util.Log类中定义了Log的6种Level，如下：

    /**
     * Priority constant for the println method; use Log.v.
     */
    public static final int VERBOSE = 2;

    /**
     * Priority constant for the println method; use Log.d.
     */
    public static final int DEBUG = 3;

    /**
     * Priority constant for the println method; use Log.i.
     */
    public static final int INFO = 4;

    /**
     * Priority constant for the println method; use Log.w.
     */
    public static final int WARN = 5;

    /**
     * Priority constant for the println method; use Log.e.
     */
    public static final int ERROR = 6;

    /**
     * Priority constant for the println method.
     */
    public static final int ASSERT = 7;

isLoggable使能方法

        前文提到，在自定义的Log类中通常使用isLoggable来判断是否输出log，如代码：

//packages/apps/InCallUI/src/com/android/incallui/Log.java

public static final String TAG = "InCall";
public static final boolean DEBUG = android.util.Log.isLoggable(TAG, android.util.Log.DEBUG);
public static void d(String tag, String msg) {
    if (DEBUG) {
        android.util.Log.d(TAG, delimit(tag) + msg);
    }
}

//packages/apps/InCallUI/src/com/android/incallui/InCallPresenter.java
private InCallState startOrFinishUi(InCallState newState) {
    Log.d(this, "startOrFinishUi: " + mInCallState + " -> " + newState);
    //... ...
}

①. 将Log.d修改为android.util.Log.d；使用android.util.Log类取代InCallUI自定义的Log类，重新编译系统APP并push到手机中即可；

②. 修改com.android.incallui.Log中的DEBUG限制；将DEBUG的值直接置为true，或者注释掉if(DEBUG)。也可以将isLoggable(TAG, android.util.Log.DEBUG)中的android.util.Log.DEBUG修改为android.util.Log.INFO，即将log的level增大，从而使isLoggable()返回true并使得DEBUG的值为true；

③. 设置log.tag.InCall的属性值；通过adb shell setprop log.tag.InCall D，或者将"log.tag.InCall=D"写入/data/local.prop中(不包含引号，如local.prop不存在则需自行创建，权限设为644)。根据定义中的描述，设置属性值需要在方法被调用之前，因此需要重启InCallUI进程。通过修改属性值的方法，从而使得isLoggable()的返回值为true，从而使得DEBUG的值为true。

        第一种方式直接修改，简单粗暴，但若修改点较多则比较麻烦，且需要重新编译代码。

        第二种方式修改点统一，但和第一种一样，也需要重新编译。

        第三种使用属性的方式使得isLoggable返回true，这种方式比较方便，同时适用于user/userdebug/eng各个版本的设备。这种方式需要在方法被调用前设置log.tag.InCall，通过代码：

public static final boolean DEBUG = android.util.Log.isLoggable(TAG, android.util.Log.DEBUG);

adb shell stop
adb shell start

        也可以通过将log.tag.InCall=D加入到/data/local.prop文件中，这种方式与setprop类似，都是设置属性值，但这种方式的好处是，设置之后重启设备该log.tag.InCall依然有效。不过因为/data目录的权限控制，只有userdebug/eng版本才可以修改/data/local.prop文件。

小结

        isLoggable的使能方法如下图所示：

图 1 isLoggable使能方案对比

        如果只是想启用某个进程的isLoggable方法，通过setprop设置属性是不错的选择，同事，想要重启设备后依然有效则需要设置/data/local.prop，不过/data目录只有在userdebug/eng版本中才可以写入。那如果想在user版中设置log.tag属性并在重启后依然有效，可以采取以下方法：

1. 获取user版系统的root权限；

2. 将log.tag.InCall=D追加到/system/build.prop文件中；

3. adb reboot重启设备；

        以上方案大家可能会疑惑，既然user版获取到了root权限，为什么不直接修改/data/local.prop呢？这是因为如果是user版，则ro.debuggable=0，所以系统启动时不会读取/data/local.prop文件，并最终导致设置log.tag属性不会生效。详细原理将在下一篇文章《Android 5.0 如何正确启用isLoggable(一)__原理分析》中探讨。