Android NDK开发详解应用数据和文件之测试和调试数据库
在使用 Room 持久性库创建数据库时,请务必验证应用的数据库以及用户的数据是否稳定。本页介绍了如何测试数据库和执行调试步骤,以帮助您通过测试。
测试您的数据库
您可以通过以下两种方式测试数据库:
在 Android 设备上测试。
在主机开发计算机上测试(不推荐)。
如需了解专门针对数据库迁移的测试,请参阅测试迁移。
注意:在针对应用运行测试时,可以借助 Room 创建 DAO 类的模拟实例。这样一来,如果您不测试数据库本身,就无需创建完整的数据库。此功能是可行的,因为您的 DAO 不会泄露数据库的任何详细信息。
在 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 框架类中的接口相对应的接口。通过此项支持,您可以传递该支持库的自定义实现来测试数据库查询。
注意:虽然此设置可让测试快速运行,但我们不建议这样做,因为您的设备以及用户设备上运行的 SQLite 版本可能与主机上的版本不一致。
测试迁移
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)