Picasso(1) - 使用(踩坑)

不念不忘少年蓝@ 2022-05-21 11:52 223阅读 0赞

### 系列文章 ###

> [Picasso(1) - 使用(踩坑)][Picasso_1_ -]  
> [Picasso(2) - 自定义配置][Picasso_2_ -]  
> [Picasso(3) - 图片加载流程][Picasso_3_ -]  
> [Picasso(4) - Dispatcher][Picasso_4_ - Dispatcher]  
> [Picasso(5) - Rocket][Picasso_5_ - Rocket]

--------------------

### 前言 ###

本文基于 Picasso 2.71828 版本 。本文不仅讲用法,更主要讲的是错误的用法。而具体的源码分析在其他文章中。

implementation 'com.squareup.picasso:picasso:2.71828'

--------------------

### 基本用法 ###

从 assets 中加载

Picasso.get()
            .load("file:///android_asset/test_img") .into(imageView);

从资源 Id 中加载图片  
方法一 :

Picasso.get()
            .load(R.drawable.test_img)
            .into(imageView);

方法二 :

Picasso.get()
             .load("android.resource://" + getPackageName() + "/" + R.drawable.test_img)
             .into(imageView);

从 SD 中加载文件

File externalFile = getExternalFilesDir(null).getAbsoluteFile();
    File targetFile = new File(externalFile, "test.jpg");
    Picasso.get()
           .load(targetFile)
           .into(imageView);

从网络中加载图片

Picasso.get()
           .load("http://i.imgur.com/DvpvklR.png") .into(imageView);

设置占位图

Picasso.get()
           .load("http://i.imgur.com/DvpvklR.png")
           .placeholder(R.drawable.placeHolder)
           .into(imageView);

设置加载失败图片

Picasso.get()
              .load("http://i.imgur.com/DvpvklR.png")
              .error(R.drawable.error_image)
              .into(imageView);

加载指定大小的图片 :

例如 : [http://i.imgur.com/DvpvklR.png][http_i.imgur.com_DvpvklR.png] 图片分辨率为 400\* 486 ,Bitmap.config 为 ARGB\_8888 , 即每个像素占 4 个字节。

Picasso.get()
           .load("http://i.imgur.com/DvpvklR.png")
           .resize(200,200)
           .into(imageView);

如果不调用 resize() 方法 , 图片所占用内存大小为 400 \* 486 \* 4 个字节 。  
调用了 resize() 方法后,图片所占用内存大小为 200 \* 200 \* 4 个字节。  
可以发现内存占用减少了很多。

但是请务必注意 , 千万不要以为有了图片加载框架,就可以为所欲为 !!!   
resize() 不仅可以缩小,同时也会放大图片。下面代码 resize()之后 加载了 3500 \* 3500 分辨率的图片到内存中。  
所占用内存为 3500 \* 3500 \* 4 /(1024\*1024) = 46.7 M 。如果你的页面存在内存泄露 , 嘿嘿 ,等着加班修 Bug 吧 !

Picasso.get()
           .load("http://i.imgur.com/DvpvklR.png")
           .resize(3500,3500)
           .into(imageView);

因此使用 resize 的时候,最好加上 onlyScaleDown() 方法。  
只缩小不放大, 当 resize 尺寸大于 Bitmap 尺寸的时候 ,不放大图片。  
当 resize 尺寸小于 Bitmap 尺寸的时候,缩小图片。  
下面代码最终加载了 400 \* 486 分辨率的图片到内存中 。

Picasso.get()
           .load("http://i.imgur.com/DvpvklR.png")
           .resize(3500,3500)
           .onlyScaleDown()
           .into(imageView);

设置图片 ScaleType  
以下写法全是错误写法 :

Picasso.get().load("http://i.imgur.com/DvpvklR.png").centerCrop().into(imageView);
            Picasso.get().load("http://i.imgur.com/DvpvklR.png").centerInside().into(imageView);
            Picasso.get()
                   .centerInside()
                   .centerCrop()
                   .into(imageView);

centerCrop() 和 centerInside() 单独使用的时候, 必须调用 resize()方法。  
centerCrop() 和 centerInside() 不能同时使用。

--------------------

### 取消加载图片 ###

当我们退出页面 Activity/fragment 的时候,不想再加载图片,我们需要取消请求。

Picasso.get().cancelRequest(imageView);
     // 或
     Picasso.get().cancelTag(tag);

这里大家要注意一下问题 :  
如果正在下载一张图片,你取消了请求,有用吗 ?  
答案: 网络请求不会中断,仍会占用网络继续下载,但是 ImageView 不会收到回调。  
这里的 “正在下载” 的意思是 :  
线程是正在执行 Runnable 方法 。 如果请求在线程池的等待队列当中,那么不会下载 。如果正在执行,则不会中断。

--------------------

### 暂停加载图片 ###

大家看到暂停加载图片,不要以为是真的支持断点下载。  
这里的暂停加载图片,实际上是取消下载图片。并把当前请求添加到暂停列表中。

Picasso.get().pauseTag(tag);

--------------------

## 继续加载图片 ##

这里的继续加载图片,是重新把请求交给 Picasso 来下载,也不是断点下载。

Picasso.get().resumeTag(tag);

这个 暂停和继续 下载图片有什么用呢 ? 大多数情况下是用在 ListView/ RecyclerView 当中。  
当快速滑动的时候暂停下载图片,当滑动停止的时候继续加载图片。

--------------------

### 跳过内存缓存加载图片 ###

有时候不想从内存缓存中加载图片,而想直接从磁盘或网络中加载图片。  
我们可以设置其内存策略为 MemoryPolicy.NO\_CACHE 。

Picasso.get()
                    .load("http://i.imgur.com/DvpvklR.png")
                    .memoryPolicy(MemoryPolicy.NO_CACHE)
                    .into(imageView);

--------------------

### 加载的图片不存放到内存缓存中 ###

例如我提前知道一张图片分辨率很大,占用的内存很多,因此我不想把这张图片加载到内存中。  
我们可以设置它的内存策略为 MemoryPolicy.NO\_STORE 。

Picasso.get()
                    .load("http://i.imgur.com/DvpvklR.png")
                    .memoryPolicy(MemoryPolicy.NO_STORE)
                    .into(imageView);

--------------------

### 图片加载回调 ###

注意 ,下面的写法会造成内存泄露 !

Picasso.get().load("http://i.imgur.com/DvpvklR.png").into(imageView, new Callback() {
                @Override
                public void onSuccess() {
    
                }
                @Override
                public void onError(Exception e) {
    
                }
            });

Callback 匿名内部类持有外部类的引用 。因此在 Activity/Fragment 销毁的时候注意取消请求。

Picasso.get().cancelRequest(imageView);

同时注意到, 上边的回调,并没有 Bitmap 对象。 有时候我们需要拿到 Bitmap 对象来做些额外的处理 ,见下:

--------------------

### 图片加载 Bitmap 回调 ###

注意,下面的写法也是错误的写法

Picasso.get().load("http://i.imgur.com/DvpvklR.png").into(new Target() {
                @Override
                public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
    
                }
    
                @Override
                public void onBitmapFailed(Exception e, Drawable errorDrawable) {
    
                }
    
                @Override
                public void onPrepareLoad(Drawable placeHolderDrawable) {
    
                }
            });

