diff --git a/README.md b/README.md index aa73889..f708675 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,119 @@ -A File Opener Plugin for Cordova (The Original Version) -========================== -This plugin will open a file on your device file system with its default application. - -Requirements -------------- -- Android 4 or higher / iOS 6 or higher / WP8 -- Cordova 3.0 or higher - -Installation -------------- - cordova plugin add https://github.com/pwlin/cordova-plugin-file-opener2 - -PhoneGap Build ---------------- -This Plugin is also available in PhoneGap Build Repository. Go to [https://build.phonegap.com/](https://build.phonegap.com/) -And search for `io.github.pwlin.cordova.plugins.fileopener2` -(There are a couple of other forks out there which are mostly out of date. Make sure to download the one with the exact same id as mentioned above) - - -Usage ------- -Open an APK install dialog: - - cordova.plugins.fileOpener2.open( - '/sdcard/Download/gmail.apk', - 'application/vnd.android.package-archive' - ); - -Open a PDF document with the default PDF reader and optional callback object: - - cordova.plugins.fileOpener2.open( - '/sdcard/Download/starwars.pdf', // You can also use a Cordova-style file uri: cdvfile://localhost/persistent/Download/starwars.pdf - 'application/pdf', - { - error : function(e) { - console.log('Error status: ' + e.status + ' - Error message: ' + e.message); - }, - success : function () { - console.log('file opened successfully'); - } - } - ); - -Notes ------- - -- For properly opening a PDF file, you must already have a PDF reader (Acrobat Reader, Foxit Mobile PDF, etc. ) installed on your mobile device. Otherwise this will not work - - -- [It is reported](https://github.com/pwlin/cordova-plugin-file-opener2/issues/2#issuecomment-41295793) that in iOS, you might need to remove `` from your `config.xml` - - -Additional Android Functions ------------------------------ -####The following functions are available in Android platform - -###.uninstall(_packageId, callbackContext_) -Uninstall a package with its id. - - cordova.plugins.fileOpener2.uninstall('com.zynga.FarmVille2CountryEscape', { - error : function(e) { - console.log('Error status: ' + e.status + ' - Error message: ' + e.message); - }, - success : function() { - console.log('Uninstall intent activity started.'); - } - }); - -###.appIsInstalled(_packageId, callbackContext_) -Check if an app is already installed. - - cordova.plugins.fileOpener2.appIsInstalled('com.adobe.reader', { - success : function(res) { - if (res.status === 0) { - console.log('Adobe Reader is not installed.'); - } else { - console.log('Adobe Reader is installed.') - } - } - }); - -Contributors ------------- -[@Gillardo:](https://github.com/Gillardo/) Support for WP8 - -LICENSE --------- -The MIT License (MIT) - -Copyright (c) 2013 pwlin - pwlin05@gmail.com - -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of -the Software, and to permit persons to whom the Software is furnished to do so, -subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS -FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR -COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER -IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN -CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +Contributors +------------ +[@Gillardo](https://github.com/Gillardo/) + +[@TankOs](https://github.com/TankOs) + +[@Rovi23](https://github.com/Rovi23) + +[@josemanuelbd](https://github.com/josemanuelbd) + + +A File Opener Plugin for Cordova (The Original Version) +========================== +This plugin will open a file on your device file system with its default application. + +Requirements +------------- +- Android 4 or higher / iOS 6 or higher / WP8 +- Cordova 3.0 or higher + +Installation +------------- + cordova plugin add cordova-plugin-file-opener2 + +Usage +------ + cordova.plugins.fileOpener2.open( + filePath, + fileType, + { + error : function(){ }, + success : function(){ } + } + ); + +Examples +-------- +Open an APK install dialog: + + cordova.plugins.fileOpener2.open( + '/sdcard/Download/gmail.apk', + 'application/vnd.android.package-archive' + ); + +Open a PDF document with the default PDF reader and optional callback object: + + cordova.plugins.fileOpener2.open( + '/sdcard/Download/starwars.pdf', // You can also use a Cordova-style file uri: cdvfile://localhost/persistent/Download/starwars.pdf + 'application/pdf', + { + error : function(e) { + console.log('Error status: ' + e.status + ' - Error message: ' + e.message); + }, + success : function () { + console.log('file opened successfully'); + } + } + ); + +Notes +------ + +- For properly opening a any file, you must already have an suitable reader for that particular file type already installed on your device. Otherwise this will not work. + + +- [It is reported](https://github.com/pwlin/cordova-plugin-file-opener2/issues/2#issuecomment-41295793) that in iOS, you might need to remove `` from your `config.xml` + + +Additional Android Functions +----------------------------- +####The following functions are available in Android platform + +###.uninstall(_packageId, callbackContext_) +Uninstall a package with its id. + + cordova.plugins.fileOpener2.uninstall('com.zynga.FarmVille2CountryEscape', { + error : function(e) { + console.log('Error status: ' + e.status + ' - Error message: ' + e.message); + }, + success : function() { + console.log('Uninstall intent activity started.'); + } + }); + +###.appIsInstalled(_packageId, callbackContext_) +Check if an app is already installed. + + cordova.plugins.fileOpener2.appIsInstalled('com.adobe.reader', { + success : function(res) { + if (res.status === 0) { + console.log('Adobe Reader is not installed.'); + } else { + console.log('Adobe Reader is installed.') + } + } + }); + +LICENSE +-------- +The MIT License (MIT) + +Copyright (c) 2013 pwlin - pwlin05@gmail.com + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/package.json b/package.json new file mode 100644 index 0000000..e5b02ea --- /dev/null +++ b/package.json @@ -0,0 +1,39 @@ +{ + "name": "cordova-plugin-file-opener2", + "version": "2.0.0", + "description": "A File Opener Plugin for Cordova. (The Original Version)", + "cordova": { + "id": "cordova-plugin-file-opener2", + "platforms": [ + "android", + "ios", + "wp8", + "windows" + ] + }, + "repository": { + "type": "git", + "url": "https://github.com/pwlin/cordova-plugin-file-opener2.git" + }, + "keywords": [ + "ecosystem:cordova", + "cordova-android", + "cordova-ios", + "cordova-wp8", + "cordova-windows" + ], + "engines": [ + { + "name": "cordova", + "version": ">=3.0.0" + } + ], + "author": { + "name": "pwlin05@gmail.com" + }, + "license": "MIT", + "bugs": { + "url": "https://github.com/pwlin/cordova-plugin-file-opener2/issues" + }, + "homepage": "https://github.com/pwlin/cordova-plugin-file-opener2#readme" +} diff --git a/plugin.xml b/plugin.xml index d935f46..892247f 100644 --- a/plugin.xml +++ b/plugin.xml @@ -1,5 +1,5 @@ - + File Opener2 A File Opener Plugin for Cordova. (The Original Version)