Ionic 跨平台开发之Cordova插件清单及使用说明

一，插件相关常用命令

1，查看所有已经安装的插件

     cordova plugin ls

2，安装插件（以camera插件为例）

     cordova plugin add cordova-plugin-camera

3，删除插件（以camera插件为例）

    cordova plugin rm cordova-plugin-camera 

4，更新插件

    cordova plugin update 

二，常用的Cordova插件

与真机设备相关

1 ，Device（设备）-检查当前操作系统和设备情况

    地址 ：https://github.com/apache/cordova-plugin-device    

    cordova plugin add cordova-plugin-device

  2 ，Connection（网络连接）-用来判断网络连接类型 

（2G、3G、4G、Wifi、无连接等）

    cordova plugin addcordova-plugin-network-information

  3 ，Camera(相机)-用相机获取图像 

    cordova plugin add cordova-plugin-camera

4 ，Media Capture （媒体捕获）-获取图像、录视频或者录音 

与Camera API相比，不仅能获取图像，还可以录视频或者录音

    cordova plugin add cordova-plugin-camera

  5 ，barcodeScanner（条形码/二维码扫描）-通过摄像头识别二维码/条形码 

不仅可以通过摄像头识别二维码/条形码，还能生成二维码

    cordova plugin add cordova-plugin-barcodescanner

6 ，Hardware Nofifications（硬件消息提醒）-让设备蜂鸣或振动

    cordova plugin add cordova-plugin-vibration

7 ，Battery（电池）-可以获取电池状态信息

    cordova plugin add cordova-plugin-battery-status

8 ，Compass(指南针)-可以让开发者读取移动设备的朝向

     cordova plugin addcordova-plugin-device-orientation

9 ，Geolocation(地理定位)-让应用判断设备的物理位置

    cordova plugin add cordova-plugin-geolocation

10 ，Accelerometer(加速计)-让应用在三维空间中决定设备方向

(使用笛卡尔三维坐标系统)

    cordova plugin add cordova-plugin-device-motion

  11 ，Contacts（联系人）-读取联系人列表 

读取联系人列表并在应用中使用联系人数据,或使用应用数据向联系人列表中写新的联系人

    cordova plugin add cordova-plugin-contacts

  12 ，Media（播放/记录媒体文件）-让应用能记录或播放媒体文件 

用它可以在手机后台播放音频文件或玩桌面视频游戏。

    cordova plugin add cordova-plugin-media

13 ，photoViewer -图片预览

    cordova plugin add com-sarriaroman-photoviewer

14 ，cordova-plugin-datepicker -日期选择

    cordova plugin add cordova-plugin-datepicker

15 ，crosswalk-webview -第三方webview

    cordova plugin addcordova-plugin-crosswalk-webview

16 ，fastrde-downloader -多文件下载器,可以解压zip

    cordova plugin add  https://github.com/fastrde/phonegap-downloader.git

17 ，cordova-sqlite-storage–数据库

    cordova plugin add cordova-sqlite-storage

打开数据库:

var db =window.sqlitePlugin.openDatabase({name: 'my.db', location: 'default'},successcb, errorcb);

18 ，cordova-plugin-nativestorage-本地存储

    cordova plugin add cordova-plugin-nativestorage

使用:

NativeStorage.setItem("reference_to_value",<value>,<success-callback>,<error-callback>);

NativeStorage.getItem("reference_to_value",<success-callback>,<error-callback>);

19 ，VoiceManager -音频控制插件

通过参数调节手机播放音频

https://github.com/youmu178/VoiceManager

下载后进行本地安装

用法：

VoiceManage mVoiceManage = new VoiceManage(mActivity, path);//初始化 

mVoiceManage.sessionRecord(true);// 开始录音  

mVoiceManage.sessionPlay(true, mFilePath);// 播放录音   

20 ，background-mode –app后台运行插件

防止app在后台进入睡眠状态

地址：https://github.com/katzer/cordova-plugin-background-mode

