此页面由 Cloud Translation API 翻译。

测试和调试数据库

在使用 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 数据库，请参阅下面列出的其他资源：

博文

Database Inspector：我们期待已久的实时数据库工具！

视频

Database Inspector (11 Weeks of Android)

迁移数据库

使用 SQLite 保存数据