zoukankan      html  css  js  c++  java

  • 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();
    6. // Create global configuration and initialize ImageLoader with this config
    7. ImageLoaderConfiguration config =newImageLoaderConfiguration.Builder(this)
    8. ...
    9. .build();
    10. ImageLoader.getInstance().init(config);
    11. ...
    12. }
    13. }
    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总是保持着图片的纵横比。
  • 相关阅读:
    Head First设计模式(观察者模式Observer)
    Head First设计模式(装饰者模式)
    Head First设计模式
    Head First设计模式 单件模式 独一无二的对象
    .NET 设计规范.NET约定、惯用法与模式8.使用规范
    .NET 设计规范.NET约定、惯用法与模式附录：C#编程风格约定
    设计模式 一 引言
    .NET 设计规范.NET约定、惯用法与模式7.异常
    Head First设计模式 工厂模式 烘烤OO的精华
    前端IDE中Emmet插件快捷输入HTML代码
  • 原文地址：https://www.cnblogs.com/leestar54/p/4105726.html
Copyright © 2011-2022 走看看