Android Device | Android Emulator | iOS Device | iOS Simulator | Web |
---|---|---|---|---|
expo install expo-document-picker
If you're installing this in a bare React Native app, you should also follow these additional installation instructions.
usesIcloudStorage
key to true
in your app.json
file as specified here.iCloud.<your_bundle_identifier>
.expo build:ios -c
DocumentPicker
module requires the iCloud entitlement to work properly. If your app doesn't have it already, you can add it by opening the project in Xcode and following these steps:Capabilities
tabon
iCloud Documents
checkboximport * as DocumentPicker from 'expo-document-picker';
Note for Web: The system UI can only be shown after user activation (e.g. aButton
press). Therefore, callinggetDocumentAsync
incomponentDidMount
, for example, will not work as intended.
image/*
to choose any image. To allow any type of document you can use */*
. Defaults to */*
.true
, the picked file is copied to FileSystem.CacheDirectory
, which allows other Expo APIs to read the file immediately. Defaults to true
. This may impact performance for large files, so you should consider setting this to false
if you expect users to pick particularly large files and your app does not need immediate read access.false
.{ type: 'success', uri, name, size }
where uri
is a URI to the local document file, name
is its original name and size
is its size in bytes.
If the user cancelled the document picking, the promise resolves to { type: 'cancel' }
.