[TOC] ## 下载Fresco 类库发布到了Maven中央库: ### Gradle: ~~~groovy dependencies { compile 'com.facebook.fresco:fresco:0.1.0+' } ~~~ ### Maven: ~~~xml <dependency> <groupId>com.facebook.fresco</groupId> <artifactId>fresco</artifactId> <version>LATEST</version> </dependency> ~~~ ### Eclipse ~~~呵呵~~~ ## 配置和开始使用 如果你仅仅是想简单下载一张网络图片,在下载完成之前,显示一张占位图,那么简单使用 SimpleDraweeView 即可。 在Application 初始化时: ~~~java Fresco.initialize(context);~~~ 在xml布局文件中, 加入命名空间: ~~~xml <!-- 其他元素 --> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:fresco="http://schemas.android.com/apk/res-auto"> ~~~ 加入`SimpleDraweeView`: ~~~xml <com.facebook.drawee.view.SimpleDraweeView android:id="@+id/my_image_view" android:layout_width="20dp" android:layout_height="20dp" fresco:placeholderImage="@drawable/my_drawable" /> ~~~ 开始加载图片 ~~~ draweeView.setImageURI("http://site.com/uri"); ~~~ 剩下的,Fresco会替你完成: - 显示占位图直到加载完成; - 下载图片; - 缓存图片; - 图片不再显示时,从内存中移除; 等等等等。 ## 关键概念 ### Drawees Drawees 负责图片的呈现,包含几个组件,有点像MVC模式。 #### DraweeView 继承于 [View](http://developer.android.com/reference/android/view/View.html), 负责图片的显示。 一般情况下,使用`SimpleDraweeView` 即可. 简单的用法,在这个页面:[开始使用](#) 。 它支持很多自定义效果,参见这里: [自定义显示效果](#). #### DraweeHierarchy 继承于 Drawable, 包含用于绘制的图像数据。MVC中的M。 如果你想在Java代码中自定义图片的展示,可以通过这类实现,具体的请参考这里: [在Java代码中自定义显示效果](#) #### DraweeController `DraweeController` 负责和 image loader 交互(默认是Fresco中 image pipeline),可以创建一个这个类的实例,来实现对所要显示的图片做更多的控制。 #### DraweeControllerBuilder `DraweeControllers` 由 `DraweeControllerBuilder` 采用 Builder 模式创建,创建之后,不可修改。具体参见: [使用ControllerBuilder](#)。 #### Listeners 使用 ControllerListener 的一个场景就是设置一个 [Listener](#)监听图片的下载。 ### Image Pipeline Fresco 的 Image Pipeline 负责图片的获取和管理。图片可以来自远程服务器,本地文件,或者Content Provider,本地资源。压缩后的文件缓存在本地存储中,Bitmap数据缓存在内存中。 在5.0系统之后,Image Pipeline 使用`pinned purgeables*将Bitmap数据存在native 内存中。这要求图片不使用时,要显示地释放内存。 `SimpleDraweeView` 自动处理了这个释放过程,所以没有特殊情况,尽量使用`SimpleDraweeView`,在特殊的场合,如果有需要,也可以直接控制Image Pipeline。 ## 支持的URIs Fresco 支持许多URI格式。 特别注意:Fresco **不支持** 相对路径的URI. 所有的URI都必须是绝对路径,并且带上该URI的scheme。 如下: | 类型 | Scheme | 示例 | |-----|-----|-----| | 远程图片 | `http://,``https://` | `HttpURLConnection` 或者参考 [使用其他网络加载方案](#) | | 本地文件 | `file://` | `FileInputStream` | | Content provider | `content://` | `ContentResolver` | | asset目录下的资源 | `asset://` | `AssetManager` | | res目录下的资源 | `res://` | `Resources.openRawResource` | 注意,只有图片资源才能使用在Imagepipeline中,比如(PNG)。其他资源类型,比如字符串,或者XML Drawable在Imagepipeline中没有意义。所以加载的资源不支持这些类型。 像ShapeDrawable这样声明在XML中的drawable可能引起困惑。注意到这毕竟不是图片,如果想把这样的drawable作为图像显示。 那么把这个drawable设置为占位图,然后把URI设置为null。