encryption_decryptions #

A powerful Flutter plugin for secure encryption and decryption of API responses and requests, built with modern Android, iOS, and Web standards.

✨ Features #

• Cross-Platform: Supports Android, iOS, and Web.
• Secure Data Handling: Encrypt and decrypt various data types (strings, maps, lists, integers, doubles).
• High Performance: Leverages native rncryptor for fast execution (approx. 50ms for large data).
• Enhanced Security: Generates different encrypted outputs for the same input, making data prediction difficult.
• Modern Development Stack: Updated to latest Flutter, Dart, Android Gradle Plugin, Kotlin, and Java versions for optimal performance and compatibility.

🚀 What's New in v3.0.0 #

This major release introduces Full Web Support! 🌐

• Web Support: Now supports encryption and decryption on Flutter Web using crypto-js.
• Latest SDKs: Updated Flutter SDK to >=3.19.0 and Dart SDK to >=3.4.0.
• iOS Platform: Minimum iOS version updated to 13.0.

For detailed changes and migration steps, please refer to the Migration Guide.

Platform Support #

📋 Migration Guide (v2.1.0 to v3.0.0) #

Requirements Check 🔍 Before upgrading, ensure your development environment meets these requirements:

1. Java Development Kit: Change JDK target
2. Flutter SDK: Update to Flutter 3.19.0+ (run flutter upgrade)
3. Dart SDK: Update to Dart 3.4.0+ (comes with Flutter 3.19.0+)
4. Android Studio: Update to latest version for optimal Kotlin DSL support

For Existing Android Projects 🔧 If you're using this plugin in existing Android projects, you may need to:

1. Update your app's minimum SDK (optional but recommended):

   android {
       defaultConfig {
           minSdk 21  // Was 16, now 21 for modern features
       }
   }
   

2. Update your project's Gradle (if experiencing build issues):

   // In android/gradle/wrapper/gradle-wrapper.properties
   distributionUrl=https\\://services.gradle.org/distributions/gradle-8.14-all.zip
   

3. AndroidManifest.xml Update: If you encounter build issues with label conflicts, add the following:
   • Add tools:replace="android:label" inside your <application> tag.
   • Add xmlns:tools="http://schemas.android.com/tools" to your <manifest> tag.

No Code Changes Required ✅ Your existing encryption/decryption code remains 100% compatible. All API methods work exactly the same; no changes are needed in your Flutter/Dart code.

⚠️ Important Notes #

• Data Integrity: Ensure that data (maps/lists) you are encrypting or decrypting does not contain null values. This plugin does not handle null values in complex data structures, which may lead to unexpected behavior.

Usage #

Add the plugin to your pubspec.yaml:

dependencies:
  encryption_decryptions: ^3.0.0

Then, run flutter pub get.

Here's an example of how to use the plugin:

import 'dart:convert';
import 'package:encryption_decryptions/encryption_decryptions.dart';

void main() async {
  final EncryptionDecryptions encryptionDecryptions = EncryptionDecryptions();
  final String encryptionKey = "hnbTojntU7u";

  // Example with String data
  String plainString = "Hello, secure world!";
  print('Original String: $plainString');

  String? encryptedString = await encryptionDecryptions.encryptSring(
    data: plainString,
    key: encryptionKey,
  );
  print('Encrypted String: $encryptedString');

  String? decryptedString = await encryptionDecryptions.decryptString(
    data: encryptedString!,
    key: encryptionKey,
  );
  print('Decrypted String: $decryptedString');

  // Example with Map data
  Map<String, dynamic> plainMap = {
    "user": "Alice",
    "email": "[email protected]",
    "age": 30,
    "isActive": true,
  };
  print('\\nOriginal Map: \$plainMap');

  // Encode your map to JSON string before encrypting
  String jsonString = jsonEncode(plainMap);
  String? encryptedMapString = await encryptionDecryptions.encryptSring(
    data: jsonString, // Encrypt the JSON string
    key: encryptionKey,
  );
  print('Encrypted Map String: \$encryptedMapString');

  // Decrypt the string and then decode back to Map
  String? decryptedMapString = await encryptionDecryptions.decryptString(
    data: encryptedMapString!,
    key: encryptionKey,
  );
  Map<String, dynamic> decryptedMap = jsonDecode(decryptedMapString!);
  print('Decrypted Map: \$decryptedMap');

  // Alternatively, use encryptMap and decryptMap directly for Map data
  // NOTE: For Web platform, you might still need to handle JSON encoding/decoding manually
  // for complex objects when using JavaScript interop.
  String? encryptedComplexMap = await encryptionDecryptions.encryptMap(
    data: plainMap,
    key: encryptionKey,
  );
  print('Encrypted Complex Map String: \$encryptedComplexMap');

  Map<dynamic, dynamic>? decryptedComplexMap = await encryptionDecryptions.decryptMap(
    data: encryptedComplexMap!,
    key: encryptionKey,
  );
  print('Decrypted Complex Map: \$decryptedComplexMap');
}

📊 Version Comparison (v2.1.0 vs v3.0.0) #

📝 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📞 Support #

• GitHub Issues: Report bugs or request features
• Homepage: Package Homepage
• pub.dev: Package on pub.dev

☕ Support My Work #

If you find this plugin helpful and would like to support my work, you can buy me a coffee! Your support helps me to continue developing and maintaining useful Flutter packages.

Made with ❤️ for the Flutter community