Android开源库--Universal Image Loader通用图片加载器

如果说我比别人看得更远些,那是因为我站在了巨人的肩上。

 
github地址:https://github.com/nostra13/Android-Universal-Image-Loader
 

介绍:

UIL致力于提供一个强大、灵活、高度可定制化工具来加载、缓存以及显示图片。它提供了许多配置选项和图像加载、缓存过程中的控制。
UIL task flow diagram
↑工作流程图
 

特点:

1、多线程图片加载(同步或者异步)
2、大部分可定制的配置(线程执行,下载器,解码器,内存或磁盘缓存,显示图片选项等等)
3、每个图片显示的调用都可以使用不同的配置。
4、将图片缓存再内存或磁盘(设备文件系统或SD卡
5、监听加载过程(包括下载过程)
需要Android2.0+的支持。
 

设置:

1、下载官方JAR
2、将JAR文件放到项目的lib文件夹即可。
3、添加用户权限
网络权限,外部存储写权限
  1. <manifest>
  2. <!-- Include following permission if you load images from Internet -->
  3. <uses-permissionandroid:name="android.permission.INTERNET"/>
  4. <!-- Include following permission if you want to cache images on SD card -->
  5. <uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
  6. ...
  7. </manifest>
4、在第一次使用之前初始化图片加载器(一般我们写在Application的onCrate里)
  1. publicclassMyActivityextendsActivity{
  2. @Override
  3. publicvoid onCreate(){
  4. super.onCreate();
  5. // Create global configuration and initialize ImageLoader with this config
  6. ImageLoaderConfiguration config =newImageLoaderConfiguration.Builder(this)
  7. ...
  8. .build();
  9. ImageLoader.getInstance().init(config);
  10. ...
  11. }
  12. }
5、配置与现实选项的区别
  • ImageLoader Configuration (ImageLoaderConfiguration) 对应用来说是全局的.
  • Display Options (DisplayImageOptions) 对每一个显示作业都是本地的 (ImageLoader.displayImage(...)).
Configuration
  1. // DON'T COPY THIS CODE TO YOUR PROJECT! This is just example of ALL options using.
  2. // See the sample project how to use ImageLoader correctly.
  3. File cacheDir =StorageUtils.getCacheDirectory(context);
  4. ImageLoaderConfiguration config =newImageLoaderConfiguration.Builder(context)
  5. .memoryCacheExtraOptions(480,800)// 默认 = 设备屏幕大小
  6. .diskCacheExtraOptions(480,800,null)
  7. .taskExecutor(...)
  8. .taskExecutorForCachedImages(...)
  9. .threadPoolSize(3)// default
  10. .threadPriority(Thread.NORM_PRIORITY -2)// default
  11. .tasksProcessingOrder(QueueProcessingType.FIFO)// default
  12. .denyCacheImageMultipleSizesInMemory()
  13. .memoryCache(newLruMemoryCache(2*1024*1024))
  14. .memoryCacheSize(2*1024*1024)
  15. .memoryCacheSizePercentage(13)// default
  16. .diskCache(newUnlimitedDiscCache(cacheDir))// default
  17. .diskCacheSize(50*1024*1024)
  18. .diskCacheFileCount(100)
  19. .diskCacheFileNameGenerator(newHashCodeFileNameGenerator())// default
  20. .imageDownloader(newBaseImageDownloader(context))// default
  21. .imageDecoder(newBaseImageDecoder())// default
  22. .defaultDisplayImageOptions(DisplayImageOptions.createSimple())// default
  23. .writeDebugLogs()
  24. .build();
Display Options
注意:如果现实图片的时候没有传入该参数,则将默认使用Configuration(ImageLoaderConfiguration.defaultDisplayImageOptions(...))的配置。
  1. // DON'T COPY THIS CODE TO YOUR PROJECT! This is just example of ALL options using.
  2. // See the sample project how to use ImageLoader correctly.
  3. DisplayImageOptions options =newDisplayImageOptions.Builder()
  4. .showImageOnLoading(R.drawable.ic_stub)// resource or drawable
  5. .showImageForEmptyUri(R.drawable.ic_empty)// resource or drawable
  6. .showImageOnFail(R.drawable.ic_error)// resource or drawable
  7. .resetViewBeforeLoading(false)// default
  8. .delayBeforeLoading(1000)
  9. .cacheInMemory(false)// default
  10. .cacheOnDisk(false)// default
  11. .preProcessor(...)
  12. .postProcessor(...)
  13. .extraForDownloader(...)
  14. .considerExifParams(false)// default
  15. .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)// default
  16. .bitmapConfig(Bitmap.Config.ARGB_8888)// default
  17. .decodingOptions(...)
  18. .displayer(newSimpleBitmapDisplayer())// default
  19. .handler(newHandler())// default
  20. .build();
 

