Android图片异步加载框架Android-Universal-Image-Loader

时间:2021-08-10 18:08:52
Android-Universal-Image-Loader是一个图片异步加载,缓存和显示的框架。这个框架已经被很多开发者所使用,是最常用的几个Android开源项目之一,主流的应用,随便反编译几个,都可以见到它的身影。淘宝,天猫,Facebook,京东商城等都用到了这个项目。
该项目的Github地址链接: https://github.com/nostra13/Android-Universal-Image-Loader

运行流程:
每一个图片的加载和显示任务都运行在独立的线程中,除非这个图片缓存在内存中,这种情况下图片会立即显示。如果需要的图片缓存在本地,它会开启一个独立的线程队列。如果在缓存中没有正确的图片,任务线程会从网络中获取。
Android图片异步加载框架Android-Universal-Image-Loader
使用步骤:
1、加载图片之前,先要做初始化配置,这个类似很多游戏引擎使用前要做一下初始化,其实只做了一件事,实例化一个全局的ImageLoader对象,同时传入图片加载缓存的配置,ImageLoaderConfiguration封装了基本的配置信息,比如加载图片事用的线程池大小,线程的优先级,内存缓存大小,是否支持同一图片的多尺寸缓存(默认是支持的,可以手动关闭),还有缓存的命名规则等等。

2、配置完后,就可以开始使用了,通过ImageLoader的displayImage()绑定一个图片和ImageView。
displayImage(String uri, ImageView imageView, DisplayImageOptions options)
DisplayImageOptions用于指导每一个Imageloader根据网络图片的状态(空白、下载错误、正在下载)显示对应的图片,是否将缓存加载到磁盘上,下载完后对图片进行怎么样的处理。

实例:UniversalImageLoaderDemo

Android图片异步加载框架Android-Universal-Image-Loader

运行效果:
Android图片异步加载框架Android-Universal-Image-Loader

代码清单:
AndroidManifest.xml
[html] view plaincopy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     package="com.rainsong.universalimageloaderdemo"  
  4.     android:versionCode="1"  
  5.     android:versionName="1.0" >  
  6.   
  7.     <uses-sdk  
  8.         android:minSdkVersion="8"  
  9.         android:targetSdkVersion="19" />  
  10.   
  11.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
  12.     <uses-permission android:name="android.permission.INTERNET" />  
  13.       
  14.     <application  
  15.         android:name="com.rainsong.universalimageloaderdemo.UILApplication"  
  16.         android:allowBackup="true"  
  17.         android:icon="@drawable/logo"  
  18.         android:label="@string/app_name"  
  19.         android:theme="@style/AppTheme" >  
  20.         <activity  
  21.             android:name="com.rainsong.universalimageloaderdemo.MainActivity"  
  22.             android:label="@string/app_name" >  
  23.             <intent-filter>  
  24.                 <action android:name="android.intent.action.MAIN" />  
  25.   
  26.                 <category android:name="android.intent.category.LAUNCHER" />  
  27.             </intent-filter>  
  28.         </activity>  
  29.     </application>  
  30.   
  31. </manifest>  

布局文件:activity_main.xml
[html] view plaincopyAndroid图片异步加载框架Android-Universal-Image-LoaderAndroid图片异步加载框架Android-Universal-Image-Loader
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     xmlns:tools="http://schemas.android.com/tools"  
  4.     android:layout_width="match_parent"  
  5.     android:layout_height="match_parent"  
  6.     android:orientation="vertical"  
  7.     tools:context=".MainActivity" >  
  8.   
  9.     <ListView  
  10.         android:id="@+id/list"  
  11.         android:layout_width="match_parent"  
  12.         android:layout_height="match_parent" >  
  13.     </ListView>  
  14.   
  15. </LinearLayout>  

布局文件:item_list.xml

