expo-file-system/plugin/src/withFileSystem.ts

Provides access to the local file system on the device.

import {
  AndroidConfig,
  ConfigPlugin,
  createRunOncePlugin,
  withInfoPlist,
} from 'expo/config-plugins';

const pkg = require('../../package.json');

export type FileSystemProps = {
  /**
   * Whether to enable `LSSupportsOpeningDocumentsInPlace`, allowing the app to open documents in place.
   * @platform ios
   */
  supportsOpeningDocumentsInPlace?: boolean;
  /**
   * Whether to enable `UIFileSharingEnabled`, making the app's Documents directory accessible through the Files app.
   * @platform ios
   */
  enableFileSharing?: boolean;
};

const withFileSystem: ConfigPlugin<FileSystemProps> = (config, options = {}) => {
  // Apply Android permissions
  config = AndroidConfig.Permissions.withPermissions(config, [
    'android.permission.READ_EXTERNAL_STORAGE',
    'android.permission.WRITE_EXTERNAL_STORAGE',
    'android.permission.INTERNET',
  ]);

  // Apply iOS modifications
  return withInfoPlist(config, (config) => {
    if ('supportsOpeningDocumentsInPlace' in options) {
      config.modResults.LSSupportsOpeningDocumentsInPlace = options.supportsOpeningDocumentsInPlace;
    }
    if ('enableFileSharing' in options) {
      config.modResults.UIFileSharingEnabled = options.enableFileSharing;
    }
    return config;
  });
};

export default createRunOncePlugin(withFileSystem, pkg.name, pkg.version);