测试和调试数据库

使用 Room 持久性库创建数据库时，验证应用数据库和用户数据的稳定性非常重要。本页面讨论如何测试数据库以及执行调试步骤以帮助测试通过。

测试您的数据库

测试数据库有两种方法

  • 在 Android 设备上。
  • 在您的主机开发机器上（不推荐）。

有关数据库迁移特定测试的信息，请参阅测试迁移。

在 Android 设备上测试

测试数据库实现时推荐的方法是编写在 Android 设备上运行的 JUnit 测试。由于这些测试不需要创建 activity，因此它们的执行速度应比 UI 测试快。

设置测试时，您应该创建一个数据库的内存版本，以使您的测试更具隔离性，如以下示例所示

Kotlin

@RunWith(AndroidJUnit4::class)
class SimpleEntityReadWriteTest {
    private lateinit var userDao: UserDao
    private lateinit var db: TestDatabase

    @Before
    fun createDb() {
        val context = ApplicationProvider.getApplicationContext<Context>()
        db = Room.inMemoryDatabaseBuilder(
                context, TestDatabase::class.java).build()
        userDao = db.getUserDao()
    }

    @After
    @Throws(IOException::class)
    fun closeDb() {
        db.close()
    }

    @Test
    @Throws(Exception::class)
    fun writeUserAndReadInList() {
        val user: User = TestUtil.createUser(3).apply {
            setName("george")
        }
        userDao.insert(user)
        val byName = userDao.findUsersByName("george")
        assertThat(byName.get(0), equalTo(user))
    }
}

Java

@RunWith(AndroidJUnit4.class)
public class SimpleEntityReadWriteTest {
    private UserDao userDao;
    private TestDatabase db;

    @Before
    public void createDb() {
        Context context = ApplicationProvider.getApplicationContext();
        db = Room.inMemoryDatabaseBuilder(context, TestDatabase.class).build();
        userDao = db.getUserDao();
    }

    @After
    public void closeDb() throws IOException {
        db.close();
    }

    @Test
    public void writeUserAndReadInList() throws Exception {
        User user = TestUtil.createUser(3);
        user.setName("george");
        userDao.insert(user);
        List<User> byName = userDao.findUsersByName("george");
        assertThat(byName.get(0), equalTo(user));
    }
}

在您的主机机器上测试

Room 使用 SQLite 支持库，该库提供的接口与 Android 框架类中的接口相匹配。此支持允许您传入支持库的自定义实现来测试您的数据库查询。

测试您的迁移

Room 支持增量式数据库迁移，以便在应用更新更改数据库架构时保留现有应用数据。但是，定义不正确的迁移可能会导致您的应用崩溃。请务必测试您的 Room 数据库迁移。

调试您的数据库

您可以使用多种工具和流程来调试数据库。

使用 Database Inspector

在 Android Studio 4.1 及更高版本中，Database Inspector 允许您在应用运行时检查、查询和修改应用的数据库。Database Inspector 与 Android 捆绑的 SQLite 版本兼容，并包含用于 Room 的特殊功能

  • 使用边栏操作可快速从您的 DAO 类运行查询。
  • 当您的运行中的应用更改数据时，立即在 Database Inspector 中查看实时更新。

要详细了解 Database Inspector，请参阅使用 Database Inspector 调试您的数据库。

从命令行转储数据

Android SDK 包含一个用于检查应用数据库的 sqlite3 数据库工具。它包含 .dump 等命令用于打印表的内容，以及 .schema 用于打印现有表的 SQL CREATE 语句。

您还可以从命令行执行 SQLite 命令，如下面的代码段所示

adb -s emulator-5554 shell
sqlite3 /data/data/your-app-package/databases/rssitems.db

有关详细信息，请参阅 SQLite 网站上提供的 sqlite3 命令行文档。

更多资源

要详细了解如何测试和调试您的 Room 数据库，请参阅以下更多资源

博文

视频

上一页
迁移您的数据库
下一页
使用 SQLite 保存数据