测试和调试数据库

在使用 Room 持久性库创建数据库时,请务必验证应用的数据库以及用户的数据是否稳定。本页介绍了如何测试数据库和执行调试步骤,以帮助您通过测试。

测试您的数据库

您可以通过以下两种方式测试数据库:

  • 在 Android 设备上测试。
  • 在主机开发计算机上测试(不推荐)。

如需了解专门针对数据库迁移的测试,请参阅测试迁移

在 Android 设备上测试数据库

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

在设置测试时,您应创建内存版本的数据库以使测试更加封闭,如以下示例所示:

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 在应用运行时检查、查询和修改应用的数据库。数据库检查器与 Android 捆绑版本的 SQLite 兼容,并且包含与 Room 搭配使用的特殊功能:

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

如需详细了解 Database Inspector,请参阅使用 Database Inspector 调试数据库

通过命令行转储数据

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

您也可以从命令行执行 SQLite 命令,如以下代码段所示:

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

如需了解详情,请参阅 SQLite 网站上提供的 sqlite3 命令行文档

其他资源

如需详细了解如何测试和调试 Room 数据库,请参阅下面列出的其他资源:

博文

视频