使用:

允许加载的URLs示例
"http://site.com/image.png" // 从网络读取
"file:///mnt/sdcard/image.png" // 从sd卡读取
"file:///mnt/sdcard/video.mp4" // 从sd卡读取(视频缩略图)
"content://media/external/images/media/13" // 从内容供应者加载
"content://media/external/video/media/13" // 从内容供应者加载(视频缩略图)
"assets://image.png" // 从assets(资产读取)
"drawable://" + R.drawable.img //从绘图读取(不包括.9.png)
 

示例:

  1. //加载图片,解码成bitmap并且在ImageView显示(或者任何实现了ImageAware接口的View)
    imageLoader.displayImage(imageUri, imageView);
    // 加载图片,解码成bitmap并且以回调的形式返回bitmap
    imageLoader.loadImage(imageUri,newSimpleImageLoadingListener(){
    @Override
    publicvoid onLoadingComplete(String imageUri,View view,Bitmap loadedImage){
    // Do whatever you want with Bitmap
    }
    });
    // 加载图片,解码成bitmap并且同步返回bitmap
    Bitmap bmp = imageLoader.loadImageSync(imageUri);
    完整的
    // Load image, decode it to Bitmap and display Bitmap in ImageView (or any other view
    // which implements ImageAware interface)
    imageLoader.displayImage(imageUri, imageView, options,newImageLoadingListener(){
    @Override
    publicvoid onLoadingStarted(String imageUri,View view){
    ...
    }
    @Override
    publicvoid onLoadingFailed(String imageUri,View view,FailReason failReason){
    ...
    }
    @Override
    publicvoid onLoadingComplete(String imageUri,View view,Bitmap loadedImage){
    ...
    }
    @Override
    publicvoid onLoadingCancelled(String imageUri,View view){
    ...
    }
    },newImageLoadingProgressListener(){
    @Override
    publicvoid onProgressUpdate(String imageUri,View view,int current,int total){
    ...
    }
    });
    // Load image, decode it to Bitmap and return Bitmap to callback
    ImageSize targetSize =newImageSize(80,50);// 返回的图片将以被调整成该大小
    imageLoader.loadImage(imageUri, targetSize, options,newSimpleImageLoadingListener(){
    @Override
    publicvoid onLoadingComplete(String imageUri,View view,Bitmap loadedImage){
    // Do whatever you want with Bitmap
    }
    });
    // Load image, decode it to Bitmap and return Bitmap synchronously
    ImageSize targetSize =newImageSize(80,50);// result Bitmap will be fit to this size
    Bitmap bmp = imageLoader.loadImageSync(imageUri, targetSize, options);

     

 
 

注意:

1、建议直接使用ImageView.SetImageResource()来替代使用ImageLoader
 
2、缓存默认是不打开的,如果你要打开缓存,则需要在代码中声明
  1. // Create default options which will be used for every
  2. // displayImage(...) call if no options will be passed to this method
  3. DisplayImageOptions defaultOptions =newDisplayImageOptions.Builder()
  4. ...
  5. .cacheInMemory(true)
  6. .cacheOnDisk(true)
  7. ...
  8. .build();
  9. ImageLoaderConfiguration config =newImageLoaderConfiguration.Builder(getApplicationContext())
  10. ...
  11. .defaultDisplayImageOptions(defaultOptions)
  12. ...
  13. .build();
  14. ImageLoader.getInstance().init(config);// Do it on Application start
  15. // Then later, when you want to display image
  16. ImageLoader.getInstance().displayImage(imageUrl, imageView);// Default options will be used
或者这样
  1. DisplayImageOptions options =newDisplayImageOptions.Builder()
  2. ...
  3. .cacheInMemory(true)
  4. .cacheOnDisk(true)
  5. ...
  6. .build();
  7. ImageLoader.getInstance().displayImage(imageUrl, imageView, options);// Incoming options will be used