[html] view plaincopyAndroid图片异步加载框架Android-Universal-Image-LoaderAndroid图片异步加载框架Android-Universal-Image-Loader
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="wrap_content" >  
  5.   
  6.     <ImageView  
  7.         android:id="@+id/image"  
  8.         android:layout_width="72dip"  
  9.         android:layout_height="72dip"  
  10.         android:layout_margin="3dip"  
  11.         android:adjustViewBounds="true"  
  12.         android:contentDescription="@string/descr_image"  
  13.         android:scaleType="centerCrop" />  
  14.   
  15.     <TextView  
  16.         android:id="@+id/text"  
  17.         android:layout_width="fill_parent"  
  18.         android:layout_height="wrap_content"  
  19.         android:layout_gravity="start|center_vertical"  
  20.         android:layout_marginLeft="20dip"  
  21.         android:textSize="22sp" />  
  22.   
  23. </LinearLayout>  
Java源代码文件:UILApplication.java
[java] view plaincopyAndroid图片异步加载框架Android-Universal-Image-LoaderAndroid图片异步加载框架Android-Universal-Image-Loader
  1. package com.rainsong.universalimageloaderdemo;  
  2.   
  3. import java.io.File;  
  4.   
  5. import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiscCache;  
  6. import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;  
  7. import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;  
  8. import com.nostra13.universalimageloader.core.ImageLoader;  
  9. import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;  
  10. import com.nostra13.universalimageloader.core.assist.QueueProcessingType;  
  11. import com.nostra13.universalimageloader.core.download.BaseImageDownloader;  
  12. import com.nostra13.universalimageloader.utils.StorageUtils;  
  13.   
  14. import android.app.Application;  
  15. import android.content.Context;  
  16.   
  17. public class UILApplication extends Application {  
  18.   
  19.     @Override  
  20.     public void onCreate() {  
  21.         super.onCreate();  
  22.         initImageLoader(getApplicationContext());  
  23.     }  
  24.   
  25.     public static void initImageLoader(Context context) {  
  26.         //缓存文件的目录  
  27.         File cacheDir = StorageUtils.getOwnCacheDirectory(context, "universalimageloader/Cache");   
  28.         ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)  
  29.                 .memoryCacheExtraOptions(480800// max width, max height,即保存的每个缓存文件的最大长宽   
  30.                 .threadPoolSize(3//线程池内线程的数量  
  31.                 .threadPriority(Thread.NORM_PRIORITY - 2)  
  32.                 .denyCacheImageMultipleSizesInMemory()  
  33.                 .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密  
  34.                 .memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024))  
  35.                 .memoryCacheSize(2 * 1024 * 1024// 内存缓存的最大值  
  36.                 .diskCacheSize(50 * 1024 * 1024)  // SD卡缓存的最大值  
  37.                 .tasksProcessingOrder(QueueProcessingType.LIFO)  
  38.                 // 由原先的discCache -> diskCache  
  39.                 .diskCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径    
  40.                 .imageDownloader(new BaseImageDownloader(context, 5 * 100030 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间    
  41.                 .writeDebugLogs() // Remove for release app  
  42.                 .build();  
  43.         //全局初始化此配置    
  44.         ImageLoader.getInstance().init(config);  
  45.     }  
  46. }  

Java源代码文件:MainActivity.java

[java] view plaincopyAndroid图片异步加载框架Android-Universal-Image-LoaderAndroid图片异步加载框架Android-Universal-Image-Loader
  1. package com.rainsong.universalimageloaderdemo;  
  2.   
  3. import com.nostra13.universalimageloader.core.DisplayImageOptions;  
  4. import com.nostra13.universalimageloader.core.ImageLoader;  
  5. import com.nostra13.universalimageloader.core.display.RoundedBitmapDisplayer;  
  6. import android.os.Bundle;  
  7. import android.app.Activity;  
  8. import android.view.Menu;  
  9. import android.view.MenuItem;  
  10. import android.view.View;  
  11. import android.view.ViewGroup;  
  12. import android.widget.BaseAdapter;  
  13. import android.widget.ImageView;  
  14. import android.widget.ListView;  
  15. import android.widget.TextView;  
  16.   
  17. public class MainActivity extends Activity {  
  18.     private ImageLoader imageLoader;  
  19.     private ListView lv;  
  20.     private String[] imageUrls;  
  21.     private DisplayImageOptions options;  
  22.   
  23.     @Override  
  24.     protected void onCreate(Bundle savedInstanceState) {  
  25.         super.onCreate(savedInstanceState);  
  26.         setContentView(R.layout.activity_main);  
  27.         imageLoader = ImageLoader.getInstance();  
  28.         lv = (ListView)findViewById(R.id.list);  
  29.           
  30.         imageUrls = Constants.images;  
  31.   
  32.         // 使用DisplayImageOptions.Builder()创建DisplayImageOptions  
  33.         options = new DisplayImageOptions.Builder()  
  34.                 .showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片  
  35.                 .showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片  
  36.                 .showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片  
  37.                 .cacheInMemory(true// 设置下载的图片是否缓存在内存中  
  38.                 .cacheOnDisk(true// 设置下载的图片是否缓存在SD卡中  
  39.                 .displayer(new RoundedBitmapDisplayer(20)) // 设置成圆角图片  
  40.                 .build(); // 构建完成  
  41.         lv.setAdapter(new ItemListAdapter());  
  42.     }  
  43.   
  44.     @Override  
  45.     public boolean onCreateOptionsMenu(Menu menu) {  
  46.         // Inflate the menu; this adds items to the action bar if it is present.  
  47.         getMenuInflater().inflate(R.menu.main, menu);  
  48.         return true;  
  49.     }  
  50.   
  51.     @Override  
  52.     public boolean onOptionsItemSelected(MenuItem item) {  
  53.         switch (item.getItemId()) {  
  54.             case R.id.item_clear_memory_cache:  
  55.                 ImageLoader.getInstance().clearMemoryCache();  
  56.                 return true;  
  57.             case R.id.item_clear_disc_cache:  
  58.                 ImageLoader.getInstance().clearDiskCache();  
  59.                 return true;  
  60.             default:  
  61.                 return false;  
  62.         }  
  63.     }  
  64.   
  65.     class ItemListAdapter extends BaseAdapter {  
  66.         @Override  
  67.         public int getCount() {  
  68.             // TODO Auto-generated method stub  
  69.             return imageUrls.length;  
  70.         }  
  71.   
  72.         @Override  
  73.         public Object getItem(int position) {  
  74.             // TODO Auto-generated method stub  
  75.             return imageUrls[position];  
  76.         }  
  77.   
  78.         @Override  
  79.         public View getView(int position, View convertView, ViewGroup parent) {  
  80.             // TODO Auto-generated method stub  
  81.             ViewHolder holder = null;  
  82.             if (convertView == null) {  
  83.                 convertView = getLayoutInflater().inflate(R.layout.item_list, parent, false);  
  84.                 holder = new ViewHolder();  
  85.                 holder.text = (TextView) convertView.findViewById(R.id.text);  
  86.                 holder.image = (ImageView) convertView.findViewById(R.id.image);  
  87.                 convertView.setTag(holder);  
  88.             } else {  
  89.                 holder = (ViewHolder) convertView.getTag();  
  90.             }  
  91.             holder.text.setText("Item " + (position + 1));  
  92.             imageLoader.displayImage(imageUrls[position], holder.image, options);  
  93.             return convertView;  
  94.         }  
  95.   
  96.         @Override  
  97.         public long getItemId(int position) {  
  98.             // TODO Auto-generated method stub  
  99.             return position;  
  100.         }  
  101.   
  102.         class ViewHolder {  
  103.             public ImageView image;  
  104.             public TextView text;  
  105.         }  
  106.     }  
  107.   
  108. }