Expo DocumentPicker

expo-document-picker 提供访问系统用户界面的功能，允许从用户设备上的可用提供商中选择文档。

安装

🌐 Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

应用配置中的配置

🌐 Configuration in app config

如果你在项目中使用配置插件（连续原生生成 (CNG)），可以使用其内置的 配置插件 来配置 expo-document-picker。该插件允许你配置无法在运行时设置并且需要构建新的应用二进制文件才能生效的各种属性。如果你的应用不使用 CNG，则需要手动配置该库。

🌐 You can configure expo-document-picker using its built-in config plugin if you use config plugins in your project (Continuous Native Generation (CNG)). 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 CNG, then you'll need to manually configure the library.

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 Build 将使用 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';

Component

Types