第 1 章 配置和使用

下载Fresco

类库发布到了Maven中央库:

Gradle:

dependencies {
  compile 'com.facebook.fresco:fresco:0.1.0+'
}

Maven:

<dependency>
  <groupId>com.facebook.fresco</groupId>
  <artifactId>fresco</artifactId>
  <version>LATEST</version>
</dependency>

Eclipse

~呵呵~

配置和开始使用

如果你仅仅是想简单下载一张网络图片，在下载完成之前，显示一张占位图，那么简单使用 SimpleDraweeView 即可。

在Application 初始化时:

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:

<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, 负责图片的显示。

一般情况下，使用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。

如下：

注意，只有图片资源才能使用在Imagepipeline中，比如(PNG)。其他资源类型，比如字符串，或者XML Drawable在Imagepipeline中没有意义。所以加载的资源不支持这些类型。

像ShapeDrawable这样声明在XML中的drawable可能引起困惑。注意到这毕竟不是图片，如果想把这样的drawable作为图像显示。

那么把这个drawable设置为占位图，然后把URI设置为null。