作用

用于在没有连接电脑的时候对安装在手机上的自家 app 进行 debug

在进行 android app 开发时，会遇到紧急需要定位查找问题的情况，如果此时身边没有电脑，无法查看 logcat，定位问题只能靠猜测。

开发人员自己的手机上一般会装测试版的 app，使用此工具可以看到比较完善的 logcat 日志，比如：网络请求报文等

功能

1. 目前功能比较少，只有 logcat 日志查看功能

2. 1.1 支持实时日志查看

3. 1.2 支持日志级别过滤
4. 1.3 支持日志关键词过滤
5. 1.4 支持日志级别不同颜色显示
6. 1.5 支持超长日志的单击展开/收缩
7. 1.6 支持日志长按查看详情，会自动格式化 json，并且支持滚动及手势缩放查看
8. 1.7 支持选择多条日志进行复制/分享

9. 1.8 支持清除当前日志

10. 功能比较容易扩展

11. 2.1 Client 添加 AbstractMessageProcessor 的子类进行消息处理

      `DebugController.addProcessor(processor)`
    

12. 2.2 Client 发送信息到 Server

      `AbstractMessageProcessor.sendMessage(message)`
    

13. 2.3 Server 添加 IServerMessageProcessor 的实现类进行消息的处理

      `ServerMessageProcessorManager.addProcessor(processor)`
    

14. 2.4 Server 发送信息到 Client

      `ServerMessageProcessorManager.sendMessageToClient(processor, message)`
    

目录介绍

• app_debugger_controller: 与主 app 安装在同一台设备上的 app，用来连接主 app 进行 debug
• app-debugger: 在主 app 中依赖的 lib module
• app_test: 依赖 app-debugger 的 demo
• app_test-demo.apk app_test 编译出来的包，用 demo.jks 签名
• app_debugger_controller-demo.apk: app_debugger_controller 编译出来的安装包，用 demo.jks 签名

名词

• 服务端：app_debugger_controller
• 客户端：需要被 debug 的 app（依赖 app-debugger）

使用方式

• 安装&运行服务端程序： app_debugger_controller.apk

• 在客户端工程 app module 的 build.gradle 中添加 app-debugger 的依赖:

  compile 'com.billy.android:app-debugger:1.3.2'

• 运行客户端

• 服务端与客户端的连接建立成功后即可进行相关 debug（例如：日志查看）

安全性校验

服务端与客户端的签名必须一致

在根目录的 local.properties 中可自定义签名的相关信息

storeFileValue=/Users/billy/Documents/xxxx/xxx.keystore
storePasswordValue=xxxxx
keyAliasValue=xxxx
keyPasswordValue=xxxx