androidcordova混合开发以及cordova自定义插件

一、AndroidStudio中集成Cordova项目

这里就直接跳过Cordova和NodeJs的安装

1.创建Cordova项目

  • 命令:cordova create [项目名] [包名]
  • 例子:cordova create Test com.sie.test.android
  • 演示:

androidcordova混合开发以及cordova自定义插件

  • 创建成功目录结构:

androidcordova混合开发以及cordova自定义插件


2.项目中添加Android平台

  • 命令:cordova platform add [平台名]
  • 例子:cordova platform add android
  • 演示:

androidcordova混合开发以及cordova自定义插件

  • 创建成功目录结构(Test/platforms):

androidcordova混合开发以及cordova自定义插件

  • (Test/platforms/android)

androidcordova混合开发以及cordova自定义插件


3.AndroidStudio中导入Cordova项目

  • 打开AndroidStuido

androidcordova混合开发以及cordova自定义插件

  • 选择platforms/android文件夹

androidcordova混合开发以及cordova自定义插件

  • 打开完成的目录结构

androidcordova混合开发以及cordova自定义插件

  • 集成完成run一下,看看效果:

androidcordova混合开发以及cordova自定义插件

  • OK 在AS中完成Cordova项目的集成

二、自定义Cordova中的Android插件

1.安装plugman,Cordova需要用这个来创建插件

  • 命令: npm install -g plugman

2.plugman安装完之后就可以创建一个插件了cordova plugin

  • 命令:plugman create --name [插件名] --plugin_id [插件ID] --plugin_version [插件版本号]
  • 例子:plugman create --name toast-plugin --plugin_id toast-plugin --plugin_version 1.0.0
  • 演示:(随便找个目录)

androidcordova混合开发以及cordova自定义插件

  • 创建完成后目录下就看到这个文件夹:

androidcordova混合开发以及cordova自定义插件

  • 生成的插件的目录如下:

androidcordova混合开发以及cordova自定义插件

  • 一个规范的Android插件的话,一般src目录下新建android目录,然后在android目录下新建类
  • 目录如下:

androidcordova混合开发以及cordova自定义插件

3.创建完成后需要对plugin.xml进行配置

  • 打开后的文件如下
 <?xml version='1.0' encoding='utf-8'?>
<plugin id="toast-plugin" version="1.0.0" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
    <name>toast-plugin</name>
    <js-module name="toast-plugin" src="www/toast-plugin.js">
        <clobbers target="cordova.plugins.toast-plugin" />
    </js-module>
</plugin>

    • 添加Android平台配置后
    <?xml version='1.0' encoding='utf-8'?>
    <plugin id="toast-plugin" version="1.0.0" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
        <name>toast-plugin</name>
        <js-module name="MyToast" src="www/toast-plugin.js">
            <clobbers target="MyToast" />
        </js-module>
    
        <!--添加我们自己的平台  -->
        <platform name="android">  <!-- 平台类型 -->
            <config-file target="res/xml/config.xml" parent="/*">  
                <feature name="MyToast">  <!-- JS调用时的前缀名字 -->
                    <param name="android-package" value="org.apache.cordova.toast.MyToast"/> <!-- .java类名全路径 --> 
                </feature>  
            </config-file>  
            <source-file src="src/android/MyToast.java" target-dir="src/org/apache/cordova/toast" />  
            <!-- src:java源文件的路径, target-dir:插件安装好后,源文件的位置,要和上面的包名对应 -->
        </platform> 
    </plugin>
    

    4.编写Android原生功能类 MyToast.java文件

    • 因为原生类需要用到一些原生的Jar包和Cordova的一些类,所以我们可以现在AndroidStudio中先把这个 原生java文件写好在移动到插件目录下
    package org.apache.cordova.toast;
    
    import android.widget.Toast;
    
    import org.apache.cordova.CallbackContext;
    import org.apache.cordova.CordovaArgs;
    import org.apache.cordova.CordovaPlugin;
    import org.json.JSONArray;
    import org.json.JSONException;
    
    /**
     * 时 间: 2017/8/12
     * 作 者: 郑亮
     * Q  Q : 1023007219
     */
    
    public class MyToast extends CordovaPlugin {
    
        @Override
        public boolean execute(String action, String rawArgs, CallbackContext callbackContext) throws JSONException {
            return super.execute(action, rawArgs, callbackContext);
        }
    
        @Override
        public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
            return super.execute(action, args, callbackContext);
        }
    
        @Override
        public boolean execute(String action, CordovaArgs args, CallbackContext callbackContext) throws JSONException {
            //showToast 是你在JS中调用的方法名;
            if (action.equals("showToast")){
                //这里可以实现一些你的原生逻辑功能
                Toast.makeText(cordova.getActivity(), args.getString(0), Toast.LENGTH_SHORT).show();
                return true;
            }
            return false;
        }
    }
    
    • 创建的MyToast类,需要承继CordovaPlugin,然后重写里面的三个方法,上面代码中已经体现了,这三个方法,如果你看了CordovaPlugin源码的话,会发现,其实最后都调用了第二个方法,但是CordovaArgs只是对JSONArray的一个封装,方便操作json数据而已,所以要重写哪个,按个人喜好。
    • PS:将类移动到插件目录下时注意把包名改成 plugin.xml 配置的包名

    5.编写toast-plugin.js文件

    var exec = require('cordova/exec');
    /**
     * MyToast :是plugin.xml中配置的feature的nema
     * showToast: 是js中调用的方法名
     */
    exports.showToast = function(arg0) {
        exec(null, null, "MyToast", "showToast", [arg0]);
    };
    

    6.通过npm创建Mudule

    • 进入插件目录,在控制台输入:npm init
    • 然后会提示你一些信息,我就一不一一解释了, 后面也可以再配置的:

    androidcordova混合开发以及cordova自定义插件

    • 完成后会在插件目录生成一个package.json 文件

    androidcordova混合开发以及cordova自定义插件

    • 还需要对package.json 进行一些Cordova信息的补全
    • 每个属性是什么意思就自行查询了,我这里只是简单的配置
    {
      "name": "toast-plugin",
      "version": "1.0.0",
      "description": "这是一个Cordova的一个Andoird插件",
      "cordova": {
        "id": "toast-plugin",
        "platforms": [
          "android"
        ]
      },
      "main": "index.js",
      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
      },
      "author": "郑亮",
      "license": "ISC"
    }
    

    7.项目中添加自定义插件

    • 到这里插件基本就配置完成,现在可以直接在项目添加了
    • 进入Android平台的目录: Test\platforms\android
    • 命令:cordova plugin add F:\demo\Test\toast-plugin

    androidcordova混合开发以及cordova自定义插件

    • 添加成功后Android项目中会多出几个文件夹:

    androidcordova混合开发以及cordova自定义插件

    8.完结:自定义插件的使用

    • 在Js中调用 注意要在index.js文件中的:onDeviceReady: function () 中调用
    MyToast.showToast('你好!我是JS中调用的代码');
    • 1
    • 最后的效果:
      androidcordova混合开发以及cordova自定义插件

    请注明出处:http://blog.csdn.net/qq_23179075/article/details/77104276

    请注明出处:http://blog.csdn.net/qq_23179075/article/details/77104276