From master:

# ~~ from master branch ~~

cordova plugin addhttps://github.com/katzer/cordova-plugin-background-mode.git

from a local folder:

# ~~ local folder ~~

cordova plugin addde.appplant.cordova.plugin.background-mode --searchpath path

or to use the last stable version:

# ~~ stable version ~~

cordova plugin [email protected]

To remove the plug-in, run the followingcommand:

cordova plugin rmde.appplant.cordova.plugin.background-mode

  21 ，cordova-plugin-cache -清除app缓存 

https://github.com/moderna/cordova-plugin-cache

You may use phonegap CLI as follows:

➜ phonegap local plugin addhttps://github.com/moderna/cordova-plugin-cache.git

[phonegap] adding the plugin:https://github.com/moderna/cordova-plugin-cache.git

[phonegap] successfully added the plugin

其它第三方插件：

1，Visual Notification （可视化消息提醒）- alert()、confirm()和prompt()

不同于js的alert()、confirm()和prompt()方法是同步的。Cordova的alert()、confirm()和prompt()方法是异步的，并且对显示内容有更大的控制权限。

    cordova plugin add cordova-plugin-dialog

  2，AppVersion （版本更新插件）-版本更新 

主要是指Android的，IOS可使用AppStore的

    cordova plugin add  https://github.com/whiteoctober/cordova-plugin-app-version.git

  3，exitApp （退出应用）-关闭退出APP 

让 Android 或者 Windows Phone 8 上的APP关闭退出（iOS系统不支持）。

    cordova plugin add cordova-plugin-exitapp

  4，InAppBrowser （内置浏览器）-允许在在单独的窗口中加载网页。 

例如要向应用用户展示其他网页。当然可以很容易地在应用中加载网页内容并管理，但有时候需要不同的用户体验，InAppBrowser加载网页内容，应用用户可以更方便的直接返回到主应用。

    cordova plugin add cordova-plugin-inappbrowser

  5，Splashscreen （闪屏）-用来在Cordova应用启动时显示过渡页面 

    cordova plugin add cordova-plugin-splashscreen

6，file （文件访问操作类）-提供对设备上的文件进行读取和写入的功能支持

    cordova plugin add cordova-plugin-file

7，fileTransfer （文件传输）-实现文件上传、下载及共享等功能

    cordova plugin add cordova-plugin-file-transfer

8，geolocation - 获取经纬度

    cordova plugin add cordova-plugin-geolocation

9，JPush PhoneGap Plugin - 极光推送 

（前置条件-首先安装 cordova device 插件 cordova plugin add cordova-plugin-device）

方法一：在线安装

通过 Cordova plugins 安装，要求 PhoneGap/Cordova CLI 5.0+：

cordova plugin add jpush-phonegap-plugin--variable API_KEY=your_jpush_appkey

直接通过 url 安装：

cordova plugin add https://github.com/jpush/jpush-phonegap-plugin.git--variable API_KEY=your_jpush_appkey  

方法二：下载到本地再安装

使用 git 命令将 JPush PhoneGap 插件下载的本地，目录标记为 $JPUSH_PLUGIN_DIR：

git clonehttps://github.com/jpush/jpush-phonegap-plugin.git

cordova plugin add $JPUSH_PLUGIN_DIR  --variable API_KEY=your_jpush_appkey

  10，本地等待和进度 - 基于Spinner提供的本地等待和进度对话框 

地址: https://github.com/Paldom/SpinnerDialog

Latest stable release: 

phonegap local plugin addcordova-plugin-spinner-dialog or 

cordova plugin addcordova-plugin-spinner-dialog

Current state from git:

phonegap local plugin add  https://github.com/Paldom/SpinnerDialog.git  or 

cordova plugin addhttps://github.com/Paldom/SpinnerDialog.git

方法：

window.plugins.spinnerDialog.show([title],[message], [cancelCallback])；

window.plugins.spinnerDialog.hide()；

  11，cordova-plugin-dialogs - 本地对话框 

