# path_provider 1.6.16 Flutter plugin for getting commonly used locations on host platform file systems, such as the temp and app data directories. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir flutter pub add 'path_provider:1.6.16' ``` Published: 2020-09-18T19:06:34.437303Z Expected archive SHA-256: 965977f53f125c74af96e8373046871374ce34dd0c50f0dafb5ac64be6f4f436 Available in cache; verification: upstream_checksum ## Direct dependencies - flutter: map[sdk:flutter] - path_provider_linux: ^0.0.1 - path_provider_macos: ^0.0.4 - path_provider_platform_interface: ^1.0.1 - path_provider_windows: ^0.0.2 ## Package README (untrusted upstream documentation) # path_provider [![pub package](https://img.shields.io/pub/v/path_provider.svg)](https://pub.dartlang.org/packages/path_provider) A Flutter plugin for finding commonly used locations on the filesystem. Supports iOS, Android, Linux and MacOS. Not all methods are supported on all platforms. ## Usage To use this plugin, add `path_provider` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/). ### Example ``` dart Directory tempDir = await getTemporaryDirectory(); String tempPath = tempDir.path; Directory appDocDir = await getApplicationDocumentsDirectory(); String appDocPath = appDocDir.path; ``` Please see the example app of this plugin for a full example. ### Usage in tests `path_provider` now uses a `PlatformInterface`, meaning that not all platforms share the a single `PlatformChannel`-based implementation. With that change, tests should be updated to mock `PathProviderPlatform` rather than `PlatformChannel`. See this `path_provider` [test](https://github.com/flutter/plugins/blob/master/packages/path_provider/path_provider/test/path_provider_test.dart) for an example. ## Changelog ## 1.6.16 * Update Windows endorsement verison ## 1.6.15 * Endorse Windows implementation. * Remove the need to call disablePathProviderPlatformOverride in tests ## 1.6.14 * Update package:e2e -> package:integration_test ## 1.6.13 * Update package:e2e reference to use the local version in the flutter/plugins repository. ## 1.6.12 * Fixed a Java lint in a test. ## 1.6.11 * Updated documentation to reflect the need for changes in testing for federated plugins ## 1.6.10 * Linux implementation endorsement ## 1.6.9 * Post-v2 Android embedding cleanups. ## 1.6.8 * Update lower bound of dart dependency to 2.1.0. ## 1.6.7 * Remove Android dependencies fallback. * Require Flutter SDK 1.12.13+hotfix.5 or greater. * Fix CocoaPods podspec lint warnings. ## 1.6.6 * Replace deprecated `getFlutterEngine` call on Android. ## 1.6.5 * Remove unused class name in pubspec. ## 1.6.4 * Endorsed macOS implementation. ## 1.6.3 * Use `path_provider_platform_interface` in core plugin. ## 1.6.2 * Move package contents into `path_provider` for platform federation. ## 1.6.1 * Make the pedantic dev_dependency explicit. ## 1.6.0 * Support for retrieving the downloads directory was added. The call for this is `getDownloadsDirectory`. ## 1.5.1 * Remove the deprecated `author:` field from pubspec.yaml * Migrate the plugin to the pubspec platforms manifest. * Require Flutter SDK 1.10.0 or greater. ## 1.5.0 * Add macOS support. ## 1.4.5 * Add support for v2 plugins APIs. ## 1.4.4 * Update driver tests in the example app to e2e tests. ## 1.4.3 * Update driver tests in the example app to e2e tests. * Add missing DartDocs and a lint to prevent further regressions. ## 1.4.2 * Update and migrate iOS example project by removing flutter_assets, change "English" to "en", remove extraneous xcconfigs, update to Xcode 11 build settings, remove ARCHS, and build pods as libraries instead of frameworks. ## 1.4.1 * Remove AndroidX warnings. ## 1.4.0 * Support retrieving storage paths on Android devices with multiple external storage options. This adds a new class `AndroidEnvironment` that shadows the directory names from Androids `android.os.Environment` class. * Fixes `getLibraryDirectory` semantics & tests. ## 1.3.1 * Define clang module for iOS. ## 1.3.0 * Added iOS-only support for `getLibraryDirectory`. * Update integration tests and example test. * Update example app UI to use a `ListView` show the list of content. * Update .gitignore to include Xcode build output folder `**/DerivedData/` ## 1.2.2 * Correct the integration test for Android's `getApplicationSupportDirectory` call. * Introduce `setMockPathProviderPlatform` for API for tests. * Adds missing unit and integration tests. ## 1.2.1 * Fix fall through bug. ## 1.2.0 * On Android, `getApplicationSupportDirectory` is now supported using `getFilesDir`. * `getExternalStorageDirectory` now returns `null` instead of throwing an exception if no external files directory is available. ## 1.1.2 * `getExternalStorageDirectory` now uses `getExternalFilesDir` on Android. ## 1.1.1 * Cast error codes as longs in iOS error strings to ensure compatibility between arm32 and arm64. ## 1.1.0 * Added `getApplicationSupportDirectory`. * Updated documentation for `getApplicationDocumentsDirectory` to suggest using `getApplicationSupportDirectory` on iOS and `getExternalStorageDirectory` on Android. * Updated documentation for `getTemporaryDirectory` to suggest using it for caches of files that do not need to be backed up. * Updated integration tests and example to reflect the above changes. ## 1.0.0 * Added integration tests. ## 0.5.0+1 * Log a more detailed warning at build time about the previous AndroidX migration. ## 0.5.0 * **Breaking change**. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to [also migrate](https://developer.android.com/jetpack/androidx/migrate) if they're using the original support library. ## 0.4.1 * Updated Gradle tooling to match Android Studio 3.1.2. ## 0.4.0 * **Breaking change**. Set SDK constraints to match the Flutter beta release. ## 0.3.1 * Simplified and upgraded Android project template to Android SDK 27. * Updated package description. ## 0.3.0 * **Breaking change**. Upgraded to Gradle 4.1 and Android Studio Gradle plugin 3.0.1. Older Flutter projects need to upgrade their Gradle setup as well in order to use this version of the plugin. Instructions can be found [here](https://github.com/flutter/flutter/wiki/Updating-Flutter-projects-to-Gradle-4.1-and-Android-Studio-Gradle-plugin-3.0.1). ## 0.2.2 * Add FLT prefix to iOS types ## 0.2.1+1 * Updated README ## 0.2.1 * Add function to determine external storage directory. ## 0.2.0 * Upgrade to new plugin registration. (https://groups.google.com/forum/#!topic/flutter-dev/zba1Ynf2OKM) ## 0.1.3 * Upgrade Android SDK Build Tools to 25.0.3. ## 0.1.2 * Add test. ## 0.1.1 * Change to README.md. ## 0.1.0 * Initial Open Source release.