一.权限申请#

Android 的权限申请一直是让人很头疼的问题,特别是从 Android 10开始,存储权限几乎是每个大版本都会更新,但好在万能的开源社区已经提供了现成的解决方案 Accompanist.尽管如此,针对不同安卓版本适配图片读取逻辑还是不可避免的,秉持着先做一坨垃圾出来的原则, 这里优先适配 Andriod 14

1. Android 14#

1.先在 build.gradle 里添加Accompanist的依赖

1
…
2
dependencies {
3
    …
4
    implementation (libs.accompanist.permissions)
5
}
6
…

2.在 Manifest 中声明权限

1
<?xml version="1.0" encoding="utf-8"?>
2
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
3
    xmlns:tools="http://schemas.android.com/tools">
4

5
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
6
    …
7
    </application>
8

9
</manifest>

3.申请权限

这里还是做垃圾原则,直接在 LaunchedEffect 中处理权限申请逻辑.这种实现方式的特点是：

仅在 Composable 首次组合时执行一次
通过调用 PermissionState.launchPermissionRequest() 即可进行权限申请

1
fun HomeScreen(){
2
    val context = LocalContext.current
3
    val readMediaImagePermission = rememberPermissionState(android.Manifest.permission.READ_MEDIA_IMAGES)
4

5

6
    LaunchedEffect(Unit) {
7
        if (!readMediaImagePermission.status.isGranted){
8
            readMediaImagePermission.launchPermissionRequest()
9
        }
10
        else{
11
            …
12
        }
13
    }
14
}

在 Accompanist 的帮助下,申请权限的代码就只需要以上寥寥几行(当然还没有考虑到各种包括但不限于被权限申请被拒绝的情况~~,这些当然是统统交给未来的我啦~~)

二.图片读取#

在完成权限申请后,下一步是读取设备中的图片.针对 Android 14,如果未申请 MANAGE_EXTERNAL_STORAGE (访问全部文件权限),官方推荐使用 MediaStore API 来安全访问媒体文件,这里甩一个 Google 官方文档的链接访问共享存储空间中的媒体文件

1
withContext(Dispatchers.IO){
2
                val collection = MediaStore.Images.Media.EXTERNAL_CONTENT_URI
3
                val projection = arrayOf(
4
                    MediaStore.Images.Media._ID,
5
                    MediaStore.Images.Media.DISPLAY_NAME,
6
                    MediaStore.Images.Media.DATE_ADDED
7
                )
8
                val query = context.contentResolver.query(
9
                    collection,
10
                    projection,
11
                    null,
12
                    null,
13
                    null
14
                )
15
                val list = mutableListOf<Uri>()
16

17
                query?.use { cursor ->
18
                    val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)
19
                    while (cursor.moveToNext()) {
20
                        val id = cursor.getLong(idColumn)
21
                        val contentUri = ContentUris.withAppendedId(collection, id)
22
                    }
23
                }
24
}

图片读取操作在协程中执行,通过 query 方法传入参数可指定：

媒体类型（如仅查询图片）
返回列（筛选需要的字段）
排序方式（如按日期降序）
等等

当前实现仅使用了前两项配置,最终获取所有可用图片的 Uri,供后续展示使用.

三.图片展示#

目前计划使用瀑布流展示图片,简单搭建脚手架后,直接使用 LazyVerticalGrid,没错Compose 已经内置了现成的瀑布流布局~~,让人怀念起给 RecyclerView 写 Adapter 的峥嵘岁月(~~ 图片加载库选择了与 Kotlin 和协程兼容性更好的 Coil

1
LazyVerticalGrid(
2
        columns = GridCells.Fixed(2),
3
        horizontalArrangement = Arrangement.spacedBy(10.dp),
4
        verticalArrangement = Arrangement.spacedBy(10.dp)
5
    ) {
6
        items(imageList){ uri ->
7
            AsyncImage(
8
                model = uri,
9
                contentDescription = null
10
            )
11
        }
12
    }

四.效果#

可以看出产物十分吻合开发理念(