如何使用Jetpack Glance为Android Widget加载网络图片？

Glance的Image组件不支持直接加载远程URL，因为Widget运行在系统进程中，无法直接发起网络请求。必须先将图片下载到本地存储，再通过本地路径加载。具体步骤如下：

1. 后台下载图片到本地 #

在应用进程（而非Widget进程）中完成图片下载，比如在Repository或ViewModel里用OkHttp实现下载逻辑，将图片保存到应用内部缓存目录（无需额外权限）：

suspend fun downloadImage(imageUrl: String, context: Context): String? {
    return runCatching {
        val client = OkHttpClient()
        val request = Request.Builder().url(imageUrl).build()
        val response = client.newCall(request).execute()
        
        if (!response.isSuccessful) return null
        
        // 生成唯一文件名，保存到缓存目录
        val imageFile = File(context.cacheDir, "widget_img_${UUID.randomUUID()}.jpg")
        response.body?.byteStream()?.use { input ->
            imageFile.outputStream().use { output ->
                input.copyTo(output)
            }
        }
        imageFile.absolutePath
    }.getOrElse {
        it.printStackTrace()
        null
    }
}

2. 更新Room数据 #

将下载好的本地图片路径存入Room数据库，替换原来的远程URL字段。确保Glance从Room查询时，能获取到本地路径而非远程地址。

3. 在Glance中加载本地图片 #

使用FileImageProvider加载本地文件：

Image(
    modifier = GlanceModifier.size(50.dp),
    provider = FileImageProvider(File(item.localImagePath)),
    contentDescription = "Item image"
)

如果是用Uri存储，也可以用UriImageProvider：

Image(
    modifier = GlanceModifier.size(50.dp),
    provider = UriImageProvider(Uri.fromFile(File(item.localImagePath))),
    contentDescription = "Item image"
)

关键注意事项 #

• 必须在应用进程中完成图片下载，不能在Glance的Widget构建代码里直接发起网络请求（Widget进程无网络权限且受系统限制）。
• 优先使用应用内部缓存目录保存图片，无需申请外部存储权限，且系统会自动清理过期缓存。
• 可以配合WorkManager实现定时更新图片，确保Widget数据与本地图片同步。

内容的提问来源于stack exchange，提问作者Jéluchu