首页 > 代码库 > 【Android - 框架】之Fresco的使用

【Android - 框架】之Fresco的使用

当下有很多图片加载框架,常见的有Glide、Fresco、Picasso等。Glide因为其体积小、缓存机制强大等优点,受到了广大程序员的青睐;Fresco虽然体积比较大,缓存机制也没有Glide强大,但它胜在拥有一些炫酷的效果(进度条、淡入效果)等,也有很多人在使用。今天我们就来介绍一下Fresco的使用。

        先贴出【Fresco的中文官方文档】。

 

1、配置环境

        使用Fresco需要先在build.gradle中导入依赖:

    // Fresco所需依赖
    compile ‘com.facebook.fresco:fresco:0.12.0‘
    // 在 API < 14 上的机器支持 WebP 时,需要添加
    compile ‘com.facebook.fresco:animated-base-support:0.12.0‘
    // 支持 GIF 动图,需要添加
    compile ‘com.facebook.fresco:animated-gif:0.12.0‘
    // 支持 WebP (静态图+动图),需要添加
    compile ‘com.facebook.fresco:animated-webp:0.12.0‘
    compile ‘com.facebook.fresco:webpsupport:0.12.0‘

 

        如果需要从网络中下载图片,则需要在AndroidManifest.xml文件中配置网络权限:

<uses-permission android:name="android.permission.INTERNET" />

 

        最后,在项目的Application中初始化Fresco:

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化Fresco
        Fresco.initialize(this);
    }
}

 

        别忘了在AndroidManifest.xml文件中为Application添加name属性:

    <application
        android:name=".MyApplication"
        ......
    </application>

 

2、SimpleDraweeView

2.1、XML属性

        Fresco为我们提供了一个SimpleDraweeView控件,我们可以直接在这个控件中加载图片。Fresco在这个控件中集成了很多属性,简单实用。以下是SimpleDraweeView中的常用属性:

        fresco:actualImageScaleType:实际加载的图片的伸缩样式
        fresco:backgroundImage:底层图片资源
        fresco:fadeDuration:进度条和占位符图片逐渐消失、加载的图片逐渐显示的时间间隔
        fresco:failureImage:加载失败时显示的图片资源
        fresco:failureImageScaleType:加载失败时加载的图片的伸缩样式
        fresco:overlayImage:在显示的图片表层覆盖一张图片的图片资源
        fresco:placeholderImage:占位符图片资源
        fresco:placeholderImageScaleType:占位符图片的伸缩样式
        fresco:progressBarAutoRotateInterval:进度条图片转动周期
        fresco:progressBarImage:进度条图片资源
        fresco:progressBarImageScaleType:进度条图片的伸缩样式
        fresco:retryImage:提示重新加载的图片资源
        fresco:retryImageScaleType:提示重新加载的图片的伸缩样式
        fresco:roundAsCircle:将图片剪切成圆形
        fresco:viewAspectRatio:图片宽高比

 

        我们的XML布局文件中的代码如下:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:fresco="http://schemas.android.com/apk/res-auto"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.facebook.drawee.view.SimpleDraweeView
        android:id="@+id/id_main_sdv_sdv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        fresco:actualImageScaleType="focusCrop"
        fresco:fadeDuration="3000"
        fresco:failureImage="@mipmap/ic_launcher"
        fresco:failureImageScaleType="centerInside"
        fresco:placeholderImage="@mipmap/ic_launcher"
        fresco:placeholderImageScaleType="fitCenter"
        fresco:progressBarAutoRotateInterval="1000"
        fresco:progressBarImage="@mipmap/ic_launcher"
        fresco:progressBarImageScaleType="centerInside"
        fresco:retryImage="@mipmap/ic_launcher"
        fresco:retryImageScaleType="centerCrop"
        fresco:roundAsCircle="false"
        fresco:viewAspectRatio="1.6" />

    <Button
        android:id="@+id/id_main_btn_load"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_margin="20.0dip"
        android:text="Start Load Image" />

</RelativeLayout>

 

2.2、注意事项

(1)SimpleDraweeView控件的宽高不能设置为wrap_content,只能是match_parent、具体值或使用viewAspectRatio属性设置宽高比。

