EnDebugBubble

English

一个良好的Debug工具入口，是每个app所必备的，对于凌乱的调试工具整理和调试功能的统一使用方法，需要一个外观整洁，内部具体的显示容器。

传统方案

方案一：一般的调试工具，借助在应用主界面某一处增加入口的方式，提供统一调试界面

• 入口固定，进入深层次界面调用Debug工具必须退回Debug固定入口处
• 出现UI调试等需求，调试工具不够灵活

方案二：传统悬浮窗实现调试入口

• 悬浮窗面临权限问题
• 一般悬浮窗的功能过于单一
• 浮在应用上影响整体使用体验

功能

此工具只提供一个悬浮窗样式的调试工具界面的实践，使用者可以自行填充调试测试功能进行使用。

• 应用内显示，无需申请任何权限；
• 支持拖拽；
• 超出屏幕限制移动；
• 可自动吸附到屏幕边缘；
• 销毁悬浮窗灵活；
• 可实时显示内存占用等信息；
• 点击悬浮窗可弹出浮层进行功能设定；
• 浮层高度可灵活调整；
• 调试浮层可增加多页；
• 提供多种显示控件，如单选控件、多选控件、富多选信息控件、文字控件等
• 填充测试功能方便，利于维护；
• APP任意位置灵活唤出，APP外部自动隐藏；
• 链式调用，调用简单。

使用规则

1. 在基类Activity（注意必须是基类Activity）中的onStart和onStop添加如下代码

   @Override
   protected void onStart() {
       super.onStart();
       DebugTools.get().attach(this);
   }

   @Override
   protected void onStop() {
       super.onStop();
       DebugTools.get().detach(this);
   }

2. 显示Debug工具

   DebugTools.get().add();

增强设置

销毁Debug工具

   DebugTools.get().remove();

拦截返回键销毁菜单

    @Override
    public void onBackPressed() {
        if (!DebugTools.get().dismissMenu()){
            super.onBackPressed();
        }
    }

填充数据并显示（在onCreate中提前显示需要主动调用一次attach）

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        DebugTools.get().attach(this)
                .fillMenuData(DebugConfig.getList())
                .add();
    }

更新悬浮窗显示信息

    DebugTools.get().updateInfo(memorySize, percent);

数据填充

支持四种类型控件填充列表

1.单选控件

    new RadioEntity().setGroupBtnName("接口类型1#接口类型2#接口类型3")
            .setCheckPosition(getSelectedHostId())
            .setOnCheckedChangeListener(getHostCheckedChangeListener()).setTitle("接口类型:");

2.开关控件

    new SwitchEntity().setChecked(true)
            .setTitle("test feature toggle1")
            .setInfo("动态功能开关测试1")
            .setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
                @Override
                public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
                    Toast.makeText(BubbleContext.getAppContext(), "动态功能开关测试", Toast.LENGTH_SHORT).show();
                }
            });

3.标题控件

    new TextEntity().setTitle("测试页面");

4.普通控件

    new SimpleEntity().setTitle("测试1")
            .setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    Toast.makeText(BubbleContext.getAppContext(), "Test", Toast.LENGTH_SHORT).show();
                }
            });

效果图

特别鸣谢

本开源库借鉴多个开源库，感谢以下开源库为开源力量做出的贡献：

https://github.com/zzz40500/AndroidSweetSheet

https://github.com/txusballesteros/bubbles-for-android

https://github.com/LongMaoC/WaterView

https://github.com/leotyndale/EnFloatingView

https://github.com/gyw520gyw/GroupButtonView