ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

如何快速上手DebugKit:5分钟安装并跑出悬浮调试面板的完整教程

如何快速上手DebugKit:5分钟安装并跑出悬浮调试面板的完整教程 如何快速上手DebugKit5分钟安装并跑出悬浮调试面板的完整教程【免费下载链接】debugkitEver hid debug functions in your UI? Here is now a clean way to do it!项目地址: https://gitcode.com/gh_mirrors/de/debugkit还在把调试按钮藏在 App 界面里开源 Android 调试工具DebugKit提供了一个优雅的解决方案一个可拖动、可缩放的悬浮调试面板让你运行时直接触发调试动作并即时在测试机屏幕上看到文字反馈。本教程带你在 5 分钟内完成安装跑出自己的悬浮调试面板。先认识 DebugKit 是什么DebugKit 是一个轻量级 Android 库Apache 2.0 协议minSdkVersion 15核心能力就一个悬浮调试面板DevTool以 Fragment 形式叠加在任意 Activity 上面板上可排列 F1、F2、F3… 等功能按钮运行时反馈控制台点击按钮后执行结果和log()输出会实时打印在面板的控制台区域双主题支持深色DARK默认与浅色LIGHT两种风格还可折叠成迷你模式。效果一目了然下面这张截图展示了三种形态浅色主题面板、迷你模式、以及带控制台输出的深色面板。核心源码就在三个文件里想深挖时可以直接阅读构建入口debugkit/src/main/java/com/hulab/debugkit/DevTool.java按钮逻辑debugkit/src/main/java/com/hulab/debugkit/DebugFunction.java面板 UIdebugkit/src/main/java/com/hulab/debugkit/DevToolFragment.java一键安装2 分钟配置 Gradle 依赖第一步获取源码打开终端clone 仓库到本地也可以直接用 IDE 打开目录git clone https://gitcode.com/gh_mirrors/de/debugkit仓库是一个双模块工程app是示例应用debugkit是库本体。第二步添加依赖方式一直接引入远程依赖在build.gradle中repositories { jcenter() } dependencies { compile com.hulab.android:debugkit:1.2.1 }方式二在本地源码工程里用示例应用的写法以模块方式引用参考app/build.gradle第 23 行implementation project(path: :debugkit)完成这两步安装就算结束了——没有额外的AndroidManifest配置也不需要权限。最快配置方法3 行代码弹出悬浮调试面板在任意 Activity 的onCreate中用DevTool.Builder构建并显示面板即可final DevTool.Builder builder new DevTool.Builder(this); builder.addFunction(new DebugFunction(测试按钮) { Override public String call() throws Exception { log(正在执行调试操作...); return 调试操作完成; } }).build();build()之后悬浮面板就会出现在当前页面上。按钮点击后返回的字符串会带时间戳打印到面板控制台里。调试功能按钮怎么加自定义、清空、导出 SharedPrefs每个按钮对应一个DebugFunctioncall()的返回值就是控制台输出。除自定义按钮外库内置了两个实用功能按钮说明示例自定义函数执行任意调试逻辑可用构造函数指定按钮标题new DebugFunction(我的功能) { ... }Clear一键清空控制台日志new DebugFunction.Clear(Clear)DumpSharedPreferences把 Shared Preferences 文件内容直接打印出来new DebugFunction.DumpSharedPreferences(Shared prefs, preferences)任意函数内部还可以随时调用log(...)追加日志。完整示例可以参考app/src/main/java/com/hulab/debugkit/example/ExampleActivity.java其中还演示了用SeekBar动态调整按钮数量的玩法。主题、位置、字号可选的外观设置Builder采用链式 API三个常用可选项setTheme(DevToolFragment.DevToolTheme.DARK)深色默认/ 浅色主题displayAt(x, y)设置面板初始位置默认是(0, 0)setFontSize(sp)控制台字号默认 12sp。builder.setTextSize(14) .displayAt(100, 100) .setTheme(DevToolFragment.DevToolTheme.LIGHT) .build();另外面板左上角的箭头按钮可以把面板折叠成迷你模式右上角的 × 关闭面板标题栏可拖拽移动——这些交互都内置在debugkit/src/main/res/layout/debugkit_fragment_dev_tools.xml中开箱即用。跑起来5 分钟验证你的悬浮调试面板用 Android Studio 打开 clone 下来的仓库等待 Gradle 同步完成运行示例工程app模块applicationId为com.hulab.debugkit.example启动后页面会自带一个深色悬浮面板通过displayAt(50, 200)定位点击 Make ShPrf 写入几条共享偏好再点 Shared prefs控制台立即打印出文件内容用页面下拉框切换 Dark / Light 主题拖动面板、点击左上角箭头折叠体验完整交互。常见问题DebugKit 新手容易踩的 3 个坑面板没出现检查是否传入了当前页面的Activity上下文且build()之后 Activity 没有被重建正式版要隐藏面板DevTool中定义了总开关devToolsEnabled见debugkit/src/main/java/com/hulab/debugkit/DevTool.java第 15 行发布版置为false即可彻底禁用依赖拉不下来确认repositories中配置了jcenter()远程版本号目前为1.2.1。小结DebugKit 的价值在于零侵入、所见即所得不污染正式 UI不依赖 logcat调试动作与反馈直接呈现在测试机屏幕上。安装依赖 → 添加DebugFunction→build()三步即可让悬浮调试面板在你的 App 中工作值得每个 Android 开发者放进工具箱。【免费下载链接】debugkitEver hid debug functions in your UI? Here is now a clean way to do it!项目地址: https://gitcode.com/gh_mirrors/de/debugkit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表