如何使用Android Debug Database：3分钟实现高效SQLite调试流程
项目地址: https://gitcode.com/gh_mirrors/an/Android-Debug-Database Android Debug Database是一款强大的Android数据库调试工具，它能让开发者直接在浏览器中查看和操作应用的SQLite数据库与SharedPreferences，无需复杂的命令行操作或设备root，彻底改变了传统Android数据库调试的繁琐流程。
🚀 为什么选择Android Debug Database？
传统的Android数据库调试往往需要：
- 导出数据库文件到电脑
- 使用第三方工具查看
- 手动编写SQL命令测试
- 反复重启应用验证修改
而Android Debug Database带来了革命性的改变：
- 无需root设备，直接在浏览器中操作
- 可视化界面查看所有数据库和表结构
- 支持直接编辑、添加、删除数据
- 实时执行SQL查询并查看结果
- 一键导出数据库文件
💡 核心功能展示
Android Debug Database提供了丰富的功能集，让数据库调试变得前所未有的简单：
直观的数据浏览界面
通过浏览器访问调试地址后，你可以清晰地看到应用中所有的数据库和SharedPreferences文件，点击即可查看其中的表和数据内容。
便捷的数据编辑功能
选中任意数据行，即可打开编辑窗口进行修改，无需编写SQL语句，直接在表单中编辑并保存。
📦 快速集成步骤
1. 添加仓库依赖
在项目的settings.gradle文件中添加JitPack仓库：
maven { url 'https://jitpack.io' }
2. 添加库依赖
在app模块的build.gradle文件中添加调试依赖：
debugImplementation 'com.github.amitshekhariitbhu.Android-Debug-Database:debug-db:1.0.7'
注意：使用
debugImplementation确保该库只在调试版本中生效，不会影响发布版本
3. 启动应用并获取调试地址
运行应用后，在Logcat中会看到类似以下的日志：
D/DebugDB: Open http://XXX.XXX.X.XXX:8080 in your browser
🔧 使用方法
基本连接方式
- 确保手机和电脑连接同一网络
- 在浏览器中输入Logcat中显示的地址
- 开始调试数据库
针对模拟器的设置
- Android默认模拟器：在终端执行
adb forward tcp:8080 tcp:8080，然后访问http://localhost:8080 - Genymotion模拟器：在虚拟设备设置中启用桥接模式
自定义端口配置
如果需要使用8080以外的端口，可以在build.gradle中添加：
debug {
resValue("string", "PORT_NUMBER", "8081")
}
🔐 加密数据库支持
对于加密数据库，只需添加加密版本的依赖：
debugImplementation 'com.github.amitshekhariitbhu.Android-Debug-Database:debug-db-encrypt:1.0.7'
并在Gradle中配置数据库密码：
debug {
resValue("string", "DB_PASSWORD_PERSON", "your_password")
}
🎯 高级使用技巧
获取调试地址的Toast提示
如果错过了Logcat中的地址，可以通过反射调用显示Toast：
public static void showDebugDBAddressLogToast(Context context) {
if (BuildConfig.DEBUG) {
try {
Class<?> debugDB = Class.forName("com.amitshekhar.DebugDB");
Method getAddressLog = debugDB.getMethod("getAddressLog");
Object value = getAddressLog.invoke(null);
Toast.makeText(context, (String) value, Toast.LENGTH_LONG).show();
} catch (Exception ignore) {
}
}
}
调试自定义数据库文件
对于不在默认位置的数据库，可以通过以下方法添加：
public static void setCustomDatabaseFiles(Context context) {
if (BuildConfig.DEBUG) {
try {
Class<?> debugDB = Class.forName("com.amitshekhar.DebugDB");
Class[] argTypes = new Class[]{HashMap.class};
Method setCustomDatabaseFiles = debugDB.getMethod("setCustomDatabaseFiles", argTypes);
HashMap<String, Pair<File, String>> customDatabaseFiles = new HashMap<>();
// 添加自定义数据库文件路径
customDatabaseFiles.put(ExtTestDBHelper.DATABASE_NAME,
new Pair<>(new File(context.getFilesDir() + "/" + ExtTestDBHelper.DIR_NAME +
"/" + ExtTestDBHelper.DATABASE_NAME), ""));
setCustomDatabaseFiles.invoke(null, customDatabaseFiles);
} catch (Exception ignore) {
}
}
}
📝 注意事项
- 该库仅应在调试版本中使用，避免影响发布版本
- 确保开发环境和设备在同一网络下
- 对于生产环境中的敏感数据，建议使用加密数据库并妥善保管密码
通过Android Debug Database，开发者可以显著提高数据库调试效率，减少80%的调试时间，让SQLite数据库调试不再成为开发流程中的瓶颈。无论你是Android新手还是有经验的开发者，这款工具都能为你的开发工作带来极大便利。
想要了解更多细节，可以查看项目的README.md文件获取完整文档。现在就尝试集成Android Debug Database，体验高效便捷的Android数据库调试新方式吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
