前言

Android平台上有很多优秀的图片加载框架,比如Glide,Picasso,Fresco

而Compose-jetpack上的图片加载框架有Coil

但Compose-jb上却暂时没有图片加载框架,正好我有用Compose-jb写一些小工具,有图片加载的需求,于是就仿照Android平台的图片加载库写了一个具有简单功能的图片加载库

项目已开源,地址: load-the-image (github.com) 欢迎star

示例:

功能

1.简单的支持多个桌面平台的图片加载(部分格式异步加载)

2.支持多种格式:网络链接,本地文件,资源路径,InputStream,Bitmap,Image,ByteArray等,且支持自定义支持的格式

3.支持双重缓存:内存缓存和本地缓存,内存缓存支持配置最大内存,本地缓存支持配置缓存路径或自定义缓存配置

正文

使用方式

首先我们使用Compose展示图片一般都使用Image函数,其中一个函数的第一个入参是Painter类型,而我们的api就是返回一个Painter类型的对象,所以使用方式很简单,如下代码所示:

//url="https://img.zcool.cn/community/017e625e57415ea801216518c25819.jpg@1280w_1l_2o_100sh.jpg"
Image(rememberImagePainter(url), "")

对的,使用就是这么简单,当然使用该项目需要你引用一下远程依赖

基础配置

我就默认Compose-jb都是使用gradle+kts配置的了emmm

1. 在你根目录下的build.gradle.kts中添加:

