Android-Universal-Image-Loader是一个图片异步加载,缓存和显示的框架。这个框架已经被很多开发者所使用,是最常用的几个Android开源项目之一,主流的应用,随便反编译几个,都可以见到它的身影。淘宝,天猫,Facebook,京东商城等都用到了这个项目。
该项目的Github地址链接:https://github.com/nostra13/Android-Universal-Image-Loader
运行流程:
每一个图片的加载和显示任务都运行在独立的线程中,除非这个图片缓存在内存中,这种情况下图片会立即显示。如果需要的图片缓存在本地,它会开启一个独立的线程队列。如果在缓存中没有正确的图片,任务线程会从网络中获取。
使用步骤:
1、加载图片之前,先要做初始化配置,这个类似很多游戏引擎使用前要做一下初始化,其实只做了一件事,实例化一个全局的ImageLoader对象,同时传入图片加载缓存的配置,ImageLoaderConfiguration封装了基本的配置信息,比如加载图片事用的线程池大小,线程的优先级,内存缓存大小,是否支持同一图片的多尺寸缓存(默认是支持的,可以手动关闭),还有缓存的命名规则等等。
2、配置完后,就可以开始使用了,通过ImageLoader的displayImage()绑定一个图片和ImageView。
displayImage(String uri, ImageView imageView, DisplayImageOptions options)
DisplayImageOptions用于指导每一个Imageloader根据网络图片的状态(空白、下载错误、正在下载)显示对应的图片,是否将缓存加载到磁盘上,下载完后对图片进行怎么样的处理。
实例:UniversalImageLoaderDemo
运行效果:
代码清单:
AndroidManifest.xml
[html] view plain copy
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 plain copy
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 plain copy
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 plain copy
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. "universalimageloader/Cache");
28. new ImageLoaderConfiguration.Builder(context)
29. 480, 800) // max width, max height,即保存的每个缓存文件的最大长宽
30. 3) //线程池内线程的数量
31. 2)
32. .denyCacheImageMultipleSizesInMemory()
33. new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密
34. new UsingFreqLimitedMemoryCache(2 * 1024 * 1024))
35. 2 * 1024 * 1024) // 内存缓存的最大值
36. 50 * 1024 * 1024) // SD卡缓存的最大值
37. .tasksProcessingOrder(QueueProcessingType.LIFO)
38. // 由原先的discCache -> diskCache
39. new UnlimitedDiscCache(cacheDir))//自定义缓存路径
40. new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间
41. // Remove for release app
42. .build();
43. //全局初始化此配置
44. ImageLoader.getInstance().init(config);
45. }
46. }
Java源代码文件:MainActivity.java
[java] view plain copy
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. new DisplayImageOptions.Builder()
34. // 设置图片下载期间显示的图片
35. // 设置图片Uri为空或是错误的时候显示的图片
36. // 设置图片加载或解码过程中发生错误显示的图片
37. true) // 设置下载的图片是否缓存在内存中
38. true) // 设置下载的图片是否缓存在SD卡中
39. new RoundedBitmapDisplayer(20)) // 设置成圆角图片
40. // 构建完成
41. 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. null;
82. if (convertView == null) {
83. false);
84. 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. "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. }
109.