第 1 章 配置和使用
最后更新于：2022-04-01 02:24:04
[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。