buildscript {repositories {maven("https://jitpack.io")//this...}
}allprojects {repositories {maven("https://jitpack.io")//this...}
}

2.在你的Compose-jb项目的代码目录(一般是desktop)下的build.gradle.kts中添加:

kotlin {sourceSets {val jvmMain by getting {dependencies {...implementation("com.github.ltttttttttttt:load-the-image:1.0.6")//this}}}
}

ps:最新版本参考:Github 或 JitPack

3.推荐:统一配置一下加载失败时展示的失败图路径:

fun main() {LoadTheImageManager.defaultErrorImagePath = "drawable-xxhdpi/load_error.jpeg"//thisapplication {Window(onCloseRequest = ::exitApplication) {MaterialTheme {Image(rememberImagePainter("https://img.zcool.cn/community/017e625e57415ea801216518c25819.jpg@1280w_1l_2o_100sh.jpg"),"")}}}
}

ps: 资源位置大概这样,当然你可以自定义资源放的位置(可以查看github上的代码):

4.推荐:将compose-jb(desktop)的版本提升至1.1.1或以上

根据反馈,发现1.1.0版本compose-jb有bug,会启动不了

自定义配置

1.配置图片加载时的占位图和加载失败的图片

首先统一配置加载失败的图片已经在上面第三点写过了

单独配置,String格式的rememberImagePainter方法中有个placeholderResource参数表示占位图:

使用如下:

rememberImagePainter(url,占位图)

如果想单独配置占位图和加载失败图和更多其他参数时,可以使用DataToBeLoaded类型的参数,使用如下所示:

rememberImagePainter(DataToBeLoaded(url).apply {placeholderResource = 占位图errorImagePath = 加载失败图})

2.修改内存缓存大小:

LoadTheImageManager.memoryCache = ImageLruMemoryCache(99999/*最大的字节大小*/)

默认内存缓存大小为:maxOf(50M,总内存的1%)

默认内存缓存策略使用LRU,如果想改成别的策略,可以自定义一个类,然后实现ImageCache接口,实现相应方法,然后修改一下即可:

LoadTheImageManager.memoryCache = 你的实现类

3.修改文件缓存位置:

LoadTheImageManager.fileCache = ImageFileCache(File("C://test_dir"))

默认文件缓存位置为:此电脑->图片->LoadTheImageCache

默认缓存使用md5做为文件名,如果想自定义策略或文件缓存方式,可以自定义一个类,然后实现ImageCache接口,实现相应方法,然后修改一下即可:

LoadTheImageManager.fileCache = 你的实现类

4.修改网络图片加载使用的网络引擎:

默认网络引擎使用的是jvm自带的HttpURLConnection,如果想改成别的网络,可以自定义一个类,然后实现HttpLoader接口,实现相应方法,然后修改一下即可:

LoadTheImageManager.httpLoader = 你的实现类

5.图片加载的rememberImagePainter函数支持多种格式输入,且可以自定义

除了这些定义好的格式,你也可以自定义自己的格式支持和解析:

首先自定义一个类实现LoadTheImage接口,在canLoad函数中判断自身是否支持此数据,然后进行加载即可,比如以下的支持加载字节数组:

然后在配置一下:

LoadTheImageManager.loadTheImage.add(ByteArrayLoadTheImage())//当然目前此库已经支持字节数组了,不需要手动添加ByteArrayLoadTheImage

最后可以这样使用:

rememberImagePainter(DataToBeLoaded(byteArrayOf()))//最好还是自己封装一下函数

多平台配置

一般使用Compose-jb的时候,可能会一起开发多平台项目(KMM),比如Android平台和Web平台,我们也可以适配一下做成多平台的图片加载代码

desktop端使用本库load-the-image,Android端使用Coil

配置

首先在基础配置的基础上,先在你的common文件夹中的build.gradle.kts中添加:

val desktopMain by getting{dependencies {...implementation 'com.github.ltttttttttttt:load-the-image:1.0.2'}
}

commonMain中添加一个多平台函数:

@Composable
expect fun rememberImagePainter(url: String): Painter

androidMain中实现实现该函数(和其他平台(如果有)),使用Coil:

@Composable
actual fun rememberImagePainter(url: String): Painter =coil.compose.rememberImagePainter(data = url)

desktopMain中实现实现该函数:

@Composable
actual fun rememberImagePainter(url: String): Painter =com.lt.load_the_image.rememberImagePainter(url)

然后在desktop平台中或共享代码平台中都可以使用这个定义的函数了

如果配置不成功也可以直接看我的github上如何配置的

项目已开源,地址: load-the-image (github.com) 欢迎star

end

Compose-jb图片加载库load-the-image,适用于KMM Compose desktop桌面端(Windows,Linux,MacOs)相关推荐

Android开源框架——图片加载库Glide
Glide是有google开发的图片加载库,支持图片加载与处理,包括动态图片的加载,以及视频的解码. 开源地址:https://github.com/bumptech/glide build.grad ...
android 图片加载库 Glide 的使用介绍
一:简介在泰国举行的谷歌开发者论坛上,谷歌为我们介绍了一个名叫 Glide 的图片加载库,作者是bumptech.这个库被广泛的运用在google的开源项目中,包括2014年google I/O大会 ...
Coil - Google推荐的协程图片加载库
随着Kotlin的转正,Glide不再是最佳选择.看一下Google极力推荐的Coil框架. GitHub:Coilhttps://coil-kt.github.io/coil/ Pangu-Immo ...
android图片加载库Glide
什么是Glide? Glide是一个加载图片的库,作者是bumptech,它是在泰国举行的google 开发者论坛上google为我们介绍的,这个库被广泛的运用在google的开源项目中. Glide ...
y-image: web端图片加载库
y-image web端图片加载库 - 根据不同状态(加载中,成功, 失败),加载不同图片效果安装 1. CDN引入 <script src="https://cdn.jsdeli ...
Android图片加载库：最全面解析Glide用法
目录 1. 简介介绍:Glide,是Android中一个图片加载开源库 Google的开源项目主要作用:实现图片加载 2. 功能特点 2.1 功能列表从上面可以看出,Glide不仅实现了图片异步 ...
谷歌推荐的Android图片加载库（Glide）介绍
本文出自:http://blog.csdn.net/u011733020 原文:https://inthecheesefactory.com/blog/get-to-know-glide- ...
Android图片加载库的封装实战
重磅更新 2017-02-16 2017-05-09 优化圆形图片加载更新demo 前言主流图片加载库的对比 Android-Universal-Image-Loader Picasso Glid ...
Android图片加载库—Picasso一个强大的图像下载和缓存库
介绍 GitHub源码点击查看 Picasso是一款强大的图片下载和缓存开源软件,只能在Android平台上使用,由Square开发.使用Picasso可以添加一些必须的特性和视觉效果到Androi ...

Compose-jb图片加载库load-the-image,适用于KMM Compose desktop桌面端(Windows,Linux,MacOs)

前言

正文

使用方式

基础配置

自定义配置

多平台配置

Compose-jb图片加载库load-the-image,适用于KMM Compose desktop桌面端(Windows,Linux,MacOs)相关推荐

最新文章

热门文章