SuperAPI AI 工具集

coil-compose

编程与开发

查看项目

更新于 10-17 16:17

技能介绍

用途

本技能用于指导在 Jetpack Compose 中实现图片加载。资料明确指出,Coil(Coroutines Image Loader)是 Compose 推荐的图片加载库,原因是其高效且集成顺畅。当需要从 URL 加载图片、处理图片状态或优化图片加载时,可参考本技能。

主要能力

技能围绕 Coil 在 Compose 中的三种用法展开:

  1. AsyncImage(首选可组合项):适用于大多数场景,自动处理尺寸解析,并支持标准 Image 参数。示例中展示了通过 ImageRequest.Builder 设置数据源、启用 crossfade,并配置 placeholder、error、contentDescription、contentScale 与 modifier。

  2. rememberAsyncImagePainter(低层控制):仅在需要 Painter 而非可组合项时使用,例如用于 Canvas 或 Icon,或需要手动观察加载状态时。资料特别警告:rememberAsyncImagePainter 不会检测图片在屏幕上加载的尺寸,默认始终以原始尺寸加载图片,因此除非确实需要 Painter,否则应使用 AsyncImage。示例中通过 .size(Size.ORIGINAL) 显式定义尺寸。

  3. SubcomposeAsyncImage(插槽 API):用于需要针对不同状态(Loading、Success、Error)提供自定义插槽 API 的场景。资料提醒:子组合(Subcomposition)比常规组合慢,应避免在 LazyColumn 或 LazyRow 等性能关键区域使用 SubcomposeAsyncImage。示例中展示了 loading 与 error 插槽的写法。

使用方式

技能以代码示例形式给出具体用法,包括 AsyncImage、rememberAsyncImagePainter 与 SubcomposeAsyncImage 的调用方式,以及 ImageRequest.Builder 的配置方法。同时提供性能与最佳实践建议:

  • 单例 ImageLoader:整个应用使用单个 ImageLoader 实例,以共享磁盘与内存缓存。
  • 主线程安全:Coil 自动在后台线程执行图片请求。
  • Crossfade:始终在 ImageRequest 中启用 crossfade(true),使占位图到成功加载的过渡更平滑。
  • 尺寸:确保合理设置 contentScale,避免加载超出必要尺寸的图片。

适用场景

适用于在 Jetpack Compose 中从 URL 加载图片、处理图片加载状态、优化图片加载性能等任务。

限制

资料未提供关于收费、价格、平台支持范围、具体性能数据或效果保证的信息。资料中提到的注意事项包括:rememberAsyncImagePainter 默认按原始尺寸加载图片;SubcomposeAsyncImage 因使用子组合而较慢,不宜用于 LazyColumn 或 LazyRow 等性能关键区域。

实现检查清单

资料给出的检查清单包括:优先使用 AsyncImage 而非其他变体;始终提供有意义的 contentDescription,装饰性图片则设为 null;使用 crossfade(true) 改善用户体验;避免在列表中使用 SubcomposeAsyncImage;针对特定需求(如 CircleCropTransformation 等变换)配置 ImageRequest。