地址： https://github.com/apache/cordova-plugin-dialogs

cordova plugin add cordova-plugin-dialogs

Methods

navigator.notification.alert

navigator.notification.confirm

navigator.notification.prompt

navigator.notification.beep

eg:

navigator.notification.alert(message,alertCallback, [title], [buttonName])

message: Dialog message. (String)

alertCallback: Callback to invokewhen alert dialog is dismissed. (Function)

title: Dialog title. (String)(Optional, defaults to Alert)

buttonName: Button name. (String)(Optional, defaults to OK)

  12，cordova-plugin-actionsheet - 本地选项卡 

地址： https://github.com/EddyVerbruggen/cordova-plugin-actionsheet

$ cordova plugin addcordova-plugin-actionsheet

$ cordova prepare

  13，Toast-PhoneGap-Plugin - 本地浮动框提示 

地址：https://github.com/EddyVerbruggen/Toast-PhoneGap-Plugin

Using the Cordova CLI and the  Cordova Plugin Registry

$ cordova plugin add cordova-plugin-x-toast

$ cordova prepare

Or using the phonegap CLI

$ phonegap local plugin addcordova-plugin-x-toast

14， Calendar-PhoneGap-Plugin- 本地日历插件  

地址：https://github.com/EddyVerbruggen/Calendar-PhoneGap-Plugin

Latest release on npm:

$ cordova plugin addcordova-plugin-calendar

Bleeding edge, from github:

$ cordova plugin addhttps://github.com/EddyVerbruggen/Calendar-PhoneGap-Plugin.git

 

  支付和分享相关：

  1,  支付宝支付-阿里支付本地扩展插件 

地址：https://github.com/charleyw/cordova-plugin-alipay

$ cordova plugins add cordova-plugin-alipay-pay 

js调用

window.plugins.Alipay.pay(out_trade_no,subject,body,total_fee,successCallback,errorCallback,callbackUrl);

参数说明:

      out_trade_no:订单号(不能重复)

      subject:商品名称

      body:描述

      total_fee:价格

      successCallback:成功回调

      errorCallback:失败回调

      callbackUrl:回调地址/支付宝调用

当调用方法后如果安装了支付宝会调用支付宝进行支付，

  2,  银联支付-  微信v3本地扩展插件，包括微信支付和微信分享件 

地址：https://github.com/TongChia/cordova-plugin-pingpp

包含支付宝和微信支付的插件

$ cordova plugin addhttps://github.com/TongChia/cordova-plugin-pingpp.git

 包含百度钱包/银联支付/ApplePay

$ cordova plugin addhttps://github.com/TongChia/cordova-plugin-pingpp.git#all

  3,  微信支付、微信分享-微信v3本地扩展插件，包括微信支付和微信分享 

地址：https://github.com/xu-li/cordova-plugin-wechat

$ cordova plugin add cordova-plugin-wechat --variablewechatappid=YOUR_WECHAT_APPID

  4,  微博插件-集成了weibo.SDK，提供微博授权登录与微博分享的能力 

地址：https://github.com/BelinChung/cordova-plugin-weibo

$ cordova plugins add cordova-plugin-weibo

  5,  社交分享 -分享插件,可分享文本图片等,并关联打开本地注册过的可分享类型 

地址：https://github.com/EddyVerbruggen/SocialSharing-PhoneGap-Plugin

$ cordova plugin addcordova-plugin-x-socialsharing

$ cordova prepare

  6, QQ 插件 - 集成了QQSDK，提供了授权登录，分享功能 

地址：https://github.com/baomingba/cordova-plugin-qq

添加插件cordova plugin addhttps://github.com/baomingba/cordova-plugin-qq

移除插件

cordova plugin removecom.qiudao.cordova.qq

  三，参考链接：
http://www.hangge.com/blog/cache/detail_1158.html / 
http://docs.wex5.com/cordova-plugins/  

https://github.com/apache/(pluginName)/