本文翻译自pub: flutter_cache_manager | Flutter Package (flutter-io.cn)
译时版本: flutter_cache_manager 3.3.0
v2的破坏性改动
CacheManager v2 当配置自定义 CacheManager 时引入了一些破坏性改动。 查看页面最下方改动的说明
flutter_cache_manager
CacheManager 用于下载和缓存应用缓存目录中的文件。 缓存多长时间可通过各种设置来修改。 它使用 Cache-Control HTTP 头部来高效提取文件。
这里有一个更基础的用法的说明。更多信息参考完整文档。
用法
CacheManager 可用多种方式获取一个文件。获取单个文件最简单的方式是调用 .getSingleFile
。
var file = await DefaultCacheManager().getSingleFile(url);
getFileStream(url)
返回一个流,第一个结果是要缓存的文件,之后是要下载的文件。
getFileStream(url, withProgress: true)
withProgress 设为 true ,当缓存中找不到文件时,流会触发下载进程。
downloadFile(url)
直接从网络下载。
getFileFromCache
只从缓存提取,如果缓存里没有文件,会返回 no file (没有文件)。
putFile
提供选项用于向缓存中添加一个新文件而不下载它。
removeFile
从缓存中移除一个文件。
emptyCache
从缓存中移除所有文件。
ImageCacheManager (图片缓存管理器)
如果对 CacheManager 使用了 ImageCacheManager mixin(DefaultCacheManager 默认已使用),就可以自由使用下面的 getImageFile
方法:
Stream<FileResponse> getImageFile(String url, {
String key,
Map<String, String> headers,
bool withProgress,
int maxHeight, // This is extra
int maxWidth, // This is extra as well
})
URL 获取的图像从根据配置参数调整大小,调整大小后的图像会被存储到缓存中。通常它会保持现有的图片比例。 如果使用其它 高度/宽度 参数,原始图像也会被缓存并用于调整。
其它实现
如果你的文件存储在 Firebase Storage 上,可以使用 flutter_cache_manager_firebase 。
自定义
缓存管理器可以通过创建一个新的 CacheManager 来管理。 不要用相同的 key 创建多于一个的 CacheManager ,它们会彼此冲突,这点非常重要。 在这下面的例子中,管理器作为单例创建,但你可以用于示例的 Provider 以在应用的顶级提供一个 CacheManager。下面的例子中有用于文件最大世代、对象最大数量和自定义文件服务的设置。 构造方法的 key 参数是强制的,其它所有变量都是可选的。
class CustomCacheManager {
static const key = 'customCacheKey';
static CacheManager instance = CacheManager(
Config(
key,
stalePeriod: const Duration(days: 7),
maxNrOfCacheObjects: 20,
repo: JsonCacheInfoRepository(databaseName: key),
fileSystem: IOFileSystem(key),
fileService: HttpFileService(),
),
);
}
常见问题
缓存文件如何存储?
默认情况下,缓存的文件存储在应用的缓存目录中。这意味着操作系统会随时删除文件。
文件的信息在 Android 、 iOS 和 macOS 中存储在 sqflite 数据库中,在其它平台存储在普通的 JSON 文件中。数据库的文件名是 cacheManager 的 key ,这也是它必须唯一的原因。
缓存的文件何时更新?
一个有效的 URL 响应应该包含一个 Cache-Control header(头部)。关于 header 的更多信息查看这里,但是总的来说,它表示保持最新状态的期望时长。这也保存一个 ‘eTag’ ,用于检查(指定的时间之后)文件是否发生改变或者实际上仍然有效。
在检查文件实际上仍然有效时,当调用 getSingleFile
或 getFileStream
时,总是直接返回缓存中的文件。如果根据 Cache-Control headers 判断文件已经过期,管理器会尝试更新文件,并存储一个新的文件到缓存中。当使用 getFileStream
时,更新后的文件也会在流中返回。
缓存的文件何时删除?
文件可以被缓存管理器或操作系统删除。默认情况下,文件存储在缓存目录下,有时会被清掉,例如在 Android 上应用更新时。
缓存管理器使用两个变量来决定何时删除一个文件, maxNrOfCacheObjects
和 stalePeriod
。 缓存知道文件最后被使用的时间。当清空缓存(这会持续发生)时,按最后使用时间排序有很多文件,还有文件超过过期时间很久未被使用的,缓存会删除这些文件。
v2的破坏性变更
- 这里不再需要继承 BaseCacheManager ,可以直接调用构造方法。 BaseCacheManager 现在只是一个接口。 CacheManager 是可以直接使用的实现。
- 构造方法现在需要一个带有一些设定的配置对象,但是一些稍微不同。例如,你想存储文件的系统不只是目录,而是一个文件系统。这使你有更多的自由来决定存储文件的位置。
- 参考自定义中的例子。
最后
分享给大家一份面试题合集。
下面的题目都是在Android交流群大家在面试时遇到的,如果大家有好的题目或者好的见解欢迎分享,楼主将长期维护此帖。
参考解析:郭霖、鸿洋、玉刚、极客时间、腾讯课堂…
内容特点:条理清晰,含图像化表示更加易懂。
内容概要:包括 Handler、Activity相关、Fragment、service、布局优化、AsyncTask相关
、Android 事件分发机制、 Binder、Android 高级必备 :AMS,WMS,PMS、Glide、 Android 组件化与插件化等面试题和技术栈!
Handler 相关知识,面试必问!
常问的点:
Handler Looper Message 关系是什么?
Messagequeue 的数据结构是什么?为什么要用这个数据结构?
如何在子线程中创建 Handler?
Handler post 方法原理?
Android消息机制的原理及源码解析
Android Handler 消息机制
Activity 相关
启动模式以及使用场景?
onNewIntent()和onConfigurationChanged()
onSaveInstanceState()和onRestoreInstanceState()
Activity 到底是如何启动的
启动模式以及使用场景
onSaveInstanceState以及onRestoreInstanceState使用
onConfigurationChanged使用以及问题解决
Activity 启动流程解析
Fragment
Fragment 生命周期和 Activity 对比
Fragment 之间如何进行通信
Fragment的startActivityForResult
Fragment重叠问题
Fragment 初探
Fragment 重叠, 如何通信
Fragment生命周期
Service 相关
进程保活
Service的运行线程(生命周期方法全部在主线程)
Service启动方式以及如何停止
ServiceConnection里面的回调方法运行在哪个线程?
startService 和 bingService区别
进程保活一般套路
关于进程保活你需要知道的一切
Android布局优化之ViewStub、include、merge
什么情况下使用 ViewStub、include、merge?
他们的原理是什么?
ViewStub、include、merge概念解析
Android布局优化之ViewStub、include、merge使用与源码分析
BroadcastReceiver 相关
注册方式,优先级
广播类型,区别
广播的使用场景,原理
Android广播动态静态注册
常见使用以及流程解析
广播源码解析
AsyncTask相关
AsyncTask是串行还是并行执行?
AsyncTask随着安卓版本的变迁
AsyncTask完全解析
串行还是并行
Android 事件分发机制
onTouch和onTouchEvent区别,调用顺序
dispatchTouchEvent, onTouchEvent, onInterceptTouchEvent 方法顺序以及使用场景
滑动冲突,如何解决
事件分发机制
事件分发解析
dispatchTouchEvent, onTouchEvent, onInterceptTouchEvent方法的使用场景解析
Android View 绘制流程
简述 View 绘制流程
onMeasure, onlayout, ondraw方法中需要注意的点
如何进行自定义 View
view 重绘机制
-
Android LayoutInflater原理分析,带你一步步深入了解View(一)
-
Android视图状态及重绘流程分析,带你一步步深入了解View(二)
-
Android视图状态及重绘流程分析,带你一步步深入了解View(三)
-
Android自定义View的实现方法,带你一步步深入了解View(四)
Android Window、Activity、DecorView以及ViewRoot
Window、Activity、DecorView以及ViewRoot之间的关系
Android 的核心 Binder 多进程 AIDL
常见的 IPC 机制以及使用场景
为什么安卓要用 binder 进行跨进程传输
多进程带来的问题
-
AIDL 使用浅析
-
binder 原理解析
-
binder 最底层解析
-
多进程通信方式以及带来的问题
-
多进程通信方式对比
Android 高级必备 :AMS,WMS,PMS
AMS,WMS,PMS 创建过程
-
AMS,WMS,PMS全解析
-
AMS启动流程
-
WindowManagerService启动过程解析
-
PMS 启动流程解析
Android ANR
为什么会发生 ANR?
如何定位 ANR?
如何避免 ANR?
什么是 ANR
如何避免以及分析方法
Android 性能优化之 ANR 详解
Android 内存相关
注意:内存泄漏和内存溢出是 2 个概念
什么情况下会内存泄漏?
如何防止内存泄漏?
-
内存泄漏和溢出的区别
-
OOM 概念以及安卓内存管理机制
-
内存泄漏的可能性
-
防止内存泄漏的方法
Android 屏幕适配
屏幕适配相关名词解析
现在流行的屏幕适配方式
-
屏幕适配名词以及概念解析
-
今日头条技术适配方案
Android 缓存机制
LruCache使用极其原理
-
Android缓存机制
-
LruCache使用极其原理述
Android 性能优化
如何进行 内存 cpu 耗电 的定位以及优化
性能优化经常使用的方法
如何避免 UI 卡顿
-
性能优化全解析,工具使用
-
性能优化最佳实践
-
知乎高赞文章
Android MVC、MVP、MVVM
好几种我该选择哪个?优劣点
任玉刚的文章:设计模式选择
Android Gradle 知识
这俩篇官方文章基础的够用了
必须贴一下官方文档:配置构建
Gradle 提示与诀窍
Gradle插件 了解就好
Gradle 自定义插件方式
全面理解Gradle - 执行时序
-
Gradle系列一
-
Gradle系列二
-
Gradle系列三
RxJava
使用过程,特点,原理解析
RxJava 名词以及如何使用
Rxjava 观察者模式原理解析
Rxjava订阅流程,线程切换,源码分析 系列
OKHTTP 和 Retrofit
OKHTTP完整解析
Retrofit使用流程,机制详解
从 HTTP 到 Retrofit
Retrofit是如何工作的
最流行图片加载库: Glide
郭神系列 Glide 分析
Android图片加载框架最全解析(一),Glide的基本用法
Android图片加载框架最全解析(二),从源码的角度理解Glide的执行流程
Android图片加载框架最全解析(三),深入探究Glide的缓存机制
Android图片加载框架最全解析(四),玩转Glide的回调与监听
Android图片加载框架最全解析(五),Glide强大的图片变换功能
Android图片加载框架最全解析(六),探究Glide的自定义模块功能
Android图片加载框架最全解析(七),实现带进度的Glide图片加载功能
Android图片加载框架最全解析(八),带你全面了解Glide 4的用法
Android 组件化与插件化
为什么要用组件化?
组件之间如何通信?
组件之间如何跳转?
Android 插件化和热修复知识梳理
为什么要用组件化
- Android彻底组件化方案实践
- Android彻底组件化demo发布
- Android彻底组件化-代码和资源隔离
- Android彻底组件化—UI跳转升级改造
- Android彻底组件化—如何使用Arouter
插件化框架历史
深入理解Android插件化技术
Android 插件化和热修复知识梳理
由于篇幅限制,文档的详解资料太全面,细节内容太多,所以只把部分知识点截图出来粗略的介绍,每个小节点里面都有更细化的内容!
好啦,这份资料就给大家介绍到这了,有需要详细文档的小伙伴,可以微信扫下方二维码免费领取哈~