在 Picasso 中持有的 ImageView / Target 都是弱引用 , 上面的代码意味着 , Target 随时可能被回收 , 这些回调可能不会被调用。  
正确写法如下 : 将 Target 声明为成员变量, Activity/fragent 销毁的时候要取消请求。

Picasso.get()
            .load("http://i.imgur.com/DvpvklR.png")
            .into(target);
    ...
        private Target target = new Target() {
    
            @Override
            public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
    
            }
    
            @Override
            public void onBitmapFailed(Exception e, Drawable errorDrawable) {
    
            }
    
            @Override
            public void onPrepareLoad(Drawable placeHolderDrawable) {
    
            }
        };
    
    ....
       @Override
        protected void onDestroy() {
            super.onDestroy();
            Picasso.get().cancelRequest(target);
        }

--------------------

### 预加载图片到内存当中 ###

有的时候,为了更快的拿到图片,我们需要提前从网络或磁盘中加载图片到内存中。  
例如有两个页面 A、B ,在 A 页面的时候就去下载一张图片,跳转到 B 页面的时候立即显示图片,这样体验更好。  
因此在 A 页面的时候,我们就可以调用。

Picasso.get()
                   .load("http://i.imgur.com/DvpvklR.png") .fetch();

如果你需要回调 fetch 方法的回调 :  下面代码同样这是错误的写法 ,理由同上,匿名内部类持有外部类造成的内存泄露 。但是这里 fetch 又不能直接取消。  
这里有两个解决方法。  
1. 设置 tag , 在 Acttivity /fragment 销毁的时候,取消掉 tag 。  
2. 使用 静态内部类 , 如果需要引用 Acttivity /fragment ,请使用弱引用来避免内存泄露。  
3. 不使用 fetch() 方法,使用上述的 into(Target) 方法 。

Picasso.get().load("http://i.imgur.com/DvpvklR.png").fetch(new Callback() {
                @Override
                public void onSuccess() {
    
                }
    
                @Override
                public void onError(Exception e) {
    
                }
            });

--------------------

### 同步方法获取 Bitmap ###

上面获取 Bitmap 对象的方法都是异步方法 ,如果需要同步方法 ,可以调用 get 方法 :

try {
                Bitmap bitmap = Picasso.get().load("http://i.imgur.com/DvpvklR.png").get();
            } catch (IOException e) {
                e.printStackTrace();
            }

使用时请务必注意一下两点  
1.get() 方法获取到 Bitmap 后 ,没有存放到内存缓存 ( LruCache )中 。  
原因是 Picasso 不能够保证 Cache 的实现都是线程安全的。  
大家注意一下, Picassso 中的 LruCache 实现了 Cache 接口 , 内部实际调用了 android.util 包下的 LruCache 。  
而 android 的 LruCache 是线程安全的。  
从代码中也可以看出 Picasso 中的 LruCache 方法也是线程安全的。  
而 Picasso 是了为了防止用户 自定义 Cache , 没有保证 set() 和 get() 方法的线程安全。因此才不放到内存缓存当中。  
2. get() 方法不能在主线程调用 ,必须在异步线程中调用 。get() 方法是同步方法 ,会从磁盘或网络中加载图片,是耗时操作。

--------------------

### 总结 ###

使用第三方框架稍不留神,就会有很多的隐患。  
本文的这些坑,一些已经在 Picasso 的注释中写的很明白。而另外一些,是我看了源码后忽然想到的。  
写完本篇文章后一身冷汗, 不能仅仅满足于 API 的调用, 还是要知其然知其所以然 !

[Picasso_1_ -]: https://blog.csdn.net/stupid56862/article/details/80944029
[Picasso_2_ -]: https://blog.csdn.net/stupid56862/article/details/80846342
[Picasso_3_ -]: https://blog.csdn.net/stupid56862/article/details/81069090
[Picasso_4_ - Dispatcher]: https://blog.csdn.net/stupid56862/article/details/81120697
[Picasso_5_ - Rocket]: https://blog.csdn.net/stupid56862/article/details/81280234
[http_i.imgur.com_DvpvklR.png]: http://i.imgur.com/DvpvklR.png