3、如果你开启了磁盘缓存,UIL尝试将图片缓存到外部存储(/sdcard/Android/data/[package_name]/cache).如果外部存储不存在,则会缓存到设备文件系统,记得要声明用户权限哟
 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18" />
4、UIL如何声明精确的ImageView所需的bitmap的大小?它将搜索以下参数
  • 获取ImageView实际测量的width和height。
  • 获取android:layout_width 和android:layout_height 参数。
  • 获取android:maxWidth 和/或 android:maxHeight 参数。
  • 从configuration (memoryCacheExtraOptions(int, int) option)获取最大的width 和/或 height 参数。
  • 获取设备屏幕的width和/或height
所以,如果你知道大概ImageView的大概最大尺寸,就尝试为其设置android:layout_width|android:layout_height 或android:maxWidth|android:maxHeight 参数。
 
5、如果你在使用UIL过程中经常报错OutOfMemoryError(内存溢出),尝试如下方法
  • 禁止内存缓存,如果依然OOM,那么检查你的APP是否存在内存泄露,使用MemoryAnalyzer检测一下。
  • 在configuration配置中减少线程池大小(.threadPoolSize(...)). 建议在1 - 5 之间。
  • 在display options中使用.bitmapConfig(Bitmap.Config.RGB_565)。Bitmaps在RGB_565下比ARGB_8888消耗少2被的内存。
  • 使用.imageScaleType(ImageScaleType.EXACTLY)
  • 在configuration配置中使用.diskCacheExtraOptions(480, 320, null)。
6、为了使用Cache内存缓存配置,(ImageLoaderConfiguration.memoryCache(...)),你可以直接使用已经实现的类。
  • 仅使用强引用的Cache缓存:
    • LruMemoryCache (当超过缓存大小时,删除最近最少使用的bitmap) - 默认使用
  • 使用弱和强引用的缓存:
    • UsingFreqLimitedMemoryCache (当超过缓存大小时,删除最不经常使用的bitmap)
    • LRULimitedMemoryCache (当超过缓存大小时,删除最近最少使用的bitmap)
    • FIFOLimitedMemoryCache (当超过缓存大小时,最先缓存的bitmap先删除。)
    • LargestLimitedMemoryCache (当超过缓存大小时,最大的Bitmap先删除。)
    • LimitedAgeMemoryCache (通过装饰,超过设置时限的bitmap将被删除)
  • 仅使用弱引用的缓存:
    • WeakMemoryCache (无限制缓存)
7、为了使用disk 磁盘缓存配置 (ImageLoaderConfiguration.diskCache(...)),你可以直接使用已经实现的类。
  • UnlimitedDiscCache (最快的缓存, 没有限制缓存大小) - 默认使用。
  • LruDiskCache (通过文件数量和最大缓存大小来限制缓存. 如果超过了限制,将会删除最近最少使用的文件)
  • LimitedAgeDiscCache (没有大小限制,但有时间限制的缓存. 如果时间超过了设定值,文件将被删除)
提示:UnlimitedDiscCache真的要你其他的实现要快的多哟!
 
8、你可以通过使用以实现的类来显示bitmap,(DisplayImageOptions.displayer(...))
  • RoundedBitmapDisplayer (显示带有圆角的图片)
  • FadeInBitmapDisplayer (显示带有淡入动画的图片)
 
9、为了避免list(grid..)滑动延迟,你可以使用PauseOnScrollListener
  1. boolean pauseOnScroll =false;// or true
  2. boolean pauseOnFling =true;// or false
  3. PauseOnScrollListener listener =newPauseOnScrollListener(imageLoader, pauseOnScroll, pauseOnFling);
  4. listView.setOnScrollListener(listener);
10、如果你在image Url的尾部看到了一些奇怪的填充(例如http://anysite.com/images/image.png_230x460),那么这代表该Url不是一个request请求。而仅仅是"URL + 目标大小",这也是bitmap在内存缓存中的键,尾部的 (_230x460)不是用于请求的。
 
11、ImageLoader总是保持着图片的纵横比。





我不怕千万人阻挡,只怕自己投降。
posted @ 2014-11-18 14:37  leestar54  阅读(1222)  评论(0编辑  收藏  举报