自定义cordova插件-入门

环境准备

安装android studio请备份一下你的android sdk tools下的templates文件夹,因为安装android studio有可能会被删除.导致如下图打包异常



参考

  • 如果遇到android开发问题请积极百度,android开发已经很成熟了,一定能解决问题

项目准备

  • 准备一个cordova项目,用于安装插件.可以是任何cordova项目不一定是ionic项目
  • 为了方便调试和运行快速,建议创建一个新项目.可以参考这里创建一个ionic新项目
  • 保证此项目可以正常打包,用于说明开发环境没有问题

为了演示我刚刚新建了一个ionic项目ionic start ionic_test tabs --cordova

全局安装plugman

  • plugman用于创建插件,安装过程如下图
cnpm i -g plugman
  • 可以通过plugman -h查看plugman提供的命令及参数.

创建插件

  • 如下图我在D盘根目录创建了一个插件并添加了android平台,也生成了package.json文件. 插件名:nativeLocation,插件id:com.kit.cordova.nativeLocation,版本:0.0.1

package.json是插件描述文件,如果插件只是自己用可以不用生成

plugman create --name nativeLocation --plugin_id com.kit.cordova.nativeLocation --plugin_version 0.0.1
cd nativeLocation\
plugman createpackagejson ./
plugman platform add --platform_name android
plugman platform add --platform_name ios 

安装插件

  • 安装插件到准备好的cordova项目中
cordova plugin add D:\nativeLocation
  • 插件结构如下图


调用插件

  • 查看nativeLocation.js可以看到这个js文件exports了一个coolMethod函数,这个函数有3个参数.第一个参数类型不限作为数组的第一项传入到插件中,第二个和第三个分别是成功和失败回调函数

  • 查看plugin.xml可以看到这个nativeLocation.js对应的cordova调用方法是放到cordova.plugins.nativeLocation命名空间下

  • 调用代码如下,注意coolMethod()是三个参数

declare var cordova;
 click(){
    cordova.plugins.nativeLocation.coolMethod(777, res => {
      // 你也可以把res输出在页面上  this.data = res;    {{data|json}}
      console.log(res);
    }, err => {
      console.log(err);
    })
  }
 cordova platform rm android
 cordova platform add android
 cordova run android

ionic项目修改了src目录下的代码需要先ionic serve或者ionic build或者使用ionic cordova run android运行项目.为了使修改后代码放到www目录下

  • 如下图点击按钮,插件成功输出我们的传入的参数.说明插件已经成功安装


  • 以上就是创建并安装一个最简单的cordova插件的过程

使用Android Studio打开项目

  • 如下图用Android Studio选择你的app项目>platforms>android目录

  • 如果你是第一次用Android Studio打开项目,可能会像下图1界面卡很长时间(超过一分钟),它正在下载gradle,gradle比较大(67M)下载比较慢

  • 你可以在进程杀掉Android Studio,然后手动去这里下载,下载哪个版本?看图2.打开你的dists目录,一一点击每个gradle-*目录,看哪个目录gradle*.jar为空(图3)就下载哪个版本,并把下载的jar放进去(图4)

  • 然后在用Android Studio打开项目.注意项目是你的app项目>platforms>android目录

图1
图2
图3
图4
  • Android Studio打开界面.有时候需要刷新一下如下图


  • 用usb连接手机和电脑.点击调试按钮选择连接的手机,在真机上运行

  • 运行到真机上后,点击app页面上的按钮可以在Studio控制台上看到日志信息.这里的控制台就是输出android app运行的日志.app插件bug,闪退等常见问题均可以在这里看到错误日志


插件优化

  • 找到插件文件.发现包名太长,Java类名以小写开头.我们先直接在Studio上修改.(以后的plugman可能会对创建的插件有优化 )

  • 修改后类名大写,删除一层包名.


  • 如下图点击gradle clear


  • 选择android,继续点击调试按钮在真机上运行确保修改没问题


修改插件

  • 回到webstorm,如下图删除插件目录中的nativeLocation.java文件.把Studio上的NativeLocation.java复制进来

  • 修改plugin.xml.如下图1和图2分别为修改前后.修改内容看图2标注

    图1

    图2

  • ionic新建的项目id默认是io.ionic.starter.如下图修改成自己的id保证唯一,我这里修改为com.kit.ionicTest

  • 修改完成在真机运行调试.用cordova命令打包运行,不是用Studio运行

 cordova platform rm android
 cordova platform add android
 cordova run android
  • 注意执行cordova platform rm android会删除你的app项目>platforms>android目录.所以最好备份一下.如下图

本次简单修改可以不备份.以后在Studio上开发了许多代码就需要备份

总结

  • 插件开发步骤

1用plugman创建插件原型并把插件安装到cordova项目中
2.用cordova生成android项目.cordova platform add android
3用Android Studio编辑android项目.(可以实现任何功能,需要懂Java开发语言 )
4把在Android Studio上开发的功能的代码等资源文件拷贝到插件中
5在插件的plugin.xml文件中"描述“android”资源文件放在android项目中的什么位置

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,753评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,668评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,090评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,010评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,054评论 6 395
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,806评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,484评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,380评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,873评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,021评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,158评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,838评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,499评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,044评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,159评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,449评论 3 374
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,136评论 2 356

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,199评论 25 707
  • 一、Cordova的基础点 在混合式应用中,我们通过现有的Cordova插件,可以轻松的在 H5 上调用手机nat...
    IT晴天阅读 6,623评论 3 11
  • 最近我迷上了一个电视节目,名字叫《魅力中国城》,在中央二套播出,每周一期,每一期由两个城市参加。 现在进行的还是初...
    夏日夜阅读 250评论 0 0
  • 文/霖山 财务部新来的马经理,是一位个子不高,圆脸,皮肤白,身材丰满的中年妇女。精干的短发别在耳后,显得脸更大,两...
    霖山阅读 2,406评论 109 108
  • 今天是情人节,我爸妈却打了一架,你没看错,是的,打架! 我爸左脸颊有两道指痕,我妈人中有一道斜血痕。今...
    hucarol阅读 336评论 6 5