Installation

Install#

flutter pub add magic_picker
dart run magic:dowel plugin:install magic_picker

The installer reads the package's install.yaml and injects PickerServiceProvider into the providers list of lib/config/app.dart. It publishes no config file and adds no config factory: Pick needs no settings.

import 'package:magic_picker/magic_picker.dart';

The barrel is the only import; everything under src/ is private. It also re-exports XFile and CameraDevice from image_picker, because both appear in this package's signatures.

Requirements#

Register the Provider#

plugin:install does this for you. To do it by hand, add the provider to lib/config/app.dart:

import 'package:magic_picker/magic_picker.dart';

final Map<String, dynamic> appConfig = {
  'app': {
    'providers': [
      (app) => PickerServiceProvider(app),
    ],
  },
};

Pick itself is a static facade and works without the provider. The provider has one job: in boot() it sets LocalAdapterContract.downloadHandler, so Storage.download can open the share sheet on mobile, macOS and Windows, and the save dialog on Linux, where share_plus cannot share a file. Without it that call throws on mobile and desktop, see Download.

Verify#

import 'package:magic_picker/magic_picker.dart';

Future<void> main() async {
  final image = await Pick.image();
  print(image?.name ?? 'cancelled');
}

Run it on a device or in a browser. The system gallery opens; choosing an image prints its file name, and dismissing it prints cancelled. The result is a MagicFile, a type that lives in package:magic/magic.dart; import it when you name it.

Related Documentation#

• Pick: every picker and what it returns.
• XFile Conversion: toMagicFile and toXFile.
• Download: the share-sheet download handler.
• Testing: testing code that calls Pick or Storage.download.