Android插桩测试中如何通过MediaStore访问设备文件？

以下是针对你遇到问题的几个关键排查和解决方向：

1. 确保测试拥有必要的权限 #

插桩测试默认不会自动获取权限，即使你的debug版本已经申请过。你需要在测试类或测试方法上添加AndroidX Test的@GrantPermission注解，明确授予所需权限：

import androidx.test.rule.GrantPermissionRule
import org.junit.Rule

class MediaStoreTest {
    @get:Rule
    val permissionRule: GrantPermissionRule = GrantPermissionRule.grant(
        // 根据Android版本选择对应权限：Android 13+用READ_MEDIA_IMAGES等，低版本用READ_EXTERNAL_STORAGE
        android.Manifest.permission.READ_EXTERNAL_STORAGE
    )

    // 你的测试方法...
}

或者直接在测试方法上添加@GrantPermission(android.Manifest.permission.READ_EXTERNAL_STORAGE)注解。

2. 使用正确的上下文执行查询 #

不要手动new Activity，这种方式创建的Activity没有经过系统完整的初始化流程，上下文可能不具备访问MediaStore的能力。改用ActivityScenario获取已初始化的Activity上下文来执行查询：

import androidx.test.core.app.ActivityScenario
import org.junit.Test

@Test
fun testRetrieveMediaFiles() {
    ActivityScenario.launch(DummyActivity::class.java).use { scenario ->
        scenario.onActivity { activity ->
            // 这里用activity的contentResolver执行MediaStore查询，和你手动测试时的逻辑完全一致
            val projection = arrayOf(
                MediaStore.Files.FileColumns._ID,
                MediaStore.Files.FileColumns.DISPLAY_NAME
            )
            val cursor = activity.contentResolver.query(
                MediaStore.Files.getContentUri("external"),
                projection,
                null,
                null,
                null
            )
            
            cursor?.use {
                // 验证查询结果
                assert(it.count > 0) { "MediaStore未返回任何文件" }
            } ?: assert(false) { "查询Cursor为null" }
        }
    }
}

注意：DummyActivity只需是一个空的Activity，放在debug目录并在debug/AndroidManifest.xml中声明即可，不需要任何额外逻辑。

3. 核对查询逻辑与手动测试完全一致 #

确保测试中的MediaStore查询参数（URI、投影、筛选条件、排序规则）和你手动debug时的代码完全相同。比如：

• 如果手动查的是图片，测试里不要误用MediaStore.Video.Media.EXTERNAL_CONTENT_URI
• Android 10+不要使用旧的文件路径方式，必须用MediaStore的标准URI

4. 等待MediaStore完成文件索引（针对新添加的文件） #

如果测试前你刚把文件复制到设备，MediaStore可能需要一点时间完成索引。可以在测试中添加等待逻辑，直到查询到结果或超时：

private fun waitForMediaStoreResult(activity: Activity, timeoutMs: Long = 6000): Boolean {
    val start = System.currentTimeMillis()
    while (System.currentTimeMillis() - start < timeoutMs) {
        activity.contentResolver.query(
            MediaStore.Files.getContentUri("external"),
            arrayOf(MediaStore.Files.FileColumns._ID),
            null,
            null,
            null
        )?.use { cursor ->
            if (cursor.count > 0) return true
        }
        Thread.sleep(500)
    }
    return false
}

在测试中调用这个方法，确认有结果后再进行断言：

scenario.onActivity { activity ->
    val hasContent = waitForMediaStoreResult(activity)
    assert(hasContent) { "超时未获取到MediaStore文件" }
    // 后续查询逻辑...
}

5. 确认测试类型和依赖配置 #

• 确保你的测试代码放在androidTest目录下（插桩测试），而不是test目录（本地单元测试，无法访问设备ContentResolver）
• 检查build.gradle中是否添加了必要的AndroidX Test依赖：

androidTestImplementation 'androidx.test.ext:junit:1.1.5'
androidTestImplementation 'androidx.test:runner:1.5.2'
androidTestImplementation 'androidx.test:rules:1.5.0'

内容的提问来源于stack exchange，提问作者John Glen