【Android studio】使用 Database Inspector 调试数据库【MyAndroid】
在 Android Studio 4.1 及更高版本中,您可以利用 Database Inspector 在应用运行时检查、查询和修改应用的数据库。这对于数据库调试尤为有用。Database Inspector 可处理普通的 SQLite 数据库以及在 SQLite 的基础上构建的库(例如 Room)。
注意:Database Inspector 仅可与 API 级别 26 及更高版本的 Android 操作系统中所包含的 SQLite
库结合使用。它无法处理与您的应用捆绑的其他 SQLite 库。
打开 Database Inspector
注意:与 Android 11 模拟器有关的已知问题会导致应用在连接到 DB Inspector
时发生崩溃。如需解决此问题,请按以下步骤操作。
如需在 Database Inspector 中打开数据库,请执行以下操作:
- 在模拟器或搭载 API 级别 26 或更高版本的已连接设备上运行您的应用。
- 从菜单栏中依次选择 View > Tool Windows > AppInspection。
- 选择 Database Inspector 标签页。
- 从下拉菜单中选择正在运行的应用进程。
- 当前正在运行的应用中的数据库显示在 Databases 窗格中。展开要检查的数据库的节点。
查看和修改数据
Databases 窗格显示应用中的数据库列表以及每个数据库包含的表格。双击表格名称即可在检查器窗口的右侧显示其数据。您可以点击列标题,按该列对检查器窗口中的数据进行排序。
您可以通过以下方式修改表中的数据:双击单元格,输入新值,然后按 Enter 键。如果您的应用使用 Room 并且界面会观察数据库(例如使用 LiveData 或 Flow),那么您对数据所做的任何更改会立即显示在正在运行的应用中。否则,只有当应用下次从数据库中读取修改后的数据时,您才会看到更改。
查看实时数据库更改
如果您希望 Database Inspector 在您与正在运行的应用交互时自动更新它呈现的数据,请勾选检查器窗口顶部的 Live updates 复选框。启用实时更新后,检查器窗口中的表格将变为只读状态,您无法修改其中的值。
或者,您也可以通过点击检查工具窗口顶部的 Refresh table 按钮以手动更新数据。
查询数据库
Database Inspector 可以在应用运行时对应用的数据库运行查询。Database Inspector 可以在您的应用使用 Room 的情况下使用 DAO 查询,但也支持自定义 SQL 查询。
运行 DAO 查询
如果您的应用使用 Room,那么 Android Studio 会提供边线操作,让您可以快速运行您已在 DAO 类中定义的查询方法。如果您的应用正在运行且 Database Inspector 已在 Android Studio 中打开,就可以执行这些操作。您可以在 DAO 中运行任何查询方法,方法是点击 @Query 注解旁边的 Run SQLite statement in Database Inspector 按钮。
如果应用包含多个数据库,Android Studio 会提示您从下拉列表中选择要查询的数据库。如果您的查询方法包含已命名的绑定参数,Android Studio 会在运行查询之前请求获取每个参数的值。查询结果会显示在检查器窗口中。
运行自定义 SQL 查询
您也可以在应用运行时使用数据库 Database Inspector 运行自定义 SQL 查询来查询您应用的数据库。如需查询数据库,请按以下步骤操作:
点击 Databases 窗格顶部的 Open New Query 标签页 ,在检查器窗口中打开新标签页。
如果应用包含多个数据库,请从 New Query 标签页上的下拉菜单中选择要查询的数据库。
在 New Query 标签页顶部的文本字段中输入您的自定义 SQL 查询,然后点击 Run。
或者,您也可以使用查询历史记录功能来运行先前使用的查询:
点击 Show query history “Show query history”按钮 按钮,查看您先前针对所选数据库运行的查询列表。
点击列表中的某个查询便可在编辑器中查看完整查询的预览,然后按 Enter 将其复制到编辑器中。
点击 Run 以执行该语句。
New Query 标签页中显示的查询结果是只读的,无法修改。但是,您可以使用自定义 SQL 查询字段运行 UPDATE、INSERT 或 DELETE 等修饰符语句。如果您的应用使用 Room 并且界面会观察数据库(例如使用 LiveData 或 Flow),那么您对数据所做的任何更改会立即显示在正在运行的应用中。否则,只有当应用下次从数据库中读取修改后的数据时,您才会看到更改
离线模式
在 Android Studio 4.2 及更高版本中,您可以在进程断开连接后继续检查应用的数据库。这样,在崩溃后可以更轻松地调试应用。
如果发生断开连接的情况,Database Inspector 会下载您的数据库,然后供您在离线模式下使用这些数据库。您仍然可以在离线模式下打开表格并运行查询。
当您重新连接至实时应用进程时,Database Inspector 将退出离线模式,并仅显示设备上的数据。也就是说,重新连接到应用进程后,系统不会保留离线模式下显示的数据。由于此限制,Database Inspector 不支持在离线模式下修改数据或运行修改 SQL 语句。
使数据库连接保持打开状态
Database Inspector 只能在应用保持与相应数据库的实时连接时修改数据库。这意味着,如果应用频繁与数据库连接和断开连接,就会很难调试这些数据库。Databases 窗格使用图标识别打开的 () 和关闭的 () 数据库。
此外,您还可以防止数据库连接关闭,方法是在 Databases 窗格顶部将 Keep database connections open 从关闭 () 切换为开启 ()。
从 Database Inspector 中导出数据
您可以从 Database Inspector 中导出数据库、表和查询结果,以便在本地保存、共享或重新创建。在 Android Studio 中打开一个应用项目并在 Database Inspector 中检查该项目的应用时,可以采用以下任一方法开始导出数据:
在 Databases 面板中选择数据库或表,然后点击面板顶部附近的 Export to file。
右键点击 Databases 面板中的数据库或表,然后从上下文菜单中选择 Export to file。
在标签页中检查表或查询结果时,点击表或查询结果上方的 Export to file。
选择导出操作后,请使用 Export 对话框帮助您完成最后的步骤,如下所示。根据是否需要尝试导出数据库、表或查询结果,可以选择使用以下一种或多种格式导出数据:DB、SQL 或 CSV。
亲测
好用
自研产品推荐
历时一年半多开发终于smartApi-v1.0.0版本在2023-09-15晚十点正式上线
smartApi是一款对标国外的postman的api调试开发工具,由于开发人力就作者一个所以人力有限,因此v1.0.0版本功能进行精简,大功能项有:
- api参数填写
- api请求响应数据展示
- PDF形式的分享文档
- Mock本地化解决方案
- api列表数据本地化处理
- 再加上UI方面的打磨
为了更好服务大家把之前的公众号和软件激活结合,如有疑问请大家反馈到公众号即可,下个版本30%以上的更新会来自公众号的反馈。
嗯!先解释不上服务端原因,API调试工具的绝大多数时候就是一个数据模型、数据处理、数据模型理解共识的问题解决工具,所以作者结合自己十多年开发使用的一些痛点来打造的,再加上服务端开发一般是面向企业的,作者目前没有精力和时间去打造企业服务。再加上没有资金投入所以服务端开发会滞后,至于什么时候会进行开发,这个要看募资情况和用户反馈综合考虑。虽然目前国内有些比较知名的api工具了,但作者使用后还是觉得和实际使用场景不符。如果有相关吐槽也可以在作者的公众号里反馈蛤!
下面是一段smartApi使用介绍: