npmpackage.info

Gathering detailed insights and metrics for cordova-plugin-file-opener2-safe

Other packages similar to cordova-plugin-file-opener2-safe

cordova-plugin-file-safe-opener2

3.0.8

A File Opener Plugin for Cordova. (The Original Version)

cordova-plugin-file-opener2-safe

A File Opener Plugin for Cordova (removed unnecessary permissions)

3.0.6

MIT

JavaScript

44.86 kB

3,073

Installations

npm install cordova-plugin-file-opener2-safe

Developer Guide

BETA

Typescript

No

Module System

N/A

Node Version

14.20.0

NPM Version

6.14.17 Score

71.1

Supply Chain

99.3

Quality

75.2

Maintenance

100

Vulnerability

99.6

License

Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Contributors

Unable to fetch Contributors

View all 1 contributors

Languages

JavaScript

Java

Objective-C

JavaScript (44.01%)

Java (30.35%)

Objective-C (25.64%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

rayvnas

Download Statistics

Total Downloads

3,073

Last Day

Last Week

Last Month

112

Last Year

1,163

GitHub Statistics

259 Commits

1 Branches

1 Contributors

Maintainers

Package Meta Information

Latest Version

3.0.6

Package Id

cordova-plugin-file-opener2-safe@3.0.6

Unpacked Size

44.86 kB

Size

12.79 kB

File Count

NPM Version

6.14.17

Node Version

14.20.0

Total Downloads

Cumulative downloads

Total Downloads

3,073

Last day

100%

Compared to previous day

Last week

-84.1%

Compared to previous week

Last month

-47.4%

112

Compared to previous month

Last year

-2.9%

1,163

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

No dependencies detected.

Versions

A File Opener Plugin for Cordova

This plugin will open a file on your device file system with its default application.

1cordova.plugins.fileOpener2.open(
2    filePath,
3    fileMIMEType,
4    {
5        error : function(){ },
6        success : function(){ }
7    }
8);

Installation

1$ cordova plugin add cordova-plugin-file-opener2

Optional variables

This plugin requires the Android support library v4. From release 2.1.0 the version of this can be set at installation. The minimum version is 24.1.0. Default value is 27.+. Check out the latest version.

1$ cordova plugin add cordova-plugin-file-opener2  --variable ANDROID_SUPPORT_V4_VERSION="27.+"

If you are using the cordova-android-support-gradle-release plugin it should match the value you have set there.

Requirements

The following platforms and versions are supported by the latest release:

Android 4.4+ / iOS 9+ / Windows / Electron
Cordova CLI 7.0 or higher

Cordova CLI 6.0 is supported by 2.0.19, but there are a number of issues, particularly with Android builds (see 232 203 207). Using the cordova-android-support-gradle-release plugin may help.

AndroidX Support

Currently if your project requires AndroidX support, you need to add the following two plugins to your project:

cordova-plugin-androidx and cordova-plugin-androidx-adapter

1$ cordova plugin add cordova-plugin-androidx

2$ cordova plugin add cordova-plugin-androidx-adapter

Just adding these plugins should be enough and no further changes are necessary.

fileOpener2.open(filePath, mimeType, options)

Opens a file

Supported Platforms

Android 4.4+
iOS 9+
Windows
Electron

Quick Examples

Open an APK install dialog:

1cordova.plugins.fileOpener2.open(
2    '/Downloads/gmail.apk',
3    'application/vnd.android.package-archive'
4);

Open a PDF document with the default PDF reader and optional callback object:

1cordova.plugins.fileOpener2.open(
2    '/Download/starwars.pdf', // You can also use a Cordova-style file uri: cdvfile://localhost/persistent/Downloads/starwars.pdf
3    'application/pdf',
4    {
5        error : function(e) {
6            console.log('Error status: ' + e.status + ' - Error message: ' + e.message);
7        },
8        success : function () {
9            console.log('file opened successfully');
10        }
11    }
12);

Note on Electron: Do not forget to enable Node.js in your app by adding "nodeIntegration": true to platforms/electron/platform_www/cdv-electron-settings.json file, See Cordova-Electron documentation.

Market place installation

Install From Market: to install an APK from a market place, such as Google Play or the App Store, you can use an <a> tag in combination with the market:// protocol:

1<a href="market://details?id=xxxx" target="_system">Install from Google Play</a>
2<a href="itms-apps://itunes.apple.com/app/my-app/idxxxxxxxx?mt=8" target="_system">Install from App Store</a>

or in code:

1window.open("[market:// or itms-apps:// link]","_system");

fileOpener2.showOpenWithDialog(filePath, mimeType, options)

Opens with system modal to open file with an already installed app.

Supported Platforms

Android 4.4+
iOS 9+

Quick Example

1cordova.plugins.fileOpener2.showOpenWithDialog(
2    '/Downloads/starwars.pdf', // You can also use a Cordova-style file uri: cdvfile://localhost/persistent/Downloads/starwars.pdf
3    'application/pdf',
4    {
5        error : function(e) {
6            console.log('Error status: ' + e.status + ' - Error message: ' + e.message);
7        },
8        success : function () {
9            console.log('file opened successfully');
10        },
11        position : [0, 0]
12    }
13);

position array of coordinates from top-left device screen, use for iOS dialog positioning.

fileOpener2.uninstall(packageId, callbackContext)

Uninstall a package with its ID.

Note: You need to add <uses-permission android:name="android.permission.REQUEST_DELETE_PACKAGES" /> to your AndroidManifest.xml

Supported Platforms

Android 4.4+

Quick Example

1cordova.plugins.fileOpener2.uninstall('com.zynga.FarmVille2CountryEscape', {
2    error : function(e) {
3        console.log('Error status: ' + e.status + ' - Error message: ' + e.message);
4    },
5    success : function() {
6        console.log('Uninstall intent activity started.');
7    }
8});

fileOpener2.appIsInstalled(packageId, callbackContext)

Check if an app is already installed.

Supported Platforms

Android 4.4+

Quick Example

1cordova.plugins.fileOpener2.appIsInstalled('com.adobe.reader', {
2    success : function(res) {
3        if (res.status === 0) {
4            console.log('Adobe Reader is not installed.');
5        } else {
6            console.log('Adobe Reader is installed.')
7        }
8    }
9});

Android APK installation limitation

The following limitations apply when opening an APK file for installation:

On Android 8+, your application must have the ACTION_INSTALL_PACKAGE permission. You can add it by adding this to your app's config.xml file:

1<platform name="android">
2    <config-file parent="/manifest" target="AndroidManifest.xml" xmlns:android="http://schemas.android.com/apk/res/android">
3        <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
4    </config-file>
5</platform>

Before Android 7, you can only install APKs from the "external" partition. For example, you can install from cordova.file.externalDataDirectory, but not from cordova.file.dataDirectory. Android 7+ does not have this limitation.

SD card limitation on Android

It is not always possible to open a file from the SD Card using this plugin on Android. This is because the underlying Android library used does not support serving files from secondary external storage devices. Whether or not your the SD card is treated as a secondary external device depends on your particular phone's set up.

Notes

For properly opening any file, you must already have a suitable reader for that particular file type installed on your device. Otherwise this will not work.
It is reported that in iOS, you might need to remove <preference name="iosPersistentFileLocation" value="Library" /> from your config.xml
If you are wondering what MIME-type should you pass as the second argument to open function, here is a list of all known MIME-types

No vulnerabilities found.

No security vulnerabilities found.