image_picker 0.8.1+2
image_picker: ^0.8.1+2 copied to clipboard
Flutter plugin for selecting images from the Android and iOS image library, and taking new pictures with the camera.
Image Picker plugin for Flutter #
A Flutter plugin for iOS and Android for picking images from the image library, and taking new pictures with the camera.
Installation #
First, add image_picker
as a dependency in your pubspec.yaml file.
iOS #
Starting with version 0.8.1 the iOS implementation uses PHPicker to pick (multiple) images on iOS 14 or higher. As a result of implementing PHPicker it becomes impossible to pick HEIC images on the iOS simulator in iOS 14+. This is a known issue. Please test this on a real device, or test with non-HEIC images until Apple solves this issue.63426347 - Apple known issue
Add the following keys to your Info.plist file, located in <project root>/ios/Runner/Info.plist
:
NSPhotoLibraryUsageDescription
- describe why your app needs permission for the photo library. This is called Privacy - Photo Library Usage Description in the visual editor.NSCameraUsageDescription
- describe why your app needs access to the camera. This is called Privacy - Camera Usage Description in the visual editor.NSMicrophoneUsageDescription
- describe why your app needs access to the microphone, if you intend to record videos. This is called Privacy - Microphone Usage Description in the visual editor.
Android #
Starting with version 0.8.1 the Android implementation support to pick (multiple) images on Android 4.3 or higher.
No configuration required - the plugin should work out of the box.
It is no longer required to add android:requestLegacyExternalStorage="true"
as an attribute to the <application>
tag in AndroidManifest.xml, as image_picker
has been updated to make use of scoped storage.
Note: Images and videos picked using the camera are saved to your application's local cache, and should therefore be expected to only be around temporarily. If you require your picked image to be stored permanently, it is your responsibility to move it to a more permanent location.
Example #
import 'package:image_picker/image_picker.dart';
...
final PickedFile? pickedFile = await picker.getImage(source: ImageSource.camera);
...
Handling MainActivity destruction on Android #
Android system -- although very rarely -- sometimes kills the MainActivity after the image_picker finishes. When this happens, we lost the data selected from the image_picker. You can use retrieveLostData
to retrieve the lost data in this situation. For example:
Future<void> retrieveLostData() async {
final LostData response =
await picker.getLostData();
if (response.isEmpty) {
return;
}
if (response.file != null) {
setState(() {
if (response.type == RetrieveType.video) {
_handleVideo(response.file);
} else {
_handleImage(response.file);
}
});
} else {
_handleError(response.exception);
}
}
There's no way to detect when this happens, so calling this method at the right place is essential. We recommend to wire this into some kind of start up check. Please refer to the example app to see how we used it.
On Android, getLostData
will only get the last picked image when picking multiple images, see: #84634.
Deprecation warnings in pickImage
, pickVideo
and LostDataResponse
#
Starting with version 0.6.7 of the image_picker plugin, the API of the plugin changed slightly to allow for web implementations to exist.
The old methods that returned dart:io
File objects were marked as deprecated, and a new set of methods that return PickedFile
objects were introduced.
How to migrate from to ^0.6.7 #
Instantiate the ImagePicker
The new ImagePicker API does not rely in static methods anymore, so the first thing you'll need to do is to create a new instance of the plugin where you need it:
final _picker = ImagePicker();
Call the new methods
The new methods receive the same parameters as before, but they return a PickedFile
, instead of a File
. The LostDataResponse
class has been replaced by the LostData
class.
Old API | New API |
---|---|
File image = await ImagePicker.pickImage(...) |
PickedFile image = await _picker.getImage(...) |
File video = await ImagePicker.pickVideo(...) |
PickedFile video = await _picker.getVideo(...) |
LostDataResponse response = await ImagePicker.retrieveLostData() |
LostData response = await _picker.getLostData() |
PickedFile
to File
If your app needs dart:io File
objects to operate, you may transform PickedFile
to File
like so:
final pickedFile = await _picker.getImage(...);
final File file = File(pickedFile.path);
You may also retrieve the bytes from the pickedFile directly if needed:
final bytes = await pickedFile.readAsBytes();
Getting ready for the web platform
Note that on the web platform (kIsWeb == true
), File
is not available, so the path
of the PickedFile
will point to a network resource instead:
if (kIsWeb) {
image = Image.network(pickedFile.path);
} else {
image = Image.file(File(pickedFile.path));
}
Alternatively, the code may be unified at the expense of memory utilization:
image = Image.memory(await pickedFile.readAsBytes())
Take a look at the changes to the example
app introduced in version 0.6.7 to see the migration steps applied there.