Gathering detailed insights and metrics for cordova-plugin-file-safe-opener2
Installations
npm install cordova-plugin-file-safe-opener2Developer 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.5
Maintenance
100
Vulnerability
99.6
License
Releases
Unable to fetch releases
Contributors
1
Unable to fetch Contributors
Languages
3
JavaScript
Java
Objective-C
JavaScript (43.95%)
Java (30.45%)
Objective-C (25.6%)
Developer
sandyclock
Download Statistics
Total Downloads
665
Last Day
1
Last Week
2
Last Month
17
Last Year
110
GitHub Statistics
263 Commits
1 Branches
1 Contributors
Maintainers
1
Package Meta Information
Latest Version
3.0.8
Package Id
cordova-plugin-file-safe-opener2@3.0.8
Unpacked Size
44.48 kB
Size
12.67 kB
File Count
16
NPM Version
6.14.17
Node Version
14.20.0
Total Downloads
Cumulative downloads
Total Downloads
665
Last day
-75%
1
Compared to previous day
Last week
-77.8%
2
Compared to previous week
Last month
1,600%
17
Compared to previous month
Last year
-37.1%
110
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:
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:
- Before Android 7, you can only install APKs from the "external" partition. For example, you can install from
cordova.file.externalDataDirectory, but not fromcordova.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 yourconfig.xml -
If you are wondering what MIME-type should you pass as the second argument to
openfunction, here is a list of all known MIME-types
No vulnerabilities found.
No security vulnerabilities found.