ImageLoader 是执行请求的服务类。 他们处理缓存,数据获取,图像解码,请求管理,bitmap pool,内存管理等。 可以使用 builder 来创建和配置新实例:
val imageLoader = ImageLoader.Builder(context)
.availableMemoryPercentage(0.25)
.crossfade(true)
.build()
imageView.load 使用单例 ImageLoader 执行 LoadRequest 。 可以使用以下方式访问单例 ImageLoader:
val imageLoader = Coil.imageLoader(context)
(可选)您可以创建自己的ImageLoader实例,并通过依赖项注入将它们注入:
val imageLoader = ImageLoader(context)
当您创建单个 ImageLoader 并在整个应用程序中共享时,Coil 的性能最佳。 这是因为每个 ImageLoader 都有自己的内存缓存,bitmap pool 和网络监听
Requests¶有两种 Request 类型
LoadRequest 是一个生命周期范围的 request,支持 Target,Transition 等等GetRequest 挂起并返回 RequestResult
如果要加载到自定义 target 中,可以执行 LoadRequest
val request = LoadRequest.Builder(context)
.data(“https://www.example.com/image.jpg”)
.target { drawable ->
// Handle the result.
}
.build()
imageLoader.execute(request)
要强制获取图像,请执行GetRequest:
val request = GetRequest.Builder(context)
.data(“https://www.example.com/image.jpg”)
.build()
val drawable = imageLoader.execute(request).drawable
如果您使用的是 io.coil-kt:coil ,您可以使用以下任意方式设置 ImageLoader 的实例
在 Application 中实现 ImageLoaderFactory(推荐)
class MyApplication : Application(), ImageLoaderFactory {
override fun newImageLoader(): ImageLoader {
return ImageLoader.Builder(context)
.crossfade(true)
.okHttpClient {
OkHttpClient.Builder()
.cache(CoilUtils.createDefaultCache(context))
.build()
}
.build()
}
}
调用 Coil.setImageLoader
val imageLoader = ImageLoader.Builder(context)
.crossfade(true)
.okHttpClient {
OkHttpClient.Builder()
.cache(CoilUtils.createDefaultCache(context))
.build()
}
.build()
Coil.setImageLoader(imageLoader)
默认的 ImageLoader 可以通过这样取回
val imageLoader = Coil.imageLoader(context)
设置默认的 ImageLoader 是可选的。 如果未设置,则 Coil 会延迟创建具有默认值的 ImageLoader
如果您使用的是 io.coil-kt:coil-base,您应创建自己的 ImageLoader 实例并通过依赖注入将它注入到 app 中
支持的数据类型注意:如果设置自定义OkHttpClient,则必须设置缓存实现,否则ImageLoader将没有磁盘缓存。 可以使用CoilUtils.createDefaultCache 创建默认的 Coil 缓存实例
ImageLoader 支持的数据类型为
String (mapped to a Uri)HttpUrlUri (android.resource, content, file, http, and https schemes only)File@DrawableRes IntDrawableBitmap 预加载
如果要预加载到内存中,执行一个不带 target 的 LoadRequest
val request = LoadRequest.Builder(context)
.data(“https://www.example.com/image.jpg”)
// 可选的,但是设置 ViewSizeResolver 可以通过限制预加载的大小来节省内存
.size(ViewSizeResolver(imageView))
.build()
imageLoader.execute(request)
如果只想将网络图片预加载到磁盘中,可以为 request 关闭内存缓存
val request = LoadRequest.Builder(context)
.data(“https://www.example.com/image.jpg”)
.memoryCachePolicy(CachePolicy.DISABLED)
.build()
imageLoader.execute(request)
LoadRequest 会自动取消在以下几种情况下
关联的 view detached,
关联的 lifecycle destroyed
另一个 request 在相同的 view 中开启
此外,每个 LoadRequest 返回一个 RequestDisposable,可用于检查请求是否在运行中或处理该请求(有效地取消请求并释放其关联资源)
val disposable = imageView.load(“https://www.example.com/image.jpg”)
// Cancel the request.
disposable.dispose()
GetRequest 仅当协程的上下文被取消时才会取消
图片采样假设磁盘上有一个 500x500 的映像,但是只需要以 100x100 的大小将其加载到内存中即可在视图中显示。 Coil 会将图像加载到内存中,但是如果您需要 500x500 的图像会怎样呢? 从磁盘读取还有更好的「质量」,但是图像已经以 100x100 加载到内存中。 理想情况下,当我们从磁盘以 500x500 读取图像时,我们将使用 100x100 图像作为占位符。
这正是 Coil 所做的,并且 Coil 自动为所有 BitmapDrawables 处理此过程。 与 crossfade(true) 搭配使用时,可以创建视觉效果,使图像细节看起来像淡入淡出,类似于渐进式 JPEG
使用要求AndroidXMin SDK 14+Compile SDK: 29+Java 8+
详细内容移步 官方文档
关于我
我是 Flywith24,我的博客内容已经分类整理 在这里,点击右上角的 Watch 可以及时获取我的文章更新哦
掘金小专栏GithubCompile SDK: 29+Java 8+
详细内容移步 官方文档
关于我
我是 Flywith24,我的博客内容已经分类整理 在这里,点击右上角的 Watch 可以及时获取我的文章更新哦
掘金小专栏Github
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)