【安卓 - 小组件】图片的渲染

一、3种资源路径

• 本地drawable文件夹里的静态资源可以直接渲染
• file:// xx 或者 /data/user/0/xxxapp/cache/widget_cache/71d5febb3f6dd37557475ff5986560f8png
  不可以直接渲染。参照 下面 2. 3.两点
• http:// xxx 线上资源路径不可以直接渲染。需要:
  *
  1. 先下载，得到为 /data/user/0/xxxapp/xx 的项目私有目录路径
  • 2. 设置缓存，避免重复下载、保存同一资源。（如果需要的话）
  • 3. 转化为 content：//xxxx （非必须。如果需要在不同app之间共享，才转化）
  • 4. 转化为： bitmap
  • 5. 压缩

二、 file://、content://、Bitmap (android.graphics.Bitmap@xxxx) 三者 的区别

都是 图片数据的不同"存在方式"或"引用方式" ，它们在 Android 系统中有着完全不同的作用域、访问权限和用途 。

下面我帮你彻底梳理清楚这三者的区别和在小组件（App Widget）中的表现👇

---

🧩 一、file:// ------ 本地文件路径 URI

形式：

file:///data/user/0/io.iftech.lovemo/cache/widget_cache/image.png

含义：

• 指向 应用私有目录中的文件。
• 是一个本地路径 URI（scheme 为 file://）。
• 可以直接被 你自己的 app 代码读取 （File, BitmapFactory.decodeFile 等）。
• 但 其他进程（比如桌面 Launcher）没有权限访问。

在小组件中：

❌ RemoteViews.setImageViewUri(Uri.parse("file://...")) 无效，因为桌面进程读不到。

典型用法（仅在自己 app 内）

val bitmap = BitmapFactory.decodeFile("/data/.../image.png")
imageView.setImageBitmap(bitmap)

---

🧩 二、content:// ------ Content Provider 暴露的资源 URI

形式：

content://io.iftech.lovemo.widgetfileprovider/widget_cache/abc123.png

含义：

• 指向由 ContentProvider 或 FileProvider 暴露的文件内容。

• 用于在不同 app（或不同进程）之间共享文件，带权限控制。

• 通过 ContentResolver 访问：

  val input = context.contentResolver.openInputStream(uri)

优点：

• 可以共享（前提是权限授予正确）。
• 是 Android 官方推荐的跨进程文件共享方式。

但在小组件中：

❌ 桌面（Launcher）进程没有读取你 Provider 的权限，

即使是 content:// 路径也无法直接显示。

因此：

views.setImageViewUri(uri) // 仍然无效

正确做法：

val input = context.contentResolver.openInputStream(uri)
val bitmap = BitmapFactory.decodeStream(input)
views.setImageViewBitmap(R.id.widget_image, bitmap)

---

🧩 三、Bitmap（android.graphics.Bitmap@xxxx）

形式：

android.graphics.Bitmap@21271f3

含义：

• 是图片的内存对象，已经被解码成像素数据。
• 直接存在内存里，不依赖文件系统、URI、权限。
• 一旦你有了 Bitmap，就可以直接在任何进程中显示（因为是纯内存对象）。
• 一旦进程被杀（比如系统清理后台 / 重启 / 小组件被系统重建），这块内存自然就消失；

所以 相同路径的图片 每次重新加载都会生成一个新的 Bitmap 对象（不同的内存引用）。

在小组件中：

✅ views.setImageViewBitmap(R.id.imageView, bitmap) 是唯一通用可行的方式。

---

🧠 四、对比总结表

类型	例子	存储位置	是否跨进程可读	小组件可直接用？	是否需 decode？
file://	file:///data/.../xxx.png	应用私有目录	❌ 否	❌ 不可用	✅ 需 decode
content://	content://io.iftech...	ContentProvider	⚠️ 可能（取决于授权）	❌ 不可用（Launcher无权限）	✅ 需 decode
Bitmap	android.graphics.Bitmap@xxxx	内存中	✅ 可直接用	✅ 可用	❌ 已解码

---

🧱 五、在小组件中推荐的做法（总结）

1. 下载 → 缓存（file 或 content URI 都行）
2. 在 App 进程中用 BitmapFactory.decodeStream / decodeFile 解码成 Bitmap
3. 用 setImageViewBitmap() 更新 RemoteViews

示例：

val bitmap = BitmapFactory.decodeFile(localFilePath)
val views = RemoteViews(context.packageName, R.layout.widget_layout)
views.setImageViewBitmap(R.id.widget_image, bitmap)
appWidgetManager.updateAppWidget(appWidgetId, views)

---

💡 扩展理解：为什么 Glance 也必须用 Bitmap？

因为 Glance 其实底层仍然用的是 RemoteViews，它也无法访问 file:// 或 content://，

所以 Glance 的官方接口：

Image(provider = ImageProvider(bitmap))

实际上就是在内部调用了 setImageViewBitmap()。

---

✅ 结论

类型	优点	缺点	适合场景
file://	简单、直接	仅限 app 内使用	缓存图片、调试
content://	可授权跨进程	桌面 widget 无权限	分享图片给其他 app
Bitmap	无需权限、内存安全	需预先加载解码	✅ 小组件显示图像的唯一正确方式

---

🎯 最后

⚠️ 不能在 RN 端直接把 Bitmap 对象（或它的内存地址）传给小组件。

✅ 应该在 RN 端完成下载、压缩和缓存 。把 file:// xx 或者 /data/user/../xxx.png应用私有目录下的缓存文件地址 传给小组件。小组件再处理成 bitmap