pickImage

Pick an image with pickImage.

The pickImage method

The pickImage method takes a source parameter that specifies the image source. ImageSource.gallery picks from the gallery, ImageSource.camera picks from the camera. The method is asynchronous, so you await it with await.

final file = await picker.pickImage(
  source: ImageSource.gallery,
);

User cancellation

If the user goes back without picking an image, pickImage returns null. Therefore you must check for null before using the returned value. Otherwise a null error is thrown.

final file = await picker.pickImage(
  source: ImageSource.gallery,
);
if (file == null) return;

Exercise Pick an image from the gallery

Create an ImagePicker, pick an image with pickImage from ImageSource.gallery and print the file path.

Show example solution

enum ImageSource { gallery, camera }

class XFile {
  final String path;
  XFile(this.path);
}

class ImagePicker {
  Future<XFile?> pickImage({required ImageSource source}) async {
    return XFile('/tmp/picked.png');
  }
}

void main() async {
  final picker = ImagePicker();
  final file = await picker.pickImage(source: ImageSource.gallery);
  print(file!.path);
}

Test yourself

What does ImageSource.camera specify?
- Downloading an image from a URL
- Capturing an image from the camera
- Picking an image from the gallery
- Deleting a file path
Show answer

Capturing an image from the camera — ImageSource.camera specifies capturing an image from the camera; ImageSource.gallery is used to pick from the gallery.

Specify the source

final file = await picker.pickImage(
  source: ____,
);

Show answer

final file = await picker.pickImage(
  source: ImageSource.gallery,
);

pickImage parts

pickImage

Picks an image
source

Source parameter
ImageSource.gallery

Gallery source
ImageSource.camera

Camera source

Next lesson: Camera plugin

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies