SuperAPI AI 工具集

android-coil-compose

设计与创作

查看项目

更新于 10-15 23:47

技能介绍

用途:当任务涉及 Coil 与 Jetpack Compose 的图片加载、AsyncImage、rememberAsyncImagePainter 时使用本技能,目标是在 Compose 中实现带尺寸控制与无障碍语义的图片加载。

主要能力:区分简单图片界面、底层 painter 访问与自定义插槽式加载状态三种需求;优先使用 AsyncImage,仅在组件确实需要时下探到 painter API;约束尺寸、占位符与 contentDescription,兼顾性能与无障碍;检查列表渲染、状态抖动与视觉回退。

使用方式:先判断 UI 需要哪种图片表面,再选择 API;painter API 需显式提供 size resolver;远程加载需确认存在对应 Coil 网络模块。参考 references/patterns.md 获取 AsyncImage、painter 与 subcomposition 的决策指南,references/scenarios.md 获取列表性能与截图稳定验证路径。示例命令:bash skills/android-coil-compose/scripts/run_examples.sh;cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest;cd examples/orbittasks-compose && ./gradlew verifyRoborazziDebug。

适用场景:Compose 图片加载、占位符与错误状态、列表图片性能、截图稳定验证。

限制与注意:避免把全尺寸远程资源加载进小列表项;不要到处使用 SubcomposeAsyncImage;图片加载失败不应静默无回退;可操作或有信息量的图片不能遗漏无障碍语义;rememberAsyncImagePainter 不会自行推断屏幕尺寸。范围扩大时可交接给 android-compose-foundations 或 android-compose-performance。官方参考见 Coil Compose、Image Requests、Network 及 Android 图片加载与无障碍文档。