如何在Jetpack Compose中从Assets加载图片

方法一：使用Coil（推荐，适合大量图片场景） #

Coil是Jetpack Compose官方推荐的图片加载库，内置assets资源支持，还能自动处理缓存、线程调度和内存优化，非常适合处理数百张图片的场景。

1. 添加Coil依赖
   在Module级别的build.gradle.kts或build.gradle中引入依赖：

// build.gradle.kts
dependencies {
    implementation("io.coil-kt:coil-compose:2.5.0")
}

2. 加载assets图片
   直接用Coil的AsyncImage组件，传入asset://开头的URI即可：

import androidx.compose.foundation.Image
import androidx.compose.runtime.Composable
import coil.compose.AsyncImage

@Composable
fun AssetImage(assetPath: String) {
    AsyncImage(
        model = "asset:///$assetPath",
        contentDescription = "Asset image",
        // 可选：配置加载中/错误占位符
        // placeholder = painterResource(R.drawable.loading),
        // error = painterResource(R.drawable.error)
    )
}

// 使用示例
@Composable
fun ImageGrid() {
    // 假设assets下有images/image1.png、images/image2.png等文件
    val imagePaths = listOf("images/image1.png", "images/image2.png", "images/image3.png")
    LazyColumn {
        items(imagePaths) { path ->
            AssetImage(assetPath = path)
        }
    }
}

方法二：不使用第三方库（原生实现） #

如果不想引入第三方库，可以通过Android原生AssetManager手动读取图片流并解码为Bitmap：

import android.content.Context
import android.graphics.BitmapFactory
import androidx.compose.foundation.Image
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.graphics.asImageBitmap
import androidx.compose.ui.platform.LocalContext

@Composable
fun RawAssetImage(assetPath: String) {
    val context = LocalContext.current
    // 用remember缓存Bitmap，避免每次重组重复加载
    val bitmap = remember(assetPath) {
        context.assets.open(assetPath).use { inputStream ->
            BitmapFactory.decodeStream(inputStream)
        }
    }

    Image(
        bitmap = bitmap.asImageBitmap(),
        contentDescription = "Raw asset image"
    )
}

// 使用示例
@Composable
fun RawImageDemo() {
    RawAssetImage("images/demo.png")
}

注意事项 #

• 路径格式：assets路径不要以/开头，正确写法是"images/image.png"，而非"/images/image.png"。
• 性能优化：加载大量图片优先选Coil，它会自动处理内存/磁盘缓存、图片复用；原生实现需手动处理缓存，否则易引发内存问题。
• 异常处理：实际项目中建议添加异常捕获，处理文件不存在、解码失败等情况，避免崩溃。

内容的提问来源于stack exchange，提问作者Hadi Ahmadi