之前项目中使用Picasso遇到了一个问题：在Android 5.0以上版本的部分手机上使用Picasso加载本地图片会失败。为了解决这个问题，研究了一下Picasso加载和压缩本地图片的流程，才有了这篇文章。

我们知道，Picasso加载本地图片有两种方法，一种是new File(path)，另外一种是url = "file://" + path。尤其后一种在picasso2.5.2及之前版本一定要加"file"协议，否则加载图片出错。

对于上面提到的问题，只出现在使用Picasso加载本地图片并且使用了resize方法的时候。

而且发现只存在Android 5.0以上版本的部分手机上。比如我们发现5.0、5.0.1有问题，5.1.1没有问题；同时有的5.0的手机没问题，而有的会出现这个问题。

由于有时本地照片较大，所以虽然可以不使用resize方法来保证图片正常加载，但是这样内存开销会急剧增加，所以我们不可避免的要解决这个问题。

经研究发现问题出现在picasso的BitmapHunter类中，当得到读取了网络或本地图片后，会调用BitmapHunter的decodeStream来进行处理，该方法代码如下：

static Bitmap decodeStream(InputStream stream, Request request) throws IOException {

MarkableInputStream markStream = new MarkableInputStream(stream);

stream = markStream;

long mark = markStream.savePosition(65536); // TODO fix this crap. (1)

final BitmapFactory.Options options = RequestHandler.createBitmapOptions(request);

final boolean calculateSize = RequestHandler.requiresInSampleSize (options );

boolean isWebPFile = Utils.isWebPFile( stream);

boolean isPurgeable = request .purgeable && android.os.Build.VERSION.SDK_INT < 21;

markStream.reset( mark);

// We decode from a byte array because, a) when decoding a WebP network stream, BitmapFactory

// throws a JNI Exception, so we workaround by decoding a byte array, or b) user requested

// purgeable, which only affects bitmaps decoded from byte arrays.

if (isWebPFile || isPurgeable) { (2)

byte[] bytes = Utils. toByteArray(stream);

if (calculateSize) {

BitmapFactory. decodeByteArray(bytes, 0, bytes.length, options);

RequestHandler. calculateInSampleSize(request.targetWidth, request.targetHeight , options ,

request);

}

return BitmapFactory. decodeByteArray(bytes, 0, bytes.length, options);

} else {

if (calculateSize) { (3)

BitmapFactory. decodeStream(stream, null, options); (4)

RequestHandler. calculateInSampleSize(request.targetWidth, request.targetHeight , options ,

request);

markStream.reset(mark ); (5)

}

Bitmap bitmap = BitmapFactory. decodeStream(stream, null, options);

if (bitmap == null) {

// Treat null as an IO exception, we will eventually retry.

throw new IOException("Failed to decode stream.");

}

return bitmap;

}

}

这里有一个MarkableInputStream是继承InputStream的，复写了其中的几个方法，其中部分代码如下：

public long savePosition(int readLimit) {

long offsetLimit = offset + readLimit ;

if (limit < offsetLimit) {

setLimit( offsetLimit);

}

return offset;

}

private void setLimit( long limit ) {

try {

if (reset < offset && offset <= this.limit ) {

in.reset();

in.mark(( int) (limit - reset ));

skip( reset, offset);

} else {

reset = offset;

in.mark(( int) (limit - offset ));

}

this. limit = limit;

} catch (IOException e) {

throw new IllegalStateException( "Unable to mark: " + e );

}

}

public void reset(long token ) throws IOException {

if (offset > limit || token < reset) {

throw new IOException("Cannot reset" );

}

in.reset();

skip(reset, token);

offset = token;

}

@Override public int read() throws IOException {

int result = in.read();

if (result != -1) {

offset++;

}

return result;

}

@Override public int read(byte [] buffer ) throws IOException {

int count = in.read(buffer);

if (count != -1) {

offset += count;

}

return count;

}

@Override public int read(byte [] buffer , int offset, int length) throws IOException {

int count = in.read(buffer, offset, length);

if (count != -1) {

this. offset += count;

}

return count;

}

从上面的代码可以看出，MarkableInputStream在read的时候会动态改变offset的值。

我们回到decodeStream()函数，代码(1)为markStream设定了一个值，经过MarkableInputStream的savePosition()和setLimit()函数，MarkableInputStream的类变量limit被赋值65536。代码(4)这里有读取操作，所以MarkableInputStream的类变量offset会改变，而代码(5)则调用MarkableInputStream的reset()函数，这个方法中先比较offset和limit，如果offset比limit大会抛出错误，加载过程就停止了，加载出错。

问题就出现在这里：

1、在正常的手机上，代码(4)执行完毕，由于options的inJustDecodeBounds为true，所以只读取图片的信息部分，offset这个变量的值也没有很大，比65536小，所以代码(5)的reset方法会正常执行，会正常加载本地图片。

2、但是在部分手机上，代码(4)执行完毕，offset这个变量的值远远比65536大，所以reset方法会抛出异常，加载出错，显示error图片。

这样我们就得出了结论：

在部分手机上，BitmapFactory. decodeStream(stream, null, options);这个方法的实现可能有差别，导致了问题的出现。

同时我们在代码(2)处可以看到，如果是本地图片而且是5.0以上版本，才走else流程，既有问题的代码。而且在代码(3)处则判断是否压缩，如果压缩才会走代码(4)到(5)，否则不走这部分，就不会出错。这就解释了这个问题为什么会有如此出现机制。

最简单的解决方法：

使用it.sephiroth.android.library.picasso:picasso:2.5.2.4b这个版本，这个版本修复了这个bug。(注意Picasso官方版本一直停留在2.5.2这个版本，但是这个版本有几个问题，所以尽量使用2.5.2.4b这个可能是非官方维护的版本)

那么这个问题到底如何解决的？我们来看看2.5.2.4b的源码。

主要的处理方法是MarkableInputStream的每个read方法中添加一个limit的处理，如下：

public int read() throws IOException {

if (!this.allowExpire && this.offset + 1L > this.limit) {

this .setLimit(this.limit + ( long)this .limitIncrement);

}

int result = this.in.read() ;

if(result != - 1) {

++this .offset;

}

return result;

}

public int read(byte [] buffer) throws IOException {

if (!this.allowExpire && this.offset + (long )buffer.length > this.limit) {

this .setLimit(this.offset + ( long)buffer.length + (long)this .limitIncrement);

}

int count = this.in.read(buffer) ;

if(count != - 1) {

this .offset += (long)count ;

}

return count;

}

public int read(byte [] buffer, int offset , int length) throws IOException {

if (!this.allowExpire && this.offset + (long )length > this.limit) {

this .setLimit(this.offset + ( long)length + (long)this .limitIncrement);

}

int count = this.in.read(buffer , offset, length);

if(count != - 1) {

this .offset += (long)count ;

}

return count;

}

可以看见，在每个read方法开始都会坐下判断并重新为limit赋值，这样limit就不是65536这样的固定值了。也保证了正常情况下offset比limit小，不会再reset方法中抛出错误了。

而且这个版本可以自动添加"file"协议，所以本地图片使用url方式的时候，不必使用"file://"+ path这种形式，直接使用path即可。2.5.2.4b处理的方法如下：

RequestCreator(Picasso picasso , Uri uri, int resourceId) {

if (picasso.shutdown) {

throw new IllegalStateException("Picasso instance already shut down. Cannot submit new requests.") ;

} else {

if (null != uri) {

String scheme = uri.getScheme();

if( null == scheme) {

uri = Uri.fromFile(new File(uri.getPath())) ;

}

}

this .picasso = picasso;

this.data = new Builder(uri, resourceId, picasso.defaultBitmapConfig) ;

this.data.setCache(picasso.getCache()) ;

}

}

可以看到，如果uri没有协议，则自动添加"file"协议。

本篇内容就这样了，在picasso 2.5.2版本还存在一个问题：在Android 5.0以下版本加载https图片出错，如果你遇到了这个问题，请阅读解决Picasso在Android 5.0以下版本不兼容https导致图片不显示这篇文章。