(2)如果在一个页面中加载多张图片,不要将SimpleDraweeView直接放在ScollView中,建议使用RecyclerView、ListView或GridView,因为ScrollView中的SimpleDraweeView会持有内存直到Activity或Fragment销毁。

(3)使用SimpleDraweeView时,不要使用imageView中有、View中没有的属性。

3、框架使用

3.1、简单使用

        像TextView、Button等其他控件一样后去到SimpleDraweeView,然后调用如下代码即可加载网络图片:

SimpleDraweeView sdv = (SimpleDraweeView) findViewById(R.id.id_main_sdv_sdv);
sdv.setImageURI("http://image5.tuku.cn/pic/wallpaper/fengjing/menghuandaziranmeijingbizhi/009.jpg");

 

3.2、JAVA代码设置属性

        我们可以通过GenericDraweeHierarchy,在JAVA代码中动态的设置SimpleDraweeView控件的属性。需要注意的是,如果在JAVA代码中设置了属性,那么XML文件中设置的属性就都无效了。一个实例代码如下:

        // 代码设置SimpleDraweeView的属性(会覆盖XML设置的所有属性,即在XML中有在这里没有的属性都会失效)
        // 注意:一个GenericDraweeHierarchy是不能被多个SimpleDraweeView共用的
        GenericDraweeHierarchy hierarchy = new GenericDraweeHierarchyBuilder(getResources())
                .setFadeDuration(3000)
                .setPlaceholderImage(R.mipmap.ic_launcher)
                .setPlaceholderImageScaleType(ScalingUtils.ScaleType.FIT_XY)
                .setProgressBarImage(new ProgressBarDrawable()) // 显示进度条(Fresco自带的进度条)
                .build();
        // 设置图片圆角
        RoundingParams roundingParams = new RoundingParams();
        roundingParams.setRoundAsCircle(false); // 不将图片剪切成圆形
        roundingParams.setCornersRadius(200);
        hierarchy.setRoundingParams(roundingParams);
        // 为SimpleDraweeView设置属性
        sdv.setHierarchy(hierarchy);

 

        注意:不能把同一个GenericDraweeHierarchy对象设置给多个SimpleDraweeView!

 

3.3、设置下载事件

        sdv.setController(Fresco.newDraweeControllerBuilder()
                .setControllerListener(new BaseControllerListener<ImageInfo>() {
                    @Override
                    public void onFinalImageSet(String id, ImageInfo imageInfo, Animatable animatable) {
                        // 所有图片都加载成功时触发的方法
                        int width = imageInfo.getWidth();
                        int height = imageInfo.getHeight();
                        QualityInfo qualityInfo = imageInfo.getQualityInfo();
                        int quality = qualityInfo.getQuality();
                        boolean isOfFullQuality = qualityInfo.isOfFullQuality();
                        boolean isOfGoodEnoughQuality = qualityInfo.isOfGoodEnoughQuality();
                    }

                    @Override
                    public void onIntermediateImageSet(String id, ImageInfo imageInfo) {
                        // 加载渐进式图片时回调的方法
                    }

                    @Override
                    public void onFailure(String id, Throwable throwable) {
                        // 加载图片失败时回调的方法
                    }
                })
                .setUri("http://image5.tuku.cn/pic/wallpaper/fengjing/menghuandaziranmeijingbizhi/009.jpg")
                .build());

 

3.4、渐进式图片

        渐进式图片是一种支持图片从模糊到清晰的加载模式。代码如下:

                sdv.setController(Fresco.newDraweeControllerBuilder()
                        .setImageRequest(
                                ImageRequestBuilder.newBuilderWithSource(
                                        Uri.parse("http://image5.tuku.cn/pic/wallpaper/fengjing/menghuandaziranmeijingbizhi/009.jpg"))
                                        .setProgressiveRenderingEnabled(true)
                                        .build())
                        .setOldController(sdv.getController())
                        .build());

 


以上就是对Fresco的基本使用方法的介绍,希望对大家有帮助~~~

【Android - 框架】之Fresco的使用