A CacheManager to download and cache files in the cache directory of the app. Various settings on how long to keep a file can be changed.
It uses the cache-control http header to efficiently retrieve files.
var cacheManager = await CacheManager.getInstance(); var file = await cacheManager.getFile(url);
Some settings of the CacheManager can be changed. All these preferences are statics and should be set before the first use of the CacheManager, so preferably directly on start of your app.
For extra logging set:
CacheManager.showDebugLogs = true;
The cache can be cleaned after it is used to get a file. By default this happens once every week. You can change this by setting
CacheManager.inBetweenCleans = new Duration(days: 7);
The CacheManager checks for two things, for objects that are too old and the size of the cache.
By default it removes objects that haven't been used for 30 days. Set this by
maxAgeCacheObject. *This is not about when the object is first downloaded, but when it is used the last.
CacheManager.maxAgeCacheObject = new Duration(days: 30);
By default the cache size is set to 200, when the cache grows beyond this it will remove the oldest objects again by when last used. Set this with
CacheManager.maxNrOfCacheObjects = 200;
How it works
The cached files are stored in the temporary directory of the app. This means the OS can delete the files any time.
Information about the files is stored in the shared preferences with the key "lib_cached_image_data". (Because images was the first use of this library :)) The date when the cache is last cleaned is stored as "lib_cached_image_data_last_clean".
This cache information contains the end date till when the file is valid and the eTag to use with the http cache-control.
- Built-in types and core primitives for a Flutter application. [...]
- Support for asynchronous programming, with classes such as Future and Stream. [...]
- Classes and utilities that supplement the collection support in dart:core. [...]
- Encoders and decoders for converting between different data representations, including JSON and UTF-8. [...]
- Built-in types, collections, and other core functionality for every Dart program. [...]
- Interact with developer tools such as the debugger and inspector. [...]
- Mathematical constants and functions, plus a random number generator. [...]
- Lists that efficiently handle fixed sized data (for example, unsigned 8 byte integers) and SIMD numeric types. [...]
- File, socket, HTTP, and other I/O support for non-web applications. [...]
- Concurrent programming using isolates: independent workers that are similar to threads but don't share memory, communicating only via messages. [...]