Expo DocumentPicker

一个库，提供对系统 UI 的访问，以便从用户设备上的可用提供程序中选择文档。

expo-document-picker 提供对系统 UI 的访问，以便从用户设备上的可用提供程序中选择文档。

¥expo-document-picker provides access to the system's UI for selecting documents from the available providers on the user's device.

安装

¥Installation

If you are installing this in an existing React Native app (bare workflow), start by installing expo in your project. Then, follow the additional instructions as mentioned by library's README under "Installation in bare React Native projects" section.

app.json/app.config.js 中的配置

¥Configuration in app.json/app.config.js

如果你在项目中使用配置插件（EAS 构建 或 npx expo run:[android|ios]），则可以使用其内置的 配置插件 配置 expo-document-picker。该插件允许你配置无法在运行时设置的各种属性，并且需要构建新的应用二进制文件才能生效。如果你的应用不使用 EAS Build，则你需要手动配置包。

¥You can configure expo-document-picker using its built-in config plugin if you use config plugins in your project (EAS Build or npx expo run:[android|ios]). The plugin allows you to configure various properties that cannot be set at runtime and require building a new app binary to take effect. If your app does not use EAS Build, then you'll need to manually configure the package.

Example app.json with config plugin

如果要启用 iCloud 存储功能，请按照指定的 配置属性，将 应用配置 文件中的 expo.ios.usesIcloudStorage 键设置为 true。

¥If you want to enable iCloud storage features, set the expo.ios.usesIcloudStorage key to true in the app config file as specified configuration properties.

在本地运行 EAS 构建 将使用 iOS 功能签名 在构建之前启用所需的功能。

¥Running EAS Build locally will use iOS capabilities signing to enable the required capabilities before building.

{
  "expo": {
    "plugins": [
      [
        "expo-document-picker",
        {
          "iCloudContainerEnvironment": "Production"
        }
      ]
    ]
  }
}

Configurable properties

<key>com.apple.developer.icloud-container-identifiers</key>
<array>
    <string>iCloud.dev.expo.my-app</string>
</array>
<key>com.apple.developer.icloud-services</key>
<array>
    <string>CloudDocuments</string>
</array>
<key>com.apple.developer.ubiquity-container-identifiers</key>
<array>
    <string>iCloud.dev.expo.my-app</string>
</array>
<key>com.apple.developer.ubiquity-kvstore-identifier</key>
<string>$(TeamIdentifierPrefix)dev.expo.my-app</string>

与 expo-file-system 一起使用

¥Using with expo-file-system

当 expo-document-picker 与 expo-file-system 一起使用时，文件系统并不总是能够在 expo-document-picker 选择文件后立即读取该文件。

¥When using expo-document-picker with expo-file-system, it's not always possible for the file system to read the file immediately after the expo-document-picker picks it.

要允许 expo-file-system 在选择文件后立即读取文件，你需要确保 copyToCacheDirectory 选项设置为 true。

¥To allow the expo-file-system to read the file immediately after it is picked, you'll need to ensure that the copyToCacheDirectory option is set to true.

API

import * as DocumentPicker from 'expo-document-picker';

Methods

Types