cache_x 2.2.1 icon indicating copy to clipboard operation
cache_x: ^2.2.1 copied to clipboard

A feasible caching library for Flutter. Save any encrypted string.

CacheX for Flutter #

A feasible caching package for Flutter. Save any data encrypted.

Inspired by CacheX for Android

How does it work ? #

Caching is just a simple key-value pair data saving procedure. CacheX follows the same approach. CacheX uses SharedPreference as storage for caching data. Since we really can't just save the original data because of security issues. CacheX uses AES encryption & decryption behind the scene when you are caching data or fetching data from the cache.

Screenshot from the Example Project after using CacheX #

Getting Started #

First you have to add the package dependency in pubspec.yml

cache_x: ^latest

Get the version from pub.dev

In the main Function of your App #

void main() async {
    WidgetsFlutterBinding.ensureInitialized();

    // Initialize password
    // Passowrd length must be 128/192/256 bits
    // you can use the password of 16 character,24 character or 32 character.
    String password = 'CBoaDQIQAgceGg8dFAkMDBEOECEZCxg=';

    // Initialize CacheX with the password
    await CacheXCore().init(password: password);

    // Do your apps essential works
    // Then anywhere in your app use it to save string
    await CacheXCore.instance.saveString(key: 'ft1', value: 'Tanvir');

    // Get String
    await CacheXCore.instance.getString(key: 'ft1');
}

Also you can save the instance in a variable then use the variable to save or get any data.

// CacheXCore type of variable cacheX
final cacheX = CacheXCore();

// Init the CacheX
await cacheX.init(password: password);

// Save bool
cacheX.saveBool(key: 'dark', value: true);

// Get bool
cacheX.getBool(
  key: 'dark',
  defaultValue: false,
);
⚠ WARNING: If you forget or lost the specified password all the data encrypted with the password will be unusable.

Parse Server #

If you are using parse_server_sdk_flutter in your project you can use CacheX as default coreStore.

Once you have the library added to your project, when you initialize parse_server_sdk_flutter add the CoreStoreCacheXImpl in coreStore...

  • Import CoreStoreCacheXImpl #

import 'package:cache_x/core_store_cacheX_impl.dart';
  • Then initialize parse #

await Parse().initialize(
    appId,
    serverUrl,
    clientKey: clientKey,
    liveQueryUrl: serverUrl,
    coreStore: await CoreStoreCacheXImpl.getInstance(
      password: 'u0TCHVOIiEFVwOqqDo1OnLfd3Kx7yaRt',
    ),
    debug: true,
    autoSendSessionId: true,
  );

N.B If you are using CacheX as default coreStore and already initialized parse with CoreStoreCacheXImpl then you don't have to initialize CacheX again to use CacheX as local storage. You can start saving and getting data.

// Then anywhere in your app use it to save
await CacheXCore.instance.saveString(key: 'ft1', value: 'Tanvir');
// Get
await CacheXCore.instance.getString(key: 'ft1');

Available Methods #

  • Save Methods #

➣ saveBool(String key, bool value)
➣ saveDouble(String key, double value)
➣ saveInt(String key, int value)
➣ saveString(String key, String value)
➣ saveStringList(String key, List<String> value)
  • Get Methods #

➣ getBool(String key)
➣ getDouble(String key)
➣ getInt(String key)
➣ getString(String key)
➣ getStringList(String key)
➣ getKeys()
➣ containsKey(String key)
  • Remove Methods #

➣ remove(String key)
➣ clear()

Important things to keep in mind #

  • The password must be 128/192/256 bits. It means the password only can be 16 character,24 character or 32 character in length. Otherwise it will throw exception.
  • Provide defaultValue in the get methods or else the default value will be null. If the key is not found or the data is not the right type it return the defaultValue.
  • All the save methods will return Future<bool> so to get the value you have to use await
  • It will throw exception if there any.

Exceptions in the Package #

  • CacheXException
    • If there any exception in the CacheXCore or the CacheXCore is not initialized properly it will throw CacheXException exception. The exception message starts with CacheXException:.
  • StorageException
    • If there any exception saving or getting data it will throw StorageException. The exception message starts with String StorageException:.
  • EncryptionException
    • If there any exception encrypting or decrypting the data it will throw EncryptionException. The exception message will start with String EncryptionException:.

Other Projects #

TransitionX, Rounded Button, CacheX