path_manager 0.8.0
path_manager: ^0.8.0 copied to clipboard
Plugin for getting commonly used locations on host file system via FFI
0.8.0 #
- Environment:
- Bump Dart SDK constraint to
^3.14.0and Flutter to>=3.50.0.
- Bump Dart SDK constraint to
- Bindings & Tooling:
- Migrate
ffigenconfiguration intool/ffigen.darttoffigen23.x API. - Optimize Foundation bindings by filtering
NSFileManagermethods, eliminating unnecessary block trampolines and native Objective-C compile dependencies. - Migrate
jnigenconfiguration intool/jnigen.darttojnigen1.x API. - Relocate generated bindings to
lib/bindings/foundation.g.dartandlib/bindings/android.g.dart.
- Migrate
- Fixes & Platform Behavior:
- Throw
UnsupportedErroron iOS forgetDownloadsDirectory()due to Apple sandbox container restrictions.
- Throw
- Refactoring & Modernization:
- Modernize exception classes and
StorageDirectoryenum with concise constructor syntax. - Remove legacy
FoundationFFIwrapper call inFoundationPathManager. - Extract
FakePlatformPathManagerinto a dedicated test helper file.
- Modernize exception classes and
- Example App:
- Upgrade Gradle wrapper to 9.3.1 and Android Gradle Plugin to 9.1.1.
- Update example dependencies and analysis excludes.
0.7.x #
- Features:
- Add
getExternalStorageDirectory()for retrieving primary external storage. - Add
getExternalStorageDirectories({StorageDirectory? type})for typed external storage directories. - Add
getExternalCacheDirectories()for external cache directories. - Add
getDownloadsDirectory()for user/app downloads directory. - Add
StorageDirectoryenum for external directory categorization. - Enhance error messages on failure/misconfiguration with detailed resolution and documentation instructions.
- Add
- Breaking Changes:
- Rename
getCachesDirectory()togetApplicationCacheDirectory()for naming consistency with otherPathManagerdirectory getters and Flutter'spath_provider. - Rename
PlatformPathManager.getCachesPath()toPlatformPathManager.getApplicationCachePath().
- Rename
0.6.1 #
- Export
PlatformPathManagerpublicly to enable custom overrides and mocking in tests. - Add comprehensive unit tests and documentation for testing and mocking path resolution.
0.6.0 #
- Rename
getApplicationNoBackupPathtogetApplicationNoBackupDirectory. - Update
getApplicationNoBackupDirectoryto returnFuture<Directory>instead ofFuture<String>for consistency with other directory methods.
0.5.0 #
- initial release