Universal-Image-Loader是一款开源工具,我是刚开始做android,我不知道这款工具是怎么实现的,我只是知道他能干什么,我是怎么用他来干我的事的,嘿嘿,就像铁锤一样,我不用知道他是从什么厂子加工出来的,我知道他能给我砸开核桃就行了,经此而已。
1、首先想使用他的话,首先下载这个工具jar包,导入自己的工程:下载地址(这里的版本是1.9.0,如果想下载更高版本请在此下载)
2、导入以后,你会在你的工程里看到如下图片,则证明你导入成功了。并将它设置为最先编译的工程包,如下下图
3、由于是使用过程中会图片获取要通过网络,并且有缓存设置,所以这3个权限必须要有,所以在创建完工程后,先加上再说。
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
4、接下来,配置ImageLoaderConfiguration这个类,并实现全局ImageLoader的初始化。以下的配置看个人需求进行选择,不是所有都要进行配置。
ImageLoaderConfiguration config = new ImageLoaderConfiguration
.Builder(context)
.memoryCacheExtraOptions(480, 800) // max width, max height,即保存的每个缓存文件的最大长宽
.discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null) // Can slow ImageLoader, use it carefully (Better don't use it)/设置缓存的详细信息,最好不要设置这个
.threadPoolSize(3)//线程池内加载的数量
.threadPriority(Thread.NORM_PRIORITY - 2) // 设置线程的优先级
.denyCacheImageMultipleSizesInMemory() // 当同一个Uri获取不同大小的图片,缓存到内存时,只缓存一个。默认会缓存多个不同的大小的相同图片
.memoryCache(new UsingFreqLimitedMemoryCache(5 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通过自己的内存缓存实现
.memoryCacheSize(5 * 1024 * 1024)
.discCacheSize(50 * 1024 * 1024)
.discCacheFileNameGenerator(new Md5FileNameGenerator())//将保存的时候的URI名称用MD5 加密
.tasksProcessingOrder(QueueProcessingType.LIFO) // 设置图片下载和显示的工作队列排序
.discCacheFileCount(100) //缓存的文件数量
.discCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径
.defaultDisplayImageOptions(DisplayImageOptions.createSimple())
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间设置,链接和无响应
.build();//开始构建
ImageLoader.getInstance().init(config);//全局初始化此配置
注:ImageLoaderConfiguration 配置中的.discCacheFileNameGenerator()方法是将缓存下来的文件以什么方式命名里面可以调用的方法有 :
1.new Md5FileNameGenerator() //使用MD5对UIL进行加密命名
2.new HashCodeFileNameGenerator() //使用HASHCODE对UIL进行加密命名
5、此条是对于4来说的,实现ImageLoader的全局配置,最好将以上代码写在程序的入口中例如自己写一个类,继承Application:
public class App extends Application {
private static Context context;
@Override
public void onCreate() {
super.onCreate();
context = getApplicationContext();// 初始化上下文
// 设置缓存的目录
File cacheDir = StorageUtils.getOwnCacheDirectory(
getApplicationContext(), "AppName/Cache");
//以上代码copy过来
}
}
然后在AndroidManifest.xml中 <application> 标签下,添加 android:name="com.example.download.App",这样来设置整个程序的入口。顺便说一下,这里经常要设置的是设置缓存的目录,设置方法代码上有,这里不再多说。
6、完成上述步骤才能使用这个工具,虽然有点繁琐,但是这样才能正确的使用铁锤,要不容易砸到自己的手啊。。。
接下来对ImageLoader进行设置,使用ImageLoader进行图片加载的时候,先要实例化ImageLoader,调用以下方法进行实例化,在每个布局里面都要实例化后再使用。
protected ImageLoader imageLoader = ImageLoader.getInstance();
之后进行显示的图片的各种格式DisplayImageOptions 的设置:
DisplayImageOptions options;
options = new DisplayImageOptions.Builder().showImageOnFail(R.drawable.ic_launcher) // 设置图片在下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_launcher)// 设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_launcher) // 设置图片加载/解码过程中错误时候显示的图片
.cacheInMemory(true)// 设置下载的图片是否缓存在内存中
.cacheOnDisc(true)// 设置下载的图片是否缓存在SD卡中
.considerExifParams(true) // 是否考虑JPEG图像EXIF参数(旋转,翻转)
.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)// 设置图片以如何的编码方式显示
.bitmapConfig(Bitmap.Config.RGB_565)// 设置图片的解码类型//
.delayBeforeLoading(100)// int delayInMillis为你设置的下载前的延迟时间
.resetViewBeforeLoading(true)// 设置图片在下载前是否重置,复位
.displayer(new RoundedBitmapDisplayer(20))// 是否设置为圆角,弧度为多少
.displayer(new FadeInBitmapDisplayer(100))// 是否图片加载好后渐入的动画时间
.build();// 构建完成
按照你所需要的配置去设置,如果不需要的就可以不做配置。
注:以上配置中的:
imageScaleType(ImageScaleType imageScaleType)//是设置图片的缩放方式
缩放类型mageScaleType:
EXACTLY :图像将完全按比例缩小的目标大小
EXACTLY_STRETCHED:图片会缩放到目标大小完全
IN_SAMPLE_INT:图像将被二次采样的整数倍
IN_SAMPLE_POWER_OF_2:图片将降低2倍,直到下一减少步骤,使图像更小的目标大小
NONE:图片不会调整
displayer(BitmapDisplayer displayer)//是设置图片的显示方式
显示方式displayer:
RoundedBitmapDisplayer(int roundPixels)设置圆角图片
FakeBitmapDisplayer()这个类什么都没做
FadeInBitmapDisplayer(int durationMillis)设置图片渐显的时间
SimpleBitmapDisplayer()正常显示一张图片
7、核桃仁终于要出来了啊,哈哈,按照自己的需求调用方法,来显示图片。
(1)纯粹为了加载默认配置的一个图片的
方法:
public void displayImage(String uri, ImageView imageView){ }
具体实现:
ImageLoader.getInstance().displayImage(imageUrl, imageView); // imageUrl代表图片的URL地址,imageView代表承载图片的IMAGEVIEW控件
(2)加载自定义配置的一个图片的
方法:
public void displayImage(String uri, ImageView imageView, DisplayImageOptions options){ }
具体实现:
ImageLoader.getInstance().displayImage(imageUrl, imageView,options); // imageUrl代表图片的URL地址,imageView代表承载图片的IMAGEVIEW控件,options代表DisplayImageOptions配置文件
当然还有其他的方法可以使用,我只用了这两个就已经满足我了,要是大家还有其他的,可以分享出来,谢谢啦。还有就是URL地址问题,可以是网上的,本地的,sd卡上的等等等等,下面是例子:
String imageUri = "http://site.com/image.png"; // from Web
String imageUri = "file:///mnt/sdcard/image.png"; // from SD card
String imageUri = "content://media/external/audio/albumart/13"; // from content provider
String imageUri = "assets://image.png"; // from assets
String imageUri = "drawable://" + R.drawable.image; // from drawables (only images, non-9patch)
近来发现一个问题,就是不同版本的jar包,用到的配置方法其实不一样,所以本文只适合1.9.0的版本。