react-native-open-doc v2.1.4

react-native-open-doc

Open files stored on device for preview - Android and iOS.

Pick files using native file pickers for iOS and Android (UIDocumentPickerViewController / Intent.ACTION_OPEN_DOCUMENT)

Share files on Android (for iOS use the react-native Share.share({ url: selectedUri }) api).

Getting started

$ npm install react-native-open-doc --save

Mostly automatic installation

1. $ react-native link react-native-open-doc

2. Define a FileProvider

   Note that the authorities value should be <your package name>.provider, for example:

   <provider
               android:name="android.support.v4.content.FileProvider"
               android:authorities="com.mydomain.provider"
               android:exported="false"
               android:grantUriPermissions="true">
               ...
   </provider>

Manual installation

iOS

1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-open-doc and add RNCOpenDoc.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNCOpenDoc.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)<

Android

1. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.capriza.reactlibrary.RNCOpenDocPackage; to the imports at the top of the file
• Add new RNCOpenDocPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

   include ':react-native-open-doc'
   project(':react-native-open-doc').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-open-doc/android')

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

     implementation project(':react-native-open-doc')

4. Define a FileProvider

Usage

import RNCOpenDoc from 'react-native-open-doc';

RNCOpenDoc.open(pathToFile);
RNCOpenDoc.share(pathToFile);
RNCOpenDoc.pick(null, (error, files) => {
    if (error) {
        console.log(`error in RNCOpenDoc.pick ${error}`);
    }
    else if (files) {
    	this.handleSelectedFiles(files);
    }
});

files is an array of objects with the following properties:

• fileName (string) e.g. "foo.html"
• fileSize (number) (iOS only) File size in bytes
• mimeType (string) (iOS only) e.g. "text/html"
• uri (string) Example (iOS): "file:///private/var/mobile/Containers/Data/Application/.../foo.html"