winziyuan / sketch

Sketch是Android上一个强大且全面的图片加载器，支持GIF，手势缩放以及分块显示超大图片。Sketch is a powerful and comprehensive image loader on Android, with support for GIF, gesture zooming, block display super large image

Sketch Image Loader

English version of the README.md

Sketch 是 Android 上一款强大且全面的图片加载器，除了图片加载的必备功能外，还支持 GIF，手势缩放、分块显示超大图片、自动纠正图片方向、显示视频缩略图等功能

示例 APP

扫描二维码下载示例 APP，也可点击直接下载（Click download APK）

支持的特性

• 多种URI支持. 支持http://或https://、asset://、content://、file:///sdcard/sample.jpg或/sdcard/sample.jpg、drawable://、data:image/或data:img/等6种URI
• 支持gif图. 集成了android-gif-drawable 1.2.6可以方便的显示gif图片，感谢koral--
• 支持手势缩放. 支持手势缩放功能，在PhotoView的基础上进行了优化，增加了滚动条，定位等功能
• 支持分块显示超大图. 支持分块显示超大图功能，从此再大的图片也不怕了
• 支持三级缓存. 通过LruMemoryCache、LruDiskCache复用图片，加快显示时间；通过LruBitmapPool复用Bitmap，减少因GC而造成的卡顿
• 支持纠正图片方向. 可纠正方向不正的图片，并且分块显示超大图功能也支持，仅限jpeg格式的图片
• 支持读取APK图标. 支持直接读取本地APK文件的图标或根据包名和版本号读取已安装APP的图标
• 支持Base64图片. 支持解析 Base64 格式的图片
• 支持各种列表. 在各种列表（ListView、RecyclerView）中循环使用不错位，并且不占用setTag()方法
• 自动防止加载过大Bitmap 可通过maxSize来控制加载到内存的图片的尺寸，默认为ImageView的layout_width和layout_height或屏幕的宽高
• 独家TransitionDrawable支持. 独家支持任意尺寸的两张图片使用TransitionDrawable过渡显示，保证不变形
• 只加载或只下载. 除了display()方法可以显示图片之外，你还可以通过load()方法只加载图片到内存中或通过download()方法只下载图片到本地
• 移动网络下暂停下载. 内置了移动网络下暂停下载图片的功能，你只需开启即可
• 自动选择合适的Bitmap.Config. 根据图片的MimeType自动选择合适的Bitmap.Config，减少内存浪费，例如对于JPEG格式的图片就会使用Bitmap.Config.RGB_565解码
• 特殊文件预处理. 通过ImagePreprocessor可对特殊文件（例如多媒体文件）进行预处理，提取出其包含的图片，读取APK文件的图标就是通过这个功能实现的
• 强大且灵活的自定义. 可自定义下载、缓存、解码、处理、显示、占位图等各个环节

支持的URI

Type	Scheme	Method In SketchImageView
File in network	http://, https://	displayImage(String)
File in SDCard	/, file://	displayImage(String)
Content Provider	content://	displayContentImage(Uri)
Asset in app	asset://	displayAssetImage(String)
Resource in app	resource://	displayResourceImage(int)
Base64	data:image/, data:/img/	displayImage(String)

支持的图片类型

Image Type	Supported Version
jpeg
png
gif
bmp
webp

开始使用

导入 Sketch

1.在 app 的 build.gradle 文件的 dependencies 节点中加入依赖

compile 'me.xiaopan:sketch:$sketch_version'

请自行替换 $sketch_version 为最新的版本 (不要"v")

如果需要播放 GIF 就添加 sketch-gif 的依赖

compile 'me.xiaopan:sketch-gif:$sketch_gif_version'

请自行替换$sketch_gif_version 为最新的版本 (不要"v")

Android Studio 会自动合并 AAR 中所包含的权限和混淆配置

2.如果需要兼容 API 13 (Android 3.2) 及以下的版本，那么需要在 Application 中调用释放缓存的方法（Android 4.0以上能直接通过Context注册并回调）

public class MyApplication extends Application {    

    @Override
    public void onTrimMemory(int level) {
        super.onTrimMemory(level);

        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
            Sketch.with(getBaseContext()).onTrimMemory(level);
        }
    }

    @Override
    public void onLowMemory() {
        super.onLowMemory();

        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
            Sketch.with(getBaseContext()).onLowMemory();
        }
    }
}

使用 SketchImageView 显示图片

SketchImageView sketchImageView = (SketchImageView) findViewById(R.id.image_main);

// display image from net
sketchImageView.displayImage("http://t.cn/RShdS1f");

// display image from SDCard
sketchImageView.displayImage("/sdcard/sample.jpg");
sketchImageView.displayImage("file:///sdcard/sample.jpg");

// display resource drawable
sketchImageView.displayResourceImage(R.drawable.sample);

// display image from asset
sketchImageView.displayAssetImage("sample.jpg");

// display image from content provider
sketchImageView.displayContentImage(Uri.parse("content://com.android.gallery/last"));

// display base64 image
sketchImageView.displayImage("data:image/jpeg;base,/9j/4QaO...U7T/in//Z");

// display apk/app icon
sketchImageView.displayImage("/sdcard/google_play.apk");
sketchImageView.displayInstalledAppIcon("com.tencent.qq", 210);

更多功能

基础功能：

• SketchImageView 详细使用说明
• 配置 Options
• 管理 Options
• 只加载图片到内存或只下载图片到本地
• 播放 GIF 图片
• 手势缩放、旋转图片
• 分块显示超大图片
• 通过 ShapeSize 在绘制时改变图片的尺寸
• 通过 ImageShaper 在绘制时以圆形、圆角等形状显示图片
• 通过 ImageProcessor 将图片变成高斯模糊的、倒影的
• 通过 ImageDisplayer 以过渡、渐入等方式显示图片
• 通过 MaxSize 控制图片大小
• 通过 Resize 修剪图片尺寸
• 通过 StateImage 灵活的使用各种图片作为 loadingImage
• 了解自动纠正图片方向功能
• 显示视频缩略图

进一步提升用户体验：

• 让任意尺寸的两张图片都能使用 TransitionDrawable 过渡显示
• 通过 thumbnailMode 属性显示更清晰的缩略图
• 通过 cacheProcessedImageInDisk 属性缓存需要复杂处理的图片，提升显示速度
• 移动网络下暂停下载图片，节省流量
• 列表滑动时暂停加载图片，提升流畅度
• 显示 APK 或已安装 APP 的图标
• 通过 ImagePreprocessor 显示特殊文件中的图片（例如视频、MP3）
• 通过 MemoryCacheStateImage 先显示较模糊的图片，然后再显示清晰的图片

更多：

• 了解 inSampleSize 计算规则
• 了解并配置 BitmapPool
• 了解并配置内存缓存
• 了解并配置本地缓存
• 了解并配置 HttpStack
• 监听加载开始、成功、失败以及下载进度
• 了解何时取消请求以及如何主动取消请求
• 通过 ErrorTracker 监控 Sketch 的异常
• 同步输出 Sketch 运行日志到 SD卡
• 延迟配置 Sketch
• 配置混淆（Proguard）

特别感谢

koral - android-gif-drawable

chrisbanes - PhotoView

bumptech - glide （BitmapPool）

联系我

• 

• 

License

Copyright (C) 2013 Peng fei Pan <[email protected]>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.