react-native-pdf-excel-file-downloader

react-native-pdf-excel-file-downloader is a React Native utility component designed for easy file downloading across iOS and Android platforms.

Features

• 📂 Download Files: Supports downloading files with various formats like PDF, Word, Excel, images, etc.
• 🖥️ Platform Support: Works on both Android and iOS.
• 🚀 Progress Tracking: Real-time download progress display.
• 🛠️ Customizable: Provides callbacks for download completion, error handling, and progress updates.

Installation

## npm i pdf-excel-downloader react-native-blob-util 
## npm i pdf-excel-downloader react-native-blob-util  --force

iOS Configuration

Add the following permissions to your Info.plist file for iOS:

<key>NSPhotoLibraryUsageDescription</key>
<string>Permission to save downloaded files to your photo library.</string>
<key>NSDocumentDirectoryUsageDescription</key>
<string>Permission to save downloaded files to your document directory.</string>

<key>UIFileSharingEnabled</key> <true/> <key>LSSupportsOpeningDocumentsInPlace</key> <true/>

then run pod install or pod 'react-native-blob-util'

Android Configuration

Ensure the following permissions are added to your AndroidManifest.xml:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

Basic Usage

Here is an example of how to integrate DownloadFileComponent into your React Native project:

import React from 'react';
import { View, Button, Text } from 'react-native';
import {Downloader} from 'pdf-excel-downloader';

const Main = () => {
  
const fileUrl = 'https://morth.nic.in/sites/default/files/dd12-13_0.pdf';  // Replace with your file URL

  const handleDownloadComplete = (filePath) => {
    console.log('Download complete! File saved at:', filePath);
  };

  const handleError = (error) => {
    console.error('Download failed:', error);
  };

  const handleProgress = (progress) => {
    console.log(`Download progress: ${progress}%`);
  };

  const { downloadFile, downloading, downloadProgress } = Downloader({
    fileUrl,
    showProgress: true,
    onDownloadComplete: handleDownloadComplete,
    onError: handleError,
    onProgress: handleProgress,
  });

  return (
    <View>
      <Button
        title="Download File"
        onPress={downloadFile}
        disabled={downloading}
      />
      {downloading && <Text>Progress: {downloadProgress}%</Text>}
    </View>
  );
};

export default Main;

Example Callbacks

• onDownloadComplete(path): Invoked when the download finishes, providing the saved file's path.
• onError(error): Invoked if there’s an error during the download.
• onProgress(percentage): Updates the download progress percentage.

API

Props

| Prop |Type|Description| |----------------|-------------------------------|-----------------------------| |fileUrl |String |he URL of the file to download. | |showProgress |Boolean |Whether to display download progress or not. | |onDownloadComplete |Function|Callback invoked when the download is complete. It receives the file path as a parameter.| |onError |Function|Callback invoked if an error occurs during the download process.| |onProgress |Function|Callback invoked during download to show progress (percentage).|

License

MIT License.