flutter_keychain
Flutter secure storage via Keychain (iOS) and Keystore (Android). Supports optional iOS access groups and item labels.
3.0.1
18K downloads/mo
#2310 most downloaded on pub.dev
jeroentrappers/flutter_keychain
What this package is like to depend on
Last release 4 months ago
30 Mar 2026
Release timing varies
gaps range from 2 weeks to 2.1 years
Most releases are documented
notes for 14 of 18 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
18 releases · first in 2018
2 releases in the last 12 months
see the full history below
Release timeline
18 releases · Sep 2018 to Mar 2026Releases
latest 18-
3.0.130 Mar 2026 -
3.0.030 Mar 2026Release notes
Open source →Breaking changes
- Android:
minSdkraised from 16 to 18 (API 18 is the true minimum for AndroidKeyStore). - Android: V1 plugin embedding (
registerWith(Registrar)) removed. - iOS: deployment target raised from 8.0 to 12.0.
Bug fixes
- Android: fix ANR caused by crypto initialisation blocking the main thread.
All KeyStore and AES operations now run on
Dispatchers.IO(fixes #57). - Android: method calls that arrive before async init completes are queued and replayed once the crypto engine is ready.
- Android:
getnow returnsnullinstead of throwing onBadPaddingException/InvalidKeyException, preventing crashes after key rotation or data corruption (fixes #37). - iOS: fix
CFDataRefmemory leak inget:whenSecItemCopyMatchingreturns a non-NULL reference on error.
New features
- Dart: new
FlutterKeychain.configure({accessGroup, label})method. - iOS:
accessGroupsetskSecAttrAccessGroupfor shared keychain access between apps in the same App Group (fixes #48). - iOS:
labelsetskSecAttrLabelso items appear in iOS Passwords (Settings → Passwords) (fixes #43). - iOS: Swift Package Manager support added via
ios/flutter_keychain/Package.swift(fixes #58). CocoaPods remains supported during the transition period.
Build / toolchain updates
- Android: AGP 7.1.2 → 8.3.2;
namespacedeclaration is now unconditional (fixes #46, #41). - Android: Kotlin 1.6.10 → 1.9.25.
- Android:
compileSdk/targetSdk31 → 35. - Android:
kotlinx-coroutines-android 1.7.3added as a dependency.
- Android:
-
2.5.024 Jun 2024Nothing published for this version
-
2.4.001 Oct 2023Nothing published for this version
-
2.3.031 Aug 2023 -
2.2.128 Jul 2022 -
2.1.001 Oct 2021 -
2.0.101 Jun 2021Release notes
Open source →- fix Nullability issue in the Kotlin code thanks https://github.com/wbusey0 for the PR.
-
2.0.012 Apr 2021Release notes
Open source →- Migrate to null-safety
- Minimum Dart SDK 2.12.0 thanks https://github.com/wbusey0 for the PR.
-
1.0.005 Mar 2019 -
0.0.809 Nov 2018 -
0.0.722 Oct 2018 -
0.0.609 Oct 2018Release notes
Open source →- Added commit to delete and clear for android.
- Updated xcode example project, because of duplicate framework (new version of flutter)
-
0.0.516 Sep 2018Nothing published for this version
-
0.0.416 Sep 2018Nothing published for this version
-
0.0.316 Sep 2018 -
0.0.212 Sep 2018 -
0.0.104